vyuh 0.2.7

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

//! Basic OpenAPI registration for a route bundle.
//!
//! Run:
//!
//! ```sh
//! cargo run --example openapi_basic
//! ```

use schemars::JsonSchema;
use serde::{Deserialize, Serialize};
use vyuh::{bundles, routes::Json};

#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema)]
struct Note {
    id: i64,
    title: String,
}

/// List notes visible to the current caller.
#[bundles::route(path = "/notes")]
async fn list_notes() -> Json<Vec<Note>> {
    Json(vec![Note {
        id: 1,
        title: "document OpenAPI".to_string(),
    }])
}

fn main() {
    let bundle = bundles::bundle! {
        list_notes,
    }
    .with_openapi(
        bundles::OpenApiConf::default()
            .title("Notes API")
            .version("0.1.0")
            .description("OpenAPI basic example")
            .spec("/api/openapi.json"),
    )
    .with_prefix("/v1");

    assert_eq!(
        bundle.reverse("list_notes", &[]),
        Some("/v1/notes".to_string())
    );
    println!("OpenAPI spec path: /v1/api/openapi.json");
}