This release is a pre-release and may not be stable for production use.
dj-hyperview
Server-driven Hyperview UI for Django, with every screen owned by your project. Resolve, render, validate, cache, and publish mobile UI from filesystem or database templates without bundling application screens into the package.
- Consumer-owned screens — keep XML and HXML inside the Django project that defines the mobile application.
- Ordered template sources — resolve from configured filesystem directories, the optional database app, or custom source backends with explicit precedence.
- Live database publication — edit validated templates through Django admin and expose committed changes on the next request, with an optional HXML-aware Ace editor.
- Cache consistency — opt into any Django cache backend, including Redis, with source-aware keys and generation-based invalidation.
- Django-native HTTP integration — use lazy template responses, class-based views, validated fragment responses, request metadata, content negotiation, and standard CSRF protection.
- Fail-closed validation — enforce canonical names, UTF-8, XML safety, configurable resource limits, and optional XSD 1.1 validation against the bundled Hyperview 0.110.0 schemas plus project extensions.
dj-hyperview does not ship application screens, runtime application HXML, mobile components, Redis, or a required database app. Those choices remain under the consumer project's control.
Requirements
- Python: 3.12, 3.13, or 3.14
- Django: 5.2 or 6.1
- lxml: 6.1 or newer, below 7
- Hyperview contract: 0.110.0
Installation
# uv (recommended)
uv add dj-hyperview
# pip
pip install dj-hyperview
Register the base Django application:
INSTALLED_APPS = [
# Your project applications.
"dj_hyperview",
]
The base app performs no database, cache, or network access during startup. Database-backed templates and admin integration are optional.
Install schema validation or the complete admin-authoring profile only when a project needs them:
uv add "dj-hyperview[schema]"
uv add "dj-hyperview[editor]"
The editor profile includes XSD validation. Enable it explicitly:
INSTALLED_APPS = [
"django_ace",
"dj_hyperview",
"dj_hyperview.contrib.database",
]
HYPERVIEW = {
"ADMIN": {"EDITOR": True},
"VALIDATION": {
"SCHEMA": "dj_hyperview.validate_hyperview_schema",
},
}
Quick start
Create hyperview/screens/home.xml inside the consumer project:
<?xml version="1.0" encoding="UTF-8"?>
<doc xmlns="https://hyperview.org/hyperview">
<screen id="home">
<body>
<view>
<text>Hello from Django</text>
</view>
</body>
</screen>
</doc>
Configure the filesystem source in settings.py:
from pathlib import Path
BASE_DIR = Path(__file__).resolve().parent.parent
HYPERVIEW = {
"TEMPLATE_DIRS": [BASE_DIR / "hyperview"],
"SOURCES": [
{"BACKEND": "dj_hyperview.sources.FileSystemSource"},
],
}
Expose the screen through Django's URL configuration:
from django.urls import path
from dj_hyperview import HyperviewTemplateView
urlpatterns = [
path(
"hyperview/home/",
HyperviewTemplateView.as_view(template_name="screens/home.xml"),
name="hyperview-home",
),
]
A request to /hyperview/home/ returns the rendered document as
application/vnd.hyperview+xml.
Configuration
All package settings live under the HYPERVIEW dictionary. Sources are queried
in declaration order, and the first match wins:
HYPERVIEW = {
"TEMPLATE_DIRS": [BASE_DIR / "hyperview"],
"SOURCES": [
{"BACKEND": "dj_hyperview.contrib.database.sources.DatabaseSource"},
{"BACKEND": "dj_hyperview.sources.FileSystemSource"},
],
}
To publish templates through the database and Django admin, add the optional app and run migrations:
INSTALLED_APPS = [
# Django applications used by your project.
"django.contrib.admin",
"dj_hyperview",
"dj_hyperview.contrib.database",
]
python manage.py migrate
Caching remains disabled unless a non-empty HYPERVIEW["CACHE"] configuration
is supplied. See the configuration and cache guides before enabling a shared
backend.
Documentation
📚 Full documentation — including Installation, Quick Start, Mobile Getting Started, Configuration, Filesystem sources, Database and admin, Cache consistency, Security, HTTP responses, Changelog, and the public Python API.
The package is published at PyPI.
Development
See the contributing guide for the quality contract, supported test matrix, and release workflow.
uv sync --all-groups
uv run pytest
uv run ruff check .
uv run ruff format --check .
License
dj-hyperview is distributed under the MIT License.
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 dj_hyperview-0.1.0a9.tar.gz.
File metadata
- Download URL: dj_hyperview-0.1.0a9.tar.gz
- Upload date:
- Size: 62.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c42ad8236c4895ce3ff2c4aaeae32d4f2b074047d6f66a9c01dd377b3ddf7c87
|
|
| MD5 |
bbf09bfee1af0f21aa0ccbed783f9d2a
|
|
| BLAKE2b-256 |
887b33aaa218f0662d163e00c316ec9caec2e39310b9050aca4bc437061e8e36
|
Provenance
The following attestation bundles were made for dj_hyperview-0.1.0a9.tar.gz:
Publisher:
release.yml on eamigo86/dj-hyperview
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
dj_hyperview-0.1.0a9.tar.gz -
Subject digest:
c42ad8236c4895ce3ff2c4aaeae32d4f2b074047d6f66a9c01dd377b3ddf7c87 - Sigstore transparency entry: 2753298539
- Sigstore integration time:
-
Permalink:
eamigo86/dj-hyperview@1ef3f319f7d74b1b592080aedebd5772b11503f7 -
Branch / Tag:
refs/tags/v0.1.0a9 - Owner: https://github.com/eamigo86
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@1ef3f319f7d74b1b592080aedebd5772b11503f7 -
Trigger Event:
push
-
Statement type:
File details
Details for the file dj_hyperview-0.1.0a9-py3-none-any.whl.
File metadata
- Download URL: dj_hyperview-0.1.0a9-py3-none-any.whl
- Upload date:
- Size: 82.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5bf2d344467d962c8e1bf096727fe4f9f2d026a37431fa0dc8a3af96c95471eb
|
|
| MD5 |
e3019dbc6cd76411c4fbd97f2ce19cac
|
|
| BLAKE2b-256 |
bc6715ee1110b39e8880a466c89bb34fcb7bf4ef6c0444cc0074359b81fe47c5
|
Provenance
The following attestation bundles were made for dj_hyperview-0.1.0a9-py3-none-any.whl:
Publisher:
release.yml on eamigo86/dj-hyperview
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
dj_hyperview-0.1.0a9-py3-none-any.whl -
Subject digest:
5bf2d344467d962c8e1bf096727fe4f9f2d026a37431fa0dc8a3af96c95471eb - Sigstore transparency entry: 2753298584
- Sigstore integration time:
-
Permalink:
eamigo86/dj-hyperview@1ef3f319f7d74b1b592080aedebd5772b11503f7 -
Branch / Tag:
refs/tags/v0.1.0a9 - Owner: https://github.com/eamigo86
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@1ef3f319f7d74b1b592080aedebd5772b11503f7 -
Trigger Event:
push
-
Statement type:
