Pre-release
This release is a pre-release and may not be stable for production use.
sillo-inertia
sillo-inertia is a modern Inertia.js adapter for Sillo with support for React and Vue. It renders normal HTML on first-page visits and Inertia page JSON for requests with X-Inertia: true.
Use the canonical import:
from sillo_inertia import Inertia, vite_react, vite_vue
Install
pip install sillo-inertia
Quick Start
React + Vite
from sillo import silloApp
from sillo.core.http import Request, Response
from sillo_inertia import Inertia, vite_react
app = silloApp()
inertia = Inertia(
app,
root_view="resources/views/app.html",
version="1",
vite=vite_react(dev=True),
)
@app.get("/")
async def home(request: Request, response: Response):
return await inertia.render(request, response, "Home", {"name": "Sillo"})
Vue + Vite
from sillo import silloApp
from sillo.core.http import Request, Response
from sillo_inertia import Inertia, vite_vue
app = silloApp()
inertia = Inertia(
app,
root_view="resources/views/app.html",
version="1",
vite=vite_vue(dev=True),
)
@app.get("/")
async def home(request: Request, response: Response):
return await inertia.render(request, response, "Home", {"name": "Sillo"})
Root View Template
Your resources/views/app.html must include the {{ inertia }} placeholder:
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
{{ inertia_head }}
</head>
<body>
<div id="app" data-page='{{ inertia }}'></div>
</body>
</html>
Features
- Framework Agnostic: Full support for React and Vue (more to come)
- Full-page HTML: Renders HTML on first-page visits
- Inertia JSON: Responds with JSON for
X-Inertiarequests - Version Handling: Asset version conflict detection with HTTP
409andX-Inertia-Location - Partial Reload: Supports
X-Inertia-Partial-ComponentandX-Inertia-Partial-Datafor efficient updates - Shared Props: Global props accessible to all pages
- Sync & Async Props: Both sync callables and async functions work seamlessly
- Lazy Props: Defer expensive computations with
lazy()helper - Custom Root ID: Use any element ID for the Inertia mount point
- Dynamic Versioning: Support for callable version functions
Configuration
Inertia Configuration
Inertia(
app=app, # Sillo app instance (optional)
root_view="app.html", # Path to root template
version="1.0.0", # Static or callable version
root_id="app", # Root element ID
base_dir=".", # Base directory for asset paths
vite=vite_react(dev=True), # Vite configuration
)
React Options
vite_react(
entry="src/main.jsx", # Entry point
dev_server="http://localhost:5173", # Dev server URL
manifest_path="dist/.vite/manifest.json", # Production manifest
asset_prefix="/assets/", # Asset URL prefix
dev=True, # Development mode
react_refresh=True, # Enable React Fast Refresh
)
Vue Options
vite_vue(
entry="src/main.ts", # Entry point
dev_server="http://localhost:5173", # Dev server URL
manifest_path="dist/.vite/manifest.json", # Production manifest
asset_prefix="/assets/", # Asset URL prefix
dev=True, # Development mode
)
API Reference
Rendering Pages
# Basic rendering with props
await inertia.render(
request,
response,
"Home", # Component name
{"user": {"name": "John"}}, # Props dict
status_code=200, # HTTP status
view_data={"title": "Home"}, # Extra template data
)
# Lazy props for expensive computations
from sillo_inertia import lazy
await inertia.render(
request,
response,
"Home",
{
"user": {"id": 1, "name": "John"},
"permissions": lazy(lambda r: compute_permissions(r)),
}
)
Shared Props
inertia.share(
app_name="MyApp",
auth={"user": None},
)
Redirects
# Returns 303 for POST/PUT/PATCH, 302 for GET
inertia.redirect(request, response, "/dashboard")
# Custom status code
inertia.redirect(request, response, "/home", status_code=301)
Dynamic Props
Props can be static values, callables, or async functions:
# Static value
{"count": 5}
# Sync callable
{"count": lambda request: request.app.cache.get("count")}
# Async callable
async def get_count(request):
return await request.app.db.count()
{"count": get_count}
# Lazy prop (deferred resolution)
{"data": lazy(lambda r: expensive_computation())}
Examples
User Dashboard
@app.get("/dashboard")
async def dashboard(request: Request, response: Response):
user = await request.app.db.get_user(request.user_id)
posts = lazy(lambda _: request.app.db.list_posts(request.user_id))
return await inertia.render(
request,
response,
"Dashboard",
{
"user": user.to_dict(),
"posts": posts,
}
)
Form Submission
@app.post("/users")
async def create_user(request: Request, response: Response):
data = await request.json()
user = await request.app.db.create_user(data)
return inertia.redirect(request, response, f"/users/{user.id}")
Partial Page Updates
# Client sends:
# GET /api/comments?post_id=1
# X-Inertia: true
# X-Inertia-Partial-Component: PostDetail
# X-Inertia-Partial-Data: comments
@app.get("/posts/{post_id}")
async def post_detail(request: Request, response: Response):
post = await request.app.db.get_post(request.path_params["post_id"])
comments = lazy(lambda _: request.app.db.list_comments(post.id))
return await inertia.render(
request,
response,
"PostDetail",
{
"post": post.to_dict(),
"comments": comments,
}
)
Project Links
- Repository: https://github.com/sillohq/inertia
- Documentation: https://sillolabs.com
- Sillo Framework: https://github.com/sillohq/core
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
sillo_inertia-0.0.1a1.tar.gz
(42.5 kB
view details)
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 sillo_inertia-0.0.1a1.tar.gz.
File metadata
- Download URL: sillo_inertia-0.0.1a1.tar.gz
- Upload date:
- Size: 42.5 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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bc047c4e5b1dd4393b780055fb71e49d098576b431ec98ac55f25ddbab6b8f86
|
|
| MD5 |
912c7e70304b83eec9803a6a45507a8c
|
|
| BLAKE2b-256 |
3668ba37e8723d8591c499e3dbd8b2aaab9242487cb4991b86c3ede957649e34
|
File details
Details for the file sillo_inertia-0.0.1a1-py3-none-any.whl.
File metadata
- Download URL: sillo_inertia-0.0.1a1-py3-none-any.whl
- Upload date:
- Size: 7.7 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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fb641de246d939a3528a7cda1f7c120fdb09edd54200fcb68237cac8dc63f3d0
|
|
| MD5 |
a5fe283b5cc32844e3aca6094eb7ba90
|
|
| BLAKE2b-256 |
8139985bda5dddd371a6df424f17002263270a42e9e756538951bba3d1143f53
|
