cargo-nidus 1.0.0

Command-line project generator and inspection tooling for Nidus applications.
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
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126

use super::discover_controller_routes;

#[test]
fn discovers_routes_from_syn_attributes_in_controller_impls() {
    let file = syn::parse_file(
        r#"
use nidus::prelude::*;

#[controller("/users")]
pub struct UsersController;

#[routes]
impl UsersController {
    #[guard(crate::auth::AuthGuard)]
    #[pipe(ValidationPipe)]
    #[validate]
    #[openapi(
        summary = "Find user",
        tags = ["users", "read"],
        status = 201,
        request = CreateUserDto,
        response = UserDto
    )]
    #[get(
        "/:id"
    )]
    pub async fn find(&self) {}
}
"#,
    )
    .unwrap();

    let routes = discover_controller_routes(&file).unwrap();

    assert_eq!(routes.len(), 1);
    let route = &routes[0];
    assert_eq!(route.method, "get");
    assert_eq!(route.path, "/users/{id}");
    assert_eq!(route.summary.as_deref(), Some("Find user"));
    assert_eq!(route.tags, ["users", "read"]);
    assert_eq!(route.response_status, Some(201));
    assert_eq!(route.request_schema.as_deref(), Some("CreateUserDto"));
    assert_eq!(route.response_schema.as_deref(), Some("UserDto"));
    assert_eq!(route.guards, ["crate::auth::AuthGuard"]);
    assert_eq!(route.pipes, ["ValidationPipe"]);
    assert!(route.validates);
}

#[test]
fn rejects_duplicate_route_method_attributes() {
    let file = syn::parse_file(
        r#"
use nidus::prelude::*;

#[controller("/users")]
pub struct UsersController;

#[routes]
impl UsersController {
    #[get("/:id")]
    #[post("/")]
    pub async fn find(&self) {}
}
"#,
    )
    .unwrap();

    let error = discover_controller_routes(&file).unwrap_err();

    assert!(
        error
            .to_string()
            .contains("route methods must declare exactly one HTTP method attribute")
    );
}

#[test]
fn rejects_malformed_controller_metadata() {
    let file = syn::parse_file(
        r#"
use nidus::prelude::*;

#[controller]
pub struct UsersController;

#[routes]
impl UsersController {
    #[get("/:id")]
    pub async fn find(&self) {}
}
"#,
    )
    .unwrap();

    let error = discover_controller_routes(&file).unwrap_err();

    assert!(
        error
            .to_string()
            .contains("#[controller] requires a string literal path")
    );
}

#[test]
fn rejects_malformed_route_type_metadata() {
    let file = syn::parse_file(
        r#"
use nidus::prelude::*;

#[controller("/users")]
pub struct UsersController;

#[routes]
impl UsersController {
    #[guard]
    #[get("/:id")]
    pub async fn find(&self) {}
}
"#,
    )
    .unwrap();

    let error = discover_controller_routes(&file).unwrap_err();

    assert!(error.to_string().contains("#[guard] requires a type path"));
}