hedron-jinja
Explicit standards-first .hdj templates over Jinja, HTML, and HTMX for Hedron.
HDJ lets advanced applications write ordinary HTML, CSS, JavaScript, Web
Components, Jinja, and HTMX directly while preserving Hedron components and
render metadata. Install as hedron-jinja or via the flagship extra hedron[jinja].
Package maturity: Beta · Package line: 1.0.x · pin >=1.0.0,<2.0
Install
pip install "hedron-jinja>=1.0.0,<2.0"
# or
uv add "hedron-jinja>=1.0.0,<2.0"
# via flagship:
pip install "hedron[jinja]>=1.0.0,<1.1"
Requires Python 3.10–3.14, hedron-core, and Jinja2.
Quick start
from jinja2 import Environment, FileSystemLoader
from hedron_jinja import HedronJinja, TemplateSpec
templates = HedronJinja(Environment(loader=FileSystemLoader("templates")))
result = templates.render(
TemplateSpec("dashboard.hdj"),
{"heading": "Operations"},
)
print(result.html)
For registered interaction handles and registry facts, use a frozen app binding:
from hedron_jinja import HedronJinja, JinjaBinding
binding = JinjaBinding.from_registry(
app_id=app.hedron_app_id,
handles={orders.logical_id: orders},
asset_hrefs={"application:css": "/static/application.css"},
)
templates = HedronJinja(environment, binding=binding)
This adds app-scoped h_view, h_command_form, catalog, TypeSchema, feature-bundle, provider,
theme, application-style, and portable HTMX request facts without exposing registry source paths or
raw framework requests.
Example templates/dashboard.hdj:
---hdj
version = 1
kind = "fragment"
profile = "standard"
regions = ["main"]
---
<main id="main" hx-history-elt>{{ view.heading }}</main>
Trust model
Templates are trusted application code, not a sandbox for hostile authors.
Strict mode checks a finite dynamic sink matrix with purpose-specific URL
filters. Deployment capability declarations and application policy remain
separate and authoritative. Format v1 accepts static .hdj dependencies only;
every source must render through HedronJinja.
Links
- Package docs
- HDJ authoring guide
- Jinja / HDJ API
- Changelog
- Source
- Issues
- HDJ progressive examples
hedron-core·hedron
License
MIT. See the repository license.
1 maintainer
Release files for hedron-jinja 1.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| hedron_jinja-1.0.1.tar.gz | 49.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| hedron_jinja-1.0.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 101.7 kB
Release files / hedron_jinja-1.0.1.tar.gz
| Download URL | hedron_jinja-1.0.1.tar.gz |
|---|---|
| Size | 49.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3eb61120911a13cc3af8937c0cabd69d0fcef56a873577810c20a9157658d85f
|
|
BLAKE2b-256 checksum How to use checksums |
49ca96959171f846a2e61e188e78964e7cb73ad286045bc2b3fe0e692026cd91
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / hedron_jinja-1.0.1-py3-none-any.whl
| Download URL | hedron_jinja-1.0.1-py3-none-any.whl |
|---|---|
| Size | 52.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2975637fccd5953dfd4c86a8a2346a2b027135af090c912c1781f0ffaa919aef
|
|
BLAKE2b-256 checksum How to use checksums |
f7e64d4aca2cb6f3efb5e7210c350ca846d4be84d926f53671a34f55d8498209
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
