# Jinja2 Processor
## Purpose
Renders Jinja2 template files into output files using the Python Jinja2 template library.
## How It Works
Files matching configured extensions in `templates.jinja2/` are rendered via `python3` using
the `jinja2` Python library. Output is written with the extension stripped and the
`templates.jinja2/` prefix removed:
```
templates.jinja2/app.config.j2 → app.config
templates.jinja2/sub/readme.txt.j2 → sub/readme.txt
```
Templates use the [Jinja2](https://jinja.palletsprojects.com/) templating engine. A
`FileSystemLoader` is configured with the project root as the search directory, so
templates can include or extend other templates using relative paths. Environment
variables are passed to the template context.
## Source Files
- Input: `templates.jinja2/**/*{extensions}`
- Output: project root, mirroring the template path (minus `templates.jinja2/` prefix) with the extension removed
## Configuration
```toml
[processor.jinja2]
extensions = [".j2"] # File extensions to process (default: [".j2"])
extra_inputs = ["config/settings.py"] # Additional files that trigger rebuilds when changed
```
| `extensions` | string[] | `[".j2"]` | File extensions to discover |
| `extra_inputs` | string[] | `[]` | Extra files whose changes trigger rebuilds |
## Batch support
Each input file is processed individually, producing its own output file.