ultimo 0.9.0

Modern Rust web framework with automatic TypeScript client generation
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

#![cfg(feature = "testing")]

use ultimo::openapi::OpenApiBuilder;
use ultimo::testing::TestClient;
use ultimo::Ultimo;

#[tokio::test]
async fn serve_docs_returns_swagger_ui_html() {
    let mut app = Ultimo::new_without_defaults();
    let spec = OpenApiBuilder::new()
        .title("Test API")
        .version("1.0.0")
        .build();
    app.serve_docs("/docs", spec);

    let client = TestClient::new(app);
    let res = client.get("/docs").send().await;

    assert_eq!(res.status(), 200);
    let body = res.text();
    assert!(body.contains("swagger"), "Should contain Swagger UI");
    assert!(
        body.contains("/docs/openapi.json"),
        "Should reference spec URL"
    );
}

#[tokio::test]
async fn serve_docs_returns_openapi_json() {
    let mut app = Ultimo::new_without_defaults();
    let spec = OpenApiBuilder::new()
        .title("My Test API")
        .version("2.0.0")
        .description("A test API")
        .build();
    app.serve_docs("/docs", spec);

    let client = TestClient::new(app);
    let res = client.get("/docs/openapi.json").send().await;

    assert_eq!(res.status(), 200);
    let body = res.text();
    let json: serde_json::Value = serde_json::from_str(&body).expect("Should be valid JSON");
    assert_eq!(json["info"]["title"], "My Test API");
    assert_eq!(json["info"]["version"], "2.0.0");
    assert_eq!(json["openapi"], "3.0.0");
}

#[tokio::test]
async fn serve_docs_custom_path() {
    let mut app = Ultimo::new_without_defaults();
    let spec = OpenApiBuilder::new()
        .title("Custom")
        .version("1.0.0")
        .build();
    app.serve_docs("/api-docs", spec);

    let client = TestClient::new(app);

    let res = client.get("/api-docs").send().await;
    assert_eq!(res.status(), 200);

    let res = client.get("/api-docs/openapi.json").send().await;
    assert_eq!(res.status(), 200);
}