vyuh 0.2.5

Vyuh web framework for Axum and SQLx with handler-first APIs
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
72
73
74

//! Role permits and OpenAPI bearer security metadata.
//!
//! Run:
//!
//! ```sh
//! cargo run --example auth_roles_openapi
//! ```

use schemars::JsonSchema;
use serde::Serialize;
use vyuh::{
    auth::{AuthUser, BitRole, permit},
    bundles,
    routes::Json,
};

#[derive(BitRole)]
enum AppRole {
    Manager,
    Editor,
    Viewer,
}

#[derive(Debug, Serialize, JsonSchema)]
struct Secret {
    message: &'static str,
}

#[bundles::route(path = "/account")]
async fn account(user: AuthUser) -> Json<Secret> {
    let _ = user;
    Json(Secret {
        message: "authenticated",
    })
}

#[bundles::route(path = "/manage")]
async fn managers_only(_permit: permit!(AppRole, Manager)) -> Json<Secret> {
    Json(Secret {
        message: "managers only",
    })
}

#[bundles::route(path = "/edit")]
async fn editor_or_manager(_permit: permit!(AppRole, Manager | Editor)) -> Json<Secret> {
    Json(Secret {
        message: "editor or manager",
    })
}

fn main() {
    let manager = AuthUser::new(
        "manager-1",
        AppRole::Manager.to_role_type() | AppRole::Viewer.to_role_type(),
    );
    assert_ne!(manager.roles, 0);

    let bundle = bundles::bundle! {
        account,
        managers_only,
        editor_or_manager,
    }
    .with_openapi(
        bundles::OpenApiConf::default()
            .title("Auth API")
            .spec("/openapi.json"),
    );

    assert_eq!(
        bundle.reverse("managers_only", &[]),
        Some("/manage".to_string())
    );
    println!("auth OpenAPI security metadata registered");
}