Struct Bootstrap 

pub struct Bootstrap { /* private fields */ }

Builds and serves a Laterite application.

Implementations

impl Bootstrap

pub fn new(config_dir: impl Into<PathBuf>) -> Self

Loads config from config_dir (default.toml, the APP_ENV overlay, and local.toml). Env vars override under the prefix the config declares as app.env_prefix, else DEFAULT_ENV_PREFIX; Bootstrap::env_prefix overrides both.

pub fn env_prefix(self, prefix: impl Into<String>) -> Self

Overrides the config env-var prefix from code, above the config’s own app.env_prefix declaration and DEFAULT_ENV_PREFIX.

pub fn module(self, module: impl Module) -> Self

Registers one of the application’s own modules, after the built-in ones. Its migrations and contributions run after those of the modules it names in requires. App modules are load-critical: a failure at boot aborts, rather than being quarantined like a plugin registered with Bootstrap::modules.

pub fn modules(self, modules: Vec<Box<dyn Module>>) -> Self

Registers a set of plugins, typically the generated plugins-manifest. Plugins are isolated at boot: one that fails to migrate or register is quarantined (logged and skipped, taking its dependents with it) rather than aborting the whole application.

pub fn extend( self, f: impl FnOnce(Router, &BootstrapCtx) -> Router + 'static, ) -> Self

Merges the app’s own routes onto the admin router before serving. The closure gets the assembled router and a BootstrapCtx.

pub async fn serve(self) -> Result<()>

Loads config, connects, migrates, builds the router, and serves, with the queue’s workers beside it when queue.mode is worker. Uses a systemfd-inherited socket in development, else binds the configured address. Stops on Ctrl-C or SIGTERM, letting running jobs finish.

pub async fn run(self) -> Result<()>

Reads the process’s own arguments and does what they ask: serve (the default, as Bootstrap::serve), queue work [--once] [--stop-when-empty] [--queue a,b] (a worker alone) or schedule run [--once] (the ticker alone). The scaffolded main calls this, so lat queue work and lat schedule run have something to run.