vantus 0.3.0

Macro-first async Rust backend framework with explicit composition, typed extraction, and hardened HTTP defaults.
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
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71

#[cfg(feature = "cli")]
use clap::Parser;
#[cfg(feature = "cli")]
use vantus::{CliFeatureDefaults, HostBuilder, RequestContext, Response, ServerCli, module};

#[cfg(feature = "cli")]
#[derive(Clone)]
struct DemoModule {
    service_name: String,
}

#[cfg(feature = "cli")]
#[module]
impl DemoModule {
    #[vantus::get("/")]
    fn index(&self, ctx: RequestContext) -> Response {
        Response::json_value(serde_json::json!({
            "service": self.service_name,
            "environment": ctx.app_config().environment,
            "profile": ctx.app_config().profile,
        }))
    }
}

#[cfg(feature = "cli")]
fn main() {
    let cli = ServerCli::parse();
    let defaults = CliFeatureDefaults {
        web_platform: true,
        observability: false,
    };

    let plan = match cli.startup_plan(defaults) {
        Ok(plan) => plan,
        Err(error) => {
            eprintln!("Vantus CLI Error: {error}");
            std::process::exit(2);
        }
    };

    if cli.print_startup_plan || cli.dry_run {
        println!("{plan}");
    }

    if cli.dry_run {
        return;
    }

    let mut builder = HostBuilder::new();
    if let Err(error) = cli.apply_to_builder(&mut builder, defaults) {
        eprintln!("Vantus CLI Error: {error}");
        std::process::exit(2);
    }

    builder.compose_with_config(|_configuration, app, context| {
        context.module(DemoModule {
            service_name: app.service_name.clone(),
        });
        Ok(())
    });

    builder.build().run_blocking();
}

#[cfg(not(feature = "cli"))]
fn main() {
    eprintln!(
        "Enable the `cli` feature to run this example: cargo run --example cli --features cli -- --help"
    );
    std::process::exit(1);
}