kiln-generator 0.8.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

Quick start

kiln registers itself as a target for the generic foundry CLI (shipped in this same package):

foundry --help
foundry generate --config app.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?