PyJinHx
Type-safe UI components for Python web apps. A component is a Pydantic model plus a Jinja template sitting next to it — nest them with PascalCase tags, and co-located JS/CSS is collected automatically at render.
pip install pyjinhx
Example
A Card that renders a Button — the tag's attributes become validated Pydantic fields:
# components/button.py
from pyjinhx import BaseComponent
class Button(BaseComponent):
id: str
text: str
variant: str = "default"
<!-- components/button.html -->
<button id="{{ id }}" class="btn btn-{{ variant }}">{{ text }}</button>
<!-- components/card.html -->
<div id="{{ id }}" class="card">
<h2>{{ title }}</h2>
<Button id="cta" text="{{ button_text }}" variant="primary"/>
</div>
# components/card.py
from pyjinhx import BaseComponent, Renderer
class Card(BaseComponent):
id: str
title: str
button_text: str = "Sign up"
Renderer.set_default_environment("./components")
html = Card(id="hero", title="Get Started").render()
Drop a button.css or card.js next to the component and it's included once, automatically.
Reactivity (HTMX)
Components declare what state they depend on. Return one component from a mutation route — every other mounted region that reacts to the same keys updates via out-of-band swaps, no manual wiring:
from pyjinhx import ReactiveComponent, MutationKey, mutates, setup
class Keys(MutationKey):
TODOS = "todos"
class Counter(ReactiveComponent, react={Keys.TODOS}):
remaining: int
@classmethod
def load(cls) -> "Counter":
return cls(remaining=db.remaining())
@mutates(Keys.TODOS)
def toggle_all():
db.toggle_all()
setup(app) # FastAPI: lifespan + middleware, done
@app.post("/todos/toggle")
def toggle():
toggle_all()
return Counter.render() # other regions reacting to TODOS update too
Learn more
- Usage tiers — adopt only the layers you need
- Components · PascalCase tags · Assets
- Reactivity guide · full todo example
- Built-in components
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file pyjinhx-0.33.0.tar.gz.
File metadata
- Download URL: pyjinhx-0.33.0.tar.gz
- Upload date:
- Size: 446.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.9.25
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f543d0dda45ba5106e98220d0111d04ae7d024ebbd69b08c39e1ecc1a673bb24
|
|
| MD5 |
64f2609fa1665ee0f92878088a4b65ef
|
|
| BLAKE2b-256 |
413bfa18876f903e83197eb54828a14e56267f2244627cc7dcf96b7aecfdf873
|
File details
Details for the file pyjinhx-0.33.0-py3-none-any.whl.
File metadata
- Download URL: pyjinhx-0.33.0-py3-none-any.whl
- Upload date:
- Size: 215.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.9.25
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b9eac2e4c3bc050df21483d1464428783075e8991d788f3410246a1ceacd38b9
|
|
| MD5 |
050cfdbf96fd4989c2c0bf4df239dcbd
|
|
| BLAKE2b-256 |
457741beb3665362d7d1edb445f809c2dcc005b27c7c95fdef09d70dec737e5d
|
