sen::gen¶

This library bundles the code generators used to translate Sen type sets (.stl files, each parsed into a sen::lang::TypeSet) into source artifacts in various target languages and documentation formats.

The library is CLI-free: its public headers depend only on Sen types and the standard library, which lets it be linked from any Sen binary that needs to render schemas or sources at runtime (for example, the JSON-RPC wire ships JSON-Schema descriptions alongside custom type metadata).

The sen generate command-line tool is the canonical front-end; it is a thin shell around the generators in this library.

Check out the API Reference for the complete list of generators and their options.

What it contains¶

Each generator is exposed as a small PImpl class. Most own an inja template environment; the HTML one builds its output directly, because it emits an application and a data file rather than rendered text. Instances are reusable across calls; prefer constructing one per process and feeding it successive type sets.

How to use it¶

Parse the input STL files into a sen::lang::TypeSetContext (see sen::core), which holds one TypeSet per file. Construct the relevant generator and call its generate* method. Most take the whole context, while the C++ and Python generators take a single TypeSet. Most return the rendered file contents as a std::string. The C++, TypeScript and HTML generators return FileContents, a std::map<std::filesystem::path, std::string>, since each renders more than one file. C++ gives the header and source pair plus any transitively-rendered imports; TypeScript gives one module per type set plus the index.ts barrel; HTML gives the page and the assets beside it.

For a fully worked example, see the apps/cli_gen sources: each per-topic subcommand under apps/cli_gen/src/*_cli.cpp instantiates one generator and writes its output to disk.