2.0 KiB
2.0 KiB
Corteza codegen tools and definitions
History
See old codegen.
Plans
Right now, Corteza is migrating its old YAML definitions to CUE. We are also simplifying all templates by moving as much data manipulation to Cue as possible.
Todo
- options documentation (see assets/templates/docs/options.gen.adoc.tpl)
Intro
Codegen tools are based on cuelang and golang templates.
What you can find here:
- codegen definitions in
codegen/ - templates in
codegen/asset/templates - schemas in
codegen/schema - template exec tool in
codegen/tool
Platform, component and resource definitions (.cue files) can be found in:
appautomationsystemcomposefederation
Running code generator
When a definitions or templates are changed all outputs need to be regenerated
This can be done with the following command (the root of the project)
make codegen
Inside /codegen you can run codegen with different options
# generate all
make
# generate only server files (golang code, .env.example, ...)
make server
# generate only docs (asciidoc files)
make docs
# generate for only one specific codegen definition
make server.options.cue
make docs.options.cue
# or more of them at once
make server.options.cue docs.options.cue
How does it work?
High-level overview
- evaluate codegen instructions (see platform.cue)
- output instructions as JSON
- pipe JSON into template exec tool
- process instructions, load and execute templates and write to output files.
Definition structure
Codegen instructions
Collection of #codegen structs with template + payload + output instructions. Template exec tool iterates over collection and creates output from each one.
endpoints (unrelated to specific component)
Troubleshooting
- Make sure you have the latest version of cue (0.4.2 or newer)