YIDL

YIDL helps you write Python code generators. You describe the information a generator needs, reusable pieces of Python code, and rules for choosing and combining those pieces. Your Python program supplies the particular inputs and runs generation to obtain classes or functions, which applications then use as ordinary Python.

For example, field-name inputs x and y can produce a plain slotted Point class whose constructor stores its arguments directly. Those generation inputs are separate from the instance values supplied later by Point(3, 4).

New to YIDL? Follow this sequence before studying the complete example:

1. How YIDL works: what you author, the generator library versus generated application code, and YIDL's relationship to Astichi.
2. Generation stages: preparation, generation and application execution.
3. Installation, then generate a two-field slotted class.

Already familiar with Python generation? Use the direct run route after installation.

Alpha release; CPython 3.12+. The recorded example environment is qualified separately from that minimum. Astichi 1.1.3 is declared as a runtime dependency and is installed automatically. The existing yidl-compile command targets the legacy transducer frontend; use the Python concept API taught here for current braced .yidl files. Packaging and publication readiness remain separate gates.

• Matching/property/parameter flow
• Language reference
• Versions and limitations
• Run and inspect examples
• Build the navigable HTML documentation

The canonical developer contracts are dev-docs/YidlDesignSummary.md and dev-docs/YidlCodingRules.md. Older lifecycle design and internal validation material are preserved and excluded from public site output.