kiln

Warning

kiln is in pre-alpha. APIs may change between releases.

kiln is a CLI for generating FastAPI routes and Pydantic schemas from a declarative config file. It ships an extensible architecture – foundry is the generic code-generation engine, kiln is the FastAPI generator built on top of it.

Getting started

• Getting started
  • What foundry generates – and doesn’t
  • Prerequisites
  • Install
  • Project layout
  • Step 1 – Define your SQLAlchemy models
  • Step 2 – Write a config
  • Step 3 – Generate
  • Step 4 – Mount the router
  • Step 5 – Environment and database
  • Step 6 – Run the server
  • Adding authentication
  • Multi-app projects
  • Where to next
• Playground
  • Structure
  • Quick start
  • Justfile recipes
  • Project config
  • Apps
  • EventLog and PGCraftAppendOnly
• Usage
  • Install
  • The CLI
  • Config format
  • Operations
  • Built-in operations
  • Multi-app projects
  • Jsonnet stdlib
  • Testing the generated code
  • API versioning
  • Extending kiln

Guides

• Architecture
  • The build pipeline
  • Scopes
  • Operations
  • Typed output objects
  • Renderers
  • Assembler
  • Discovery via entry points
  • Source layout
• Extending kiln
  • Adding an operation
  • Cross-cutting operations with when()
  • Augmenting vs producing
  • Mutating output objects
  • Swapping a renderer
  • Adding a new output type
  • Shipping a new target
  • Operation validation
  • Testing your extension

Reference

• Reference
  • Config schema
  • Built-in operations
  • Generated file layout
  • foundry API
  • Stdlib reference
• API reference
  • foundry CLI
  • kiln target
  • foundry.config
  • foundry.jsonnet
  • foundry.pipeline
  • foundry.assembler
  • foundry.render
  • kiln.operations

Contributing

• Development
• Changelog