openapi-nexus 0.1.12

OpenAPI 3.x multi-language code generator
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

use std::sync::Arc;

use crate::runtime::error::Error;

/// Trait for authenticating requests.
pub trait Authenticator<R: aioduct::Runtime>: Send + Sync + std::fmt::Debug {
    /// Apply authentication to the request builder.
    fn authenticate<'a>(
        &self,
        req: aioduct::RequestBuilder<'a, R>,
    ) -> Result<aioduct::RequestBuilder<'a, R>, Error>;
}

/// Bearer token authentication.
///
/// Use [`BearerAuth::new`] with a static token, or
/// [`BearerAuth::from_provider`] with a function that returns the
/// current token (evaluated on every request).
pub struct BearerAuth {
    token: TokenSource,
}

enum TokenSource {
    Static(String),
    Dynamic(Arc<dyn Fn() -> String + Send + Sync>),
}

impl std::fmt::Debug for TokenSource {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        match self {
            Self::Static(t) => f.debug_tuple("Static").field(&t).finish(),
            Self::Dynamic(_) => f.debug_tuple("Dynamic").field(&"<function>").finish(),
        }
    }
}

impl Clone for TokenSource {
    fn clone(&self) -> Self {
        match self {
            Self::Static(t) => Self::Static(t.clone()),
            Self::Dynamic(f) => Self::Dynamic(Arc::clone(f)),
        }
    }
}

impl std::fmt::Debug for BearerAuth {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        f.debug_struct("BearerAuth").field("token", &self.token).finish()
    }
}

impl Clone for BearerAuth {
    fn clone(&self) -> Self {
        Self {
            token: self.token.clone(),
        }
    }
}

impl BearerAuth {
    /// Create a new bearer token authenticator with a static token.
    pub fn new(token: impl Into<String>) -> Self {
        Self {
            token: TokenSource::Static(token.into()),
        }
    }

    /// Create a bearer token authenticator that evaluates the given
    /// function on every request to obtain the current token.
    pub fn from_provider(f: impl Fn() -> String + Send + Sync + 'static) -> Self {
        Self {
            token: TokenSource::Dynamic(Arc::new(f)),
        }
    }
}

impl<R: aioduct::Runtime> Authenticator<R> for BearerAuth {
    fn authenticate<'a>(
        &self,
        req: aioduct::RequestBuilder<'a, R>,
    ) -> Result<aioduct::RequestBuilder<'a, R>, Error> {
        let token = match &self.token {
            TokenSource::Static(t) => t.clone(),
            TokenSource::Dynamic(f) => f(),
        };
        Ok(req.bearer_auth(&token))
    }
}

/// API key authentication.
#[derive(Debug, Clone)]
pub struct ApiKeyAuth {
    header_name: String,
    api_key: String,
}

impl ApiKeyAuth {
    pub fn new(header_name: impl Into<String>, api_key: impl Into<String>) -> Self {
        Self {
            header_name: header_name.into(),
            api_key: api_key.into(),
        }
    }
}

impl<R: aioduct::Runtime> Authenticator<R> for ApiKeyAuth {
    fn authenticate<'a>(
        &self,
        req: aioduct::RequestBuilder<'a, R>,
    ) -> Result<aioduct::RequestBuilder<'a, R>, Error> {
        Ok(req.header_str(&self.header_name, &self.api_key)?)
    }
}