gotcha 0.4.0

Enhanced web framework built on top of Axum with OpenAPI, metrics, and configuration management
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

//! `#[config]` makes the application's own config extractable as `State<T>` directly, so a handler
//! reads `config.name` instead of reaching through a wrapper level (`config.application.name`).
//!
//! A blanket `impl FromRef<GotchaContext<S, C>> for C` is impossible (the orphan rule rejects a
//! bare type parameter as `Self`), which is why this is an attribute macro — the same reason
//! `#[state]` exists.

use gotcha::prelude::*;
use serde::{Deserialize, Serialize};

#[state]
#[derive(Clone, Default)]
struct AppState {}

#[config]
#[derive(Clone, Default, Serialize, Deserialize)]
struct AppConfig {
    name: String,
}

// The point: the application's own config, one level deep.
async fn config_handler(State(config): State<AppConfig>) -> impl Responder {
    config.name
}

// The framework's own settings are a separate extractor — no attribute needed, since
// `ServerConfig` belongs to gotcha.
async fn server_handler(State(server): State<ServerConfig>) -> impl Responder {
    format!("{}:{}", server.host, server.port)
}

// The whole wrapper is still available for anyone who wants both at once, and derefs to the
// application config.
async fn wrapper_handler(State(config): State<ConfigWrapper<AppConfig>>) -> impl Responder {
    format!("{} on {}", config.name, config.server.port)
}

fn main() {
    let _app = Gotcha::with_types::<AppState, AppConfig>()
        .get("/config", config_handler)
        .get("/server", server_handler)
        .get("/wrapper", wrapper_handler);
}