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 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