1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
// Library entry point — exposes modules for integration tests and future
// embedding. The binary in main.rs is the primary deliverable, and it
// consumes *this* crate rather than re-declaring the module tree: a
// second `mod app;` in main.rs would compile a private duplicate of
// every module, so `app`'s unit tests would run only under
// `cargo test --bin edamame` and be invisible to `cargo test --lib`.
// Every module the binary needs must therefore be declared here.
// The doc comments in this crate are written for contributors, not for
// downstream API consumers: they routinely link private helpers next to
// the public entry points that call them, because the *why* usually lives
// in the private half. Build the docs with `--document-private-items`
// (see AGENTS.md) and those links resolve to real pages.
//
// `broken_intra_doc_links` and `invalid_html_tags` are deliberately left
// at their default `warn` — a link that names a since-renamed item is doc
// rot worth hearing about.
/// Shared test-only helpers. Crate-wide rather than per-module because
/// environment mutation races across module boundaries — see the module
/// docs.