readme: update project structure to reflect src layout

This commit is contained in:
blankie 2026-06-17 05:16:34 +00:00
parent 0669aaf3a0
commit f3bfe50abc

View file

@ -215,21 +215,26 @@ 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
__init__.py — Dispatch logic + re-exports
_helpers.py — CSRF, FTS sanitizer, pagination, response builders
search.py — Search (BM25, hybrid, trusted/remote results)
pages.py — Add/edit/delete/bulk/bookmark handlers
subscriptions.py — Sync, sharing, API, subscription CRUD
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)
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)
pages.py — Add/edit/delete/bulk/bookmark handlers
subscriptions.py — Sync, sharing, API, subscription CRUD
customize.py — Settings form, about page
tags.py — Tag list and browse
data.py — Export, import, semantic reindex
themes/ — Saved HTML templates (e.g. default.html, junimo.html)
```
## Security