oasgen-core 0.5.0

Dependency of oasgen. Generates OpenAPI 3.0 spec based on Rust code. Works with actix-web, but architected to easily extend to other frameworks (or no framework).
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

use openapiv3 as oa;
use openapiv3::{Schema, ReferenceOr};
use crate::{impl_oa_schema_none, impl_oa_schema_passthrough, OaSchema};

impl_oa_schema_passthrough!(actix_web::web::Json<T>);
impl_oa_schema_passthrough!(sqlx::types::Json<T>);

impl_oa_schema_none!(actix_web::web::Data<sqlx::postgres::PgPool>);
impl_oa_schema_none!(actix_web::HttpRequest);
impl_oa_schema_none!(actix_web::HttpResponse);

macro_rules! construct_path {
    ($($arg:ident),+) => {
        impl< $($arg),+ > OaSchema for actix_web::web::Path<( $($arg),+,)>
            where
                $($arg: OaSchema),+
        {
            fn parameters() -> Option<Vec<ReferenceOr<oa::Parameter>>> {
                Some(vec![
                    $(
                        ReferenceOr::Item(oa::Parameter::Path {
                            parameter_data: oa::ParameterData {
                                name: stringify!($arg).to_string(),
                                description: None,
                                required: true,
                                deprecated: None,
                                format: oa::ParameterSchemaOrContent::Schema(ReferenceOr::Item(
                                    $arg::schema().unwrap(),
                                )),
                                example: None,
                                examples: Default::default(),
                                explode: None,
                                extensions: Default::default(),
                            },
                            style: oa::PathStyle::Simple,
                        })
                    ),+
                ])
            }
        }
    }
}

construct_path!(A1);
construct_path!(A1, A2);
construct_path!(A1, A2, A3);

impl<T: OaSchema> OaSchema for actix_web::web::Query<T> {
    fn parameters() -> Option<Vec<ReferenceOr<oa::Parameter>>> {
        Some(vec![ReferenceOr::Item(oa::Parameter::Query {
            parameter_data: oa::ParameterData {
                name: "query".to_string(),
                description: None,
                required: false,
                deprecated: None,
                format: oa::ParameterSchemaOrContent::Schema(ReferenceOr::Item(
                    T::schema().unwrap(),
                )),
                example: None,
                examples: Default::default(),
                explode: None,
                extensions: Default::default(),
            },
            allow_reserved: false,
            style: oa::QueryStyle::Form,
            allow_empty_value: None,
        })])
    }
}