Tutorials

These tutorials build from the exact public Cortado API. Their code-generation examples are compiled as the rpnx_cortado_tutorial_codegen executable, so the syntax shown here is kept in step with the library.

1. Generate your first class — create a class, field, constructor, and method, then validate and serialize the result.
2. Symbolic control flow and exception regions — use owned labels, loops, branches, switches, automatic widening, and exception handlers.
3. Verification, stack maps, and debug metadata — understand dataflow analysis, max_stack, max_locals, StackMapTable, hierarchy resolution, and debug metadata.
4. Exact instructions and the constant pool — combine symbolic conveniences with exact instruction encodings and deterministic constant-pool interning.
5. Transform classes and package a JAR — extend a parsed class and package generated classes and resources into a JAR.

Start with the first tutorial when generating a class from scratch. Compiler backend authors will usually also want the control-flow and verifier tutorials before using the exact instruction model.

The shorter getting-started page remains a compact API orientation, while the architecture guide explains the owning data model and strict/tooling boundary.