rweb 0.15.0

Yet another web server framework for rust
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
75
76
77
78
79
80
81
82
83
84
85
86

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

use rweb::*;
use serde::{Deserialize, Serialize};

#[get("/")]
fn index(_: Json<Colors>) -> String {
    String::new()
}

#[derive(Debug, Serialize, Deserialize, Schema)]
struct Colors {
    colordef: Color,
    coloradj: ColorAdjtagged,
    colorint: ColorInttagged,
}

#[derive(Debug, Serialize, Deserialize, Schema)]
#[schema(component = "Color")]
pub enum Color {
    #[serde(rename = "black")]
    Black,
    #[serde(rename = "blue")]
    Blue,
}

impl std::str::FromStr for Color {
    type Err = &'static str;
    fn from_str(s: &str) -> Result<Self, Self::Err> {
        match s {
            "black" => Ok(Color::Black),
            "blue" => Ok(Color::Blue),
            _ => Err("ERR"),
        }
    }
}

#[derive(Debug, Serialize, Deserialize, Schema)]
#[serde(tag = "tag", rename_all = "lowercase")]
#[schema(component = "ColorInttagged")]
enum ColorInttagged {
    Black,
    Blue,
}

#[derive(Debug, Serialize, Deserialize, Schema)]
#[serde(rename_all = "lowercase")]
#[serde(tag = "tag", content = "content")]
#[schema(component = "ColorAdjtagged")]
enum ColorAdjtagged {
    Black,
    Blue,
}

#[test]
fn description() {
    let (spec, _) = openapi::spec().build(|| {
        //
        index()
    });
    let schemas = &spec.components.as_ref().unwrap().schemas;
    macro_rules! component {
        ($cn:expr) => {
            match schemas.get($cn) {
                Some(openapi::ObjectOrReference::Object(s)) => s,
                Some(..) => panic!("Component schema can't be a reference"),
                None => panic!("No component schema for {}", $cn),
            }
        };
    }
    let schema = component!("Color");
    assert_eq!(schema.schema_type, Some(openapi::Type::String));
    assert_eq!(schema.enum_values, vec!["black", "blue"]);
    let schema = component!("ColorInttagged");
    assert_eq!(schema.schema_type, Some(openapi::Type::Object));
    assert_eq!(schema.required, vec!["tag"]);
    let schema = schema.properties["tag"].unwrap().unwrap();
    assert_eq!(schema.schema_type, Some(openapi::Type::String));
    assert_eq!(schema.enum_values, vec!["black", "blue"]);
    let schema = component!("ColorAdjtagged");
    assert_eq!(schema.schema_type, Some(openapi::Type::Object));
    assert_eq!(schema.required, vec!["tag"]);
    let schema = schema.properties["tag"].unwrap().unwrap();
    assert_eq!(schema.schema_type, Some(openapi::Type::String));
    assert_eq!(schema.enum_values, vec!["black", "blue"]);
}