Skip to main content

kiln

PyPI Documentation

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.

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?

Metadata

Release files for kiln-generator 0.9.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for kiln-generator 0.9.0
File Size Uploaded
kiln_generator-0.9.0.tar.gz 113.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for kiln-generator 0.9.0
File Interpreter ABI Platform
kiln_generator-0.9.0-py3-none-any.whl Python 3 none any Details

Total release size: 278.0 kB

Release files / kiln_generator-0.9.0.tar.gz

Download URL kiln_generator-0.9.0.tar.gz
Size 113.8 kB
Tags Source
SHA-256 checksum
How to use checksums
7e1fa8800adda80c98e351eff593960262d9c28377c8c3871cf3174ed2dc8583
BLAKE2b-256 checksum
How to use checksums
724e4df9bb26ad10737376dbc230a78bd4977a5f69625ba14757ae83c216f752
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Apr 28, 2026.

Transparency log

Release files / kiln_generator-0.9.0-py3-none-any.whl

Download URL kiln_generator-0.9.0-py3-none-any.whl
Size 164.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
362dfae9299c9ef9fcd51aa9c873ff17632c016d3702a79af5d04b8c5eba903d
BLAKE2b-256 checksum
How to use checksums
29a94512f7538c2a42e3171ba7fbdbfbcea703a009c6ac25d3bcf13017033183
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Apr 28, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.9.0 This release

2 release files

0.8.4

2 release files

0.8.3

2 release files

0.8.2

2 release files

0.8.1

2 release files

0.8.0

2 release files

0.7.4

2 release files

0.7.3

2 release files

0.7.2

2 release files

0.7.1

2 release files

0.7.0

2 release files

0.6.1

2 release files

0.6.0

2 release files

0.5.1

2 release files

0.5.0

2 release files

0.4.0

2 release files

0.3.0

2 release files

0.2.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page