Skip to main content

hedron-jinja

PyPI Python CI License: MIT

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 typed Hedron components and render metadata. Install as hedron-jinja or via the flagship extra hedron[jinja].

Package maturity: Beta · Train: 0.25.x (last published 0.25.1; workspace 0.25.2 candidate) · pin >=0.25.0,<0.26

Install

pip install "hedron-jinja>=0.25.0,<0.26"
# or
uv add "hedron-jinja>=0.25.0,<0.26"
# via flagship:
pip install "hedron[jinja]>=0.25.0,<0.26"

Requires Python 3.11–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)

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

License

MIT. See LICENSE.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hedron_jinja-0.25.2.tar.gz (34.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

hedron_jinja-0.25.2-py3-none-any.whl (38.0 kB view details)

Uploaded Python 3

File details

Details for the file hedron_jinja-0.25.2.tar.gz.

File metadata

  • Download URL: hedron_jinja-0.25.2.tar.gz
  • Upload date:
  • Size: 34.7 kB
  • Tags: Source
  • Uploaded using 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}

File hashes

Hashes for hedron_jinja-0.25.2.tar.gz
Algorithm Hash digest
SHA256 e0ad17cde90e686b519e26a31fefbe71375525cb0aaf4827dddbe9b9ee5e6458
MD5 c4a173f00fd3ac2720a5d656cdba45b9
BLAKE2b-256 5e5166ef4f54af5982249e1f73178c40c60915b85fabd1908adae0889e775b30

See more details on using hashes here.

File details

Details for the file hedron_jinja-0.25.2-py3-none-any.whl.

File metadata

  • Download URL: hedron_jinja-0.25.2-py3-none-any.whl
  • Upload date:
  • Size: 38.0 kB
  • Tags: Python 3
  • Uploaded using 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}

File hashes

Hashes for hedron_jinja-0.25.2-py3-none-any.whl
Algorithm Hash digest
SHA256 bbe8f611de570a7b4d97be5bfa4ad31cf194367b460674f8ab586b37c52b66ae
MD5 4cf54e1e0636beff4587c995b412f9c0
BLAKE2b-256 6e7dcc373e945a3e781f1cfefde0eb1d91fc6fb5f01879ed3bd29a62a0ce40f5

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page