gencpp/scripts/Readme.md

# Scripts

Generation, testing, and cleanup scripts for the test directory are found here along with `natvis` and `natstepfilter` files for debugging.

## Refactoring

`refactor.ps1` Provides a way to run the [refactor](github.com/Ed94/refactor) program. It uses the `gencpp.refactor` script to complete a mass refactor of all content within the files of the specified within the script.

Currently `refactor` only supports naive sort of *find and replace* feature set and will not be able to rename identifiers excluisvely to a specific context (such as only renaming member names of a specific struct, etc).

**Note: The following macros are used with specifiers and token parsing within the library:**

* global
* internal
* local_persist
* forceinline
* neverinline

IF they are changed the following files would need adjustment:

* `./project/enums/ESpecifier.csv`
* `./project/enums/ETokType.csv`
* `./project/helpers/helper.hpp`

## Build & Run Scripts

**`clean.ps1`**  
Remove any generated content from the repository.

**`build.ps1`**  
Build bootstrap, singleheader, or tests. Supports MSVC or clang, release or debug.

```
args:
    bootstrap
    singleheader
    test
    clang
    msvc
    release
```

**`test.gen.build.ps1`**  
Build the metaprogram for generating the test code.

**`test.gen.ps1`**  
Build (if not already) the metaprogram for generating test code, then run it to generate code.

**`test.build.ps1`**  
Build and run metaprogram, build test program.

**`test.run.ps1`**  
Build and run metaprogram, build and run test program.


*Note: My env is Windows 11 with MSVC 2022 and clang 16.0.6*