readme: update project structure to reflect src layout

This commit is contained in:
blankie 2026-06-17 05:16:34 +00:00
parent 3e30678e21
commit 257be691ed

View file

@ -215,9 +215,17 @@ For full feature docs, see the [tinyweb-forum README](https://codeberg.org/tinyw
## Project structure
```
app.py — Entry point: boots Reticulum, starts HTTP gateway
gateway.py — HTTP-to-RNS bridge (local or remote dispatch)
handlers/ — Route dispatcher and request handlers
app.py — Entry point (shim, imports from tinyweb.app)
pyproject.toml — Package configuration (src layout)
src/tinyweb/
__init__.py — Package marker
app.py — Boots Reticulum, starts HTTP gateway
db.py — SQLite database, FTS5, URL fetching, SSRF protection
gateway.py — HTTP-to-RNS bridge (local or remote dispatch)
templates.py — HTML template rendering and escaping
embeddings.py — Semantic search: ONNX, HNSW, reranking
rns_client.py — Reticulum client for fetching remote site lists
handlers/
__init__.py — Dispatch logic + re-exports
_helpers.py — CSRF, FTS sanitizer, pagination, response builders
search.py — Search (BM25, hybrid, trusted/remote results)
@ -226,10 +234,7 @@ handlers/ — Route dispatcher and request handlers
customize.py — Settings form, about page
tags.py — Tag list and browse
data.py — Export, import, semantic reindex
db.py — SQLite database, FTS5, URL fetching, SSRF protection
templates.py — HTML template rendering and escaping
rns_client.py — Reticulum client for fetching remote site lists
themes/ — Saved HTML templates (e.g. kodama.html)
themes/ — Saved HTML templates (e.g. default.html, junimo.html)
```
## Security