📝 Add mail and file upload guides
Document pagetop-mail (configuration, templates, layout, previews, queue and tests with the outbox) and file uploads (`web::Upload`, `form::File`, `web::Download` and the [upload] settings). doccheck enables the mail queue, keeps mail in memory and saves uploads under `target/`.
This commit is contained in:
parent
4e007feec8
commit
f42f5e9b89
13 changed files with 1118 additions and 8 deletions
11
README.md
11
README.md
|
|
@ -95,12 +95,13 @@ When writing a chapter:
|
|||
```` ```rust,no_run ```` for the rest, and ```` ```rust,ignore ```` only for loose fragments
|
||||
that are not valid on their own.
|
||||
- Examples can use `pagetop`, `pagetop-admin`, `pagetop-bootsier`, `pagetop-cron`,
|
||||
`pagetop-htmx`, `pagetop-mail`, `pagetop-seaorm` (with SQLite), `pagetop-user`, `pagetop-build`,
|
||||
`serde`, `thiserror`, `tokio` and `tower-http` (with the `compression-gzip`, `cors`, `limit` and
|
||||
`timeout` features); the translations in `tools/doccheck/src/locale/` (`LOCALES_APP`), and a
|
||||
static files bundle named `app`. If a chapter needs anything else, add it to `tools/doccheck`.
|
||||
`pagetop-htmx`, `pagetop-mail` (with its `queue` feature), `pagetop-seaorm` (with SQLite),
|
||||
`pagetop-user`, `pagetop-build`, `serde`, `thiserror`, `tokio` and `tower-http` (with the
|
||||
`compression-gzip`, `cors`, `limit` and `timeout` features); the translations in
|
||||
`tools/doccheck/src/locale/` (`LOCALES_APP`), and a static files bundle named `app`. If a chapter needs anything else, add it to `tools/doccheck`.
|
||||
- Examples and tests that start an application read `tools/doccheck/config/`: those with a database
|
||||
get a new in-memory SQLite one on every run.
|
||||
get a new in-memory SQLite one on every run, mail is kept in memory (`pagetop_mail::outbox`) and
|
||||
uploaded files go to `tools/doccheck/target/doccheck-uploads`.
|
||||
- Tests that share state (a static store, a database) run in the same process: write one test per
|
||||
flow, so that their results do not depend on the order they run in.
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue