htagweb
This module exposes htag's runners for the web. It's the official runners to expose htag apps on the web, to handle multiple clients/session in the right way.
Runner
It's the real runner to expose htag apps in a real production environment, and provide all features, while maintaining tag instances like classical/desktop htag runners.
All htag apps are runned in its own process, and an user can only have an instance of an htag app. (so process are recreated when query params changes) Process live as long as the server live
Features
- based on starlette
- use session
- compatible with uvloop !!!
- compatible with multiple gunicorn/uvicorn/webworkers !!!
- compatible with tag.update()
- works on gnu/linux, ios
or windows(from py3.8 to py3.11)! (not py3.7 anymore ;-() - real starlette session available (in tag.state, and starlette request.session)
- compatible with oauth2 authent ( authlib )
- 'parano mode' (can aes encrypt all communications between client & server ... to avoid mitm'proxies on ws/http interactions)
- auto reconnect websocket
Instanciate
Like a classical starlette'app :
from htagweb import Runner
from yourcode import YourApp # <-- your htag class
app=Runner( YourApp, ... )
if __name__=="__main__":
app.run()
You can use the following parameters :
host (str)
The host to bind to. (default is "0.0.0.0")
port (int)
The port to bind to. (default is 8000)
debug (bool)
- When False: (default) no debugging facilities
- When True: use starlette debugger.
parano (bool)
- When False: (default) interactions between front/ui and back are in clear text (json), readable by a MITM.
- When True: interactions will be encrypted (less readable by a MITM, TODO: will try to use public/private keys in future)
this parameter is available on app.handle(request, obj, ... parano=True|False ...) too, to override defaults !
http_only (bool)
- When False: (default) it will use websocket interactions (between front/ui and back), with auto-reconnect feature.
- When True: it will use http interactions (between front/ui and back). But "tag.update" feature will not be available.
this parameter is available on app.handle(request, obj, ... http_only=True|False ...) too, to override defaults !
timeout_interaction (int)
It's the time (in seconds) for an interaction (or an initialization) for answering. If the timeout happens : the process/instance is killed.
By default, it's 60 seconds (1 minute).
timeout_inactivity (int)
It's the time (in seconds) of inactivities, after that : the process is detroyed.
By default, it's 0 (process lives as long as the server lives).
IMPORTANT : the "tag.update" feature doesn't reset the inactivity timeout !
to add an endpoint (add_route)
Example to add a static endpoint :
from starlette.responses import PlainTextResponse
async def serve(req):
return PlainTextResponse("body {}")
app=Runner( App, debug=False )
app.add_route("/my.css", serve)
Example to add another htag app on another endpoint :
async def serve(req):
return await req.app.handle(req, App2 )
app=Runner( App, debug=False )
app.add_route("/my_other_app", serve)
Roadmap / futur
- more unittests !!!!!!!!!!!!!!!!
- better logging !!!!!!!!!!!!!!!!
- parano mode : use public/private keys ?
Examples
A "hello world" could be :
from htag import Tag
class App(Tag.div):
def init(self):
self<= "hello world"
from htagweb import Runner
Runner( App ).run()
or, with gunicorn (in a server.py file, as following):
from htag import Tag
class App(Tag.div):
def init(self):
self<= "hello world"
from htagweb import Runner
app=Runner( App )
and run server :
gunicorn -w 4 -k uvicorn.workers.UvicornH11Worker -b localhost:8000 --preload server:app
See a more advanced example in examples folder
python3 examples/main.py
1 maintainer
Metadata
1 maintainer
Release files for htagweb 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| htagweb-1.0.0.tar.gz | 145.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| htagweb-1.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 164.5 kB
Release files / htagweb-1.0.0.tar.gz
| Download URL | htagweb-1.0.0.tar.gz |
|---|---|
| Size | 145.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
da8b145d671f1a0c65a731019babe09f6a5f06d9ddca14cf535729f33eb060ef
|
|
BLAKE2b-256 checksum How to use checksums |
64ae8f277066dfc4fff10e5768d09a043c4e3b99ff478bc5cf964046c56f784f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 7, 2026.
Transparency logRelease files / htagweb-1.0.0-py3-none-any.whl
| Download URL | htagweb-1.0.0-py3-none-any.whl |
|---|---|
| Size | 18.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c10c9c0f019e267f286c520e7e6abc284686f7d5f532c7117c9c30dc36b10d70
|
|
BLAKE2b-256 checksum How to use checksums |
8500043932507d1beab19ee52fac8ca6a3fc8c30b0c429b7a3c5887bb86701a6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 7, 2026.
Transparency log
