arcature 2026.2.1

Arcature application framework: a high-level Application facade over the certified Arcature subsystems, with the low-level Axum/Tower escape hatch preserved.
Documentation 
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

//! The application binary-subcommand dispatch library (AP2.1-10).
//!
//! Arcature applications ship a single binary that dispatches subcommands
//! (`serve`, `migrate`, `queue`, `schedule`, `doctor`, `about`) to one
//! shared internal operation layer (PROGRAM.md AP2.1-10). The app's `main`
//! implements [`Operations`] and calls `run` (the macros-gated runtime
//! wrapper) or parses with [`parse`] and dispatches with [`dispatch`] on a
//! custom runtime.
//!
//! One file owns one responsibility (AGENTS.md §1):
//!
//! - `subcommand` — the typed [`Subcommand`] enum and the [`parse`]
//!   function (pure `std`, no feature flags).
//! - `operations` — the [`Operations`] trait the app implements (pure
//!   `std`).
//! - [`dispatch`] — the runtime-agnostic async dispatch (no tokio).
//! - `run` — the convenience runner that reads argv and builds the
//!   certified Tokio runtime (`macros`-feature-gated).
//!
//! This module does not touch the templates (AP2.1-S owns the generated
//! bootstrap/main.rs); the app's `main` calls into it. A test binary in
//! `tests/bin_dispatch.rs` exercises the dispatch end-to-end this wave.

mod dispatch;
mod operations;
#[cfg(feature = "macros")]
mod run;
mod subcommand;

pub use dispatch::dispatch;
pub use operations::Operations;
pub use subcommand::{Subcommand, SubcommandError, parse};

// `run` needs the certified Tokio runtime (`macros` feature). Exported only
// when `macros` is on.
#[cfg(feature = "macros")]
pub use run::run;