predawn 0.9.0

Predawn is a Rust web framework like Spring Boot.
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
135
136
137

use std::sync::Arc;

use http::Method;
use indexmap::IndexMap;
use rudi::{Context, Singleton};

use crate::{config::Config, handler::DynHandler, normalized_path::NormalizedPath, plugin::Plugin};

const TEMPLATE: &str = r###"
<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <meta name="description" content="{{description}}" />
    <title>{{title}}</title>
    <link rel="stylesheet" href="{{css_url}}" />
  </head>
  <body>
    <div id="swagger-ui"></div>
    <script src="{{bundle_js_url}}" crossorigin></script>
    <script src="{{standalone_preset_url}}" crossorigin></script>
    <script>
      window.onload = () => {
        window.ui = SwaggerUIBundle({
          url: "{{spec_url}}",
          dom_id: "#swagger-ui",
          presets: [SwaggerUIBundle.presets.apis, SwaggerUIStandalonePreset],
          layout: "StandaloneLayout",
        });
      };
    </script>
  </body>
</html>
"###;

#[derive(Debug, Clone)]
pub struct SwaggerUI {
    description: Box<str>,
    title: Box<str>,
    css_url: Box<str>,
    bundle_js_url: Box<str>,
    standalone_preset_url: Box<str>,
    spec_url: Box<str>,
}

impl Plugin for SwaggerUI {
    fn create_route(
        self: Arc<Self>,
        cx: &mut Context,
    ) -> (NormalizedPath, IndexMap<Method, DynHandler>) {
        super::create_route(cx, |c| c.swagger_ui_path, self.as_html())
    }
}

fn condition(cx: &Context) -> bool {
    !cx.contains_provider::<SwaggerUI>()
}

#[Singleton(condition = condition)]
fn SwaggerUIRegister(#[di(ref)] cfg: &Config) -> SwaggerUI {
    let json_path = super::json_path(cfg).into_inner();
    SwaggerUI::new(json_path)
}

#[Singleton(name = std::any::type_name::<SwaggerUI>())]
fn SwaggerUIToPlugin(ui: SwaggerUI) -> Arc<dyn Plugin> {
    Arc::new(ui)
}

impl SwaggerUI {
    pub fn new<T>(spec_url: T) -> Self
    where
        T: Into<Box<str>>,
    {
        Self {
            description: Box::from("SwaggerUI"),
            title: Box::from("SwaggerUI"),
            css_url: Box::from("https://unpkg.com/swagger-ui-dist/swagger-ui.css"),
            bundle_js_url: Box::from("https://unpkg.com/swagger-ui-dist/swagger-ui-bundle.js"),
            standalone_preset_url: Box::from(
                "https://unpkg.com/swagger-ui-dist/swagger-ui-standalone-preset.js",
            ),
            spec_url: spec_url.into(),
        }
    }

    pub fn description<T>(mut self, description: T) -> Self
    where
        T: Into<Box<str>>,
    {
        self.description = description.into();
        self
    }

    pub fn title<T>(mut self, title: T) -> Self
    where
        T: Into<Box<str>>,
    {
        self.title = title.into();
        self
    }

    pub fn css_url<T>(mut self, css_url: T) -> Self
    where
        T: Into<Box<str>>,
    {
        self.css_url = css_url.into();
        self
    }

    pub fn bundle_js_url<T>(mut self, bundle_js_url: T) -> Self
    where
        T: Into<Box<str>>,
    {
        self.bundle_js_url = bundle_js_url.into();
        self
    }

    pub fn standalone_preset_url<T>(mut self, standalone_preset_url: T) -> Self
    where
        T: Into<Box<str>>,
    {
        self.standalone_preset_url = standalone_preset_url.into();
        self
    }

    pub fn as_html(&self) -> String {
        TEMPLATE
            .replacen("{{description}}", &self.description, 1)
            .replacen("{{title}}", &self.title, 1)
            .replacen("{{css_url}}", &self.css_url, 1)
            .replacen("{{bundle_js_url}}", &self.bundle_js_url, 1)
            .replacen("{{standalone_preset_url}}", &self.standalone_preset_url, 1)
            .replacen("{{spec_url}}", &self.spec_url, 1)
    }
}