kiln-generator 0.9.0

CLI for autogenerating files from templates

kiln

Pre-alpha — kiln is under active development. APIs may change between releases. Feedback and contributions are welcome.

CLI for autogenerating files from templates.

---

Install

pip install kiln-generator  # or: uv add kiln-generator

Optional extras:

pip install 'kiln-generator[files]'  # adds boto3 for S3 uploads

Targets

kiln-generator ships four targets, all driven by the generic foundry CLI:

• be — FastAPI/SQLAlchemy backend codegen.
• be_root — one-shot bootstrap for a be-driven project.
• fe — React/TypeScript frontend codegen (TS types + React Query hooks from an OpenAPI spec).
• fe_root — one-shot bootstrap for a fe-driven project.

Quick start

foundry --help
foundry generate --target be --config config/project.jsonnet

Documentation

Full documentation is available at roddarjohn.github.io/kiln.

• Usage
• API reference
• Development guide

Development

Prerequisites: uv, just, and jsonnetfmt — brew install go-jsonnet on macOS, sudo apt install jsonnet on Debian/Ubuntu.

# Clone and install
git clone https://github.com/<username>/kiln.git
cd kiln
uv sync --all-groups

# Install pre-commit hooks (ruff + jsonnetfmt run on every commit)
just setup

# Run checks
just lint          # ruff check + format
just type-check    # zuban check src/
just dev-test      # pytest (fast, local dev)
just test          # tox (full isolation)
just docs          # build Sphinx HTML docs

License

See LICENSE for details.

Future

• Authentication extensions

  • e.g. different permissions
  • e.g. permission actions
  • e.g. filter list endpoints
  • should be rego I'd think

• emails / texts / pdfs / spreadsheets?

  • is FE

• websockets?

• multi-tenant?