codepotg

codepotg is the stable Python and Jinja generation runtime in the Codepot ecosystem.

It consumes OpenAPI 3.0 or 3.1 JSON/YAML, builds an indexed source cache, normalizes schemas and application metadata, plans files through a template pack, renders Jinja templates, and applies guarded project writes.

Package status

• PyPI package: codepotg
• current package version: 1.0.0
• Python: 3.11 or newer
• binary: codepotg
• template engine: Jinja 3
• input: OpenAPI 3.0 or 3.1 JSON/YAML
• bundled targets: TypeScript, Next.js, Dart, and debug packs

CodepotG is active and supported. It remains the mature generator while equivalent behavior is stabilized in codepotx.

What CodepotG owns

• JSON streaming and indexed JSONL caches;
• cached YAML-to-canonical-JSON compatibility conversion;
• normalized contract and dependency inference;
• legacy and graph-based paths.yaml planning;
• Jinja templates, partials, filters, and raw files;
• language adapters and target helpers;
• managed and immutable lifecycle policies;
• dry runs, guarded cleanup, before/after commands, and diagnostics;
• atomic writes and generation reports;
• optional memory tracing.

Learning path

1. Install and run a first task
2. Understand the generation pipeline
3. Configure Codepotg.yaml
4. Use tasks and CLI commands
5. Build a template pack
6. Write paths.yaml
7. Write Jinja templates
8. Understand the template context
9. Browse variable reference groups
10. Understand OpenAPI preservation
11. Configure lifecycle safety
12. Tune performance and memory
13. Apply best practices

Basic workflow

Continue with Getting started.