openapi-resolver 0.1.0

$ref resolver for OpenAPI schemas
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
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
127
128
129
130
131
132
133
134

use openapiv3::{
    Header, OpenAPI, Parameter, PathItem, ReferenceOr, RequestBody, Response, Schema,
    SecurityScheme,
};

pub fn resolve_reference<'a, T>(source: &'a ReferenceOr<T>, root: &'a OpenAPI) -> Option<&'a T>
where
    &'a T: RefResolve<'a>,
{
    match source {
        ReferenceOr::Item(item) => Some(item),
        ReferenceOr::Reference { reference } => RefResolve::resolve(&root, reference),
    }
}

pub trait RefResolve<'d>: Sized {
    fn resolve(api: &'d OpenAPI, link: &'d str) -> Option<Self>;
}

impl<'a> RefResolve<'a> for &'a Response {
    fn resolve(api: &'a OpenAPI, link: &'a str) -> Option<Self> {
        if let Some(name) = link.strip_prefix("#/components/responses/") {
            match &api.components {
                Some(components) => match components.responses.get(name) {
                    Some(ReferenceOr::Reference { reference }) => Self::resolve(api, reference),
                    Some(ReferenceOr::Item(item)) => Some(item),
                    None => None,
                },
                None => None,
            }
        } else {
            None
        }
    }
}

impl<'a> RefResolve<'a> for &'a Parameter {
    fn resolve(api: &'a OpenAPI, link: &'a str) -> Option<Self> {
        if let Some(name) = link.strip_prefix("#/components/parameters/") {
            match &api.components {
                Some(components) => match components.parameters.get(name) {
                    Some(ReferenceOr::Reference { reference }) => Self::resolve(api, reference),
                    Some(ReferenceOr::Item(item)) => Some(item),
                    None => None,
                },
                None => None,
            }
        } else {
            None
        }
    }
}

impl<'a> RefResolve<'a> for &'a SecurityScheme {
    fn resolve(api: &'a OpenAPI, link: &'a str) -> Option<Self> {
        if let Some(name) = link.strip_prefix("#/components/securitySchemes/") {
            match &api.components {
                Some(components) => match components.security_schemes.get(name) {
                    Some(ReferenceOr::Reference { reference }) => Self::resolve(api, reference),
                    Some(ReferenceOr::Item(item)) => Some(item),
                    None => None,
                },
                None => None,
            }
        } else {
            None
        }
    }
}

impl<'a> RefResolve<'a> for &'a RequestBody {
    fn resolve(api: &'a OpenAPI, link: &'a str) -> Option<Self> {
        if let Some(name) = link.strip_prefix("#/components/requestBodies/") {
            match &api.components {
                Some(components) => match components.request_bodies.get(name) {
                    Some(ReferenceOr::Reference { reference }) => Self::resolve(api, reference),
                    Some(ReferenceOr::Item(item)) => Some(item),
                    None => None,
                },
                None => None,
            }
        } else {
            None
        }
    }
}

impl<'a> RefResolve<'a> for &'a Header {
    fn resolve(api: &'a OpenAPI, link: &'a str) -> Option<Self> {
        if let Some(name) = link.strip_prefix("#/components/headers/") {
            match &api.components {
                Some(components) => match components.headers.get(name) {
                    Some(ReferenceOr::Reference { reference }) => Self::resolve(api, reference),
                    Some(ReferenceOr::Item(item)) => Some(item),
                    None => None,
                },
                None => None,
            }
        } else {
            None
        }
    }
}

impl<'a> RefResolve<'a> for &'a Schema {
    fn resolve(api: &'a OpenAPI, link: &'a str) -> Option<Self> {
        if let Some(name) = link.strip_prefix("#/components/schemas/") {
            match &api.components {
                Some(components) => match components.schemas.get(name) {
                    Some(ReferenceOr::Reference { reference }) => Self::resolve(api, reference),
                    Some(ReferenceOr::Item(item)) => Some(item),
                    None => None,
                },
                None => None,
            }
        } else {
            None
        }
    }
}

impl<'a> RefResolve<'a> for &'a PathItem {
    fn resolve(api: &'a OpenAPI, link: &'a str) -> Option<Self> {
        if let Some(name) = link.strip_prefix("#/paths/") {
            match api.paths.get(name) {
                Some(ReferenceOr::Reference { reference }) => Self::resolve(api, reference),
                Some(ReferenceOr::Item(item)) => Some(item),
                None => None,
            }
        } else {
            None
        }
    }
}