axum-swagger-ui 0.2.3

A simple swagger ui integration for axum
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

use axum::{response::Html, routing::get, Extension, Router};

const OAUTH_RECEIVER_HTML: &str = include_str!("oauth-receiver.html");
const INDEX_STYLE: &str = include_str!("index.css");
const SWAGGER_UI_TEMPLATE: &str = r#"
<!-- HTML for static distribution bundle build -->
<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8">
    <title>Swagger UI</title>
    <link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/swagger-ui/4.14.1/swagger-ui.min.css" />
    <style charset="UTF-8">{:index_style}</style>

    <script src="https://cdnjs.cloudflare.com/ajax/libs/swagger-ui/4.14.1/swagger-ui-bundle.min.js" integrity="sha512-mcnqgXGqnz02yD/AAjn/4bxoXzbDiJ2o7CJ9VD/l2J9OIH/4EHjWRyeGyxXWbcCDNBonOo38wcKle473zo48DA==" crossorigin="anonymous" referrerpolicy="no-referrer"></script>
    <script src="https://cdnjs.cloudflare.com/ajax/libs/swagger-ui/4.14.1/swagger-ui-standalone-preset.min.js" integrity="sha512-KcIoqg6XREcrU/cNEm5Ovh2DbxQ4R1IkvIQOf4mtbbQmI3Oyb35KIaDfv5a0Blx73ogz0cu4cmHCWv36M2A3nw==" crossorigin="anonymous" referrerpolicy="no-referrer"></script>
    </head>

  <body>
    <div id="swagger-ui"></div>
    <script>
        fetch("{:spec_url}").then(response => {
            if (!response.ok) {
                throw new Error(`Failed to retrieve spec! Status: ${response.status}`);
            }
            return response.json();
        })
        .then(spec => {
            let oauth2RedirectUrl;

            let query = window.location.href.indexOf("?");
            if (query > 0) {
                oauth2RedirectUrl = window.location.href.substring(0, query);
            } else {
                oauth2RedirectUrl = window.location.href;
            }

            if (!oauth2RedirectUrl.endsWith("/")) {
                oauth2RedirectUrl += "/";
            }
            oauth2RedirectUrl += "oauth-receiver.html";

            SwaggerUIBundle({
                dom_id: '#swagger-ui',
                spec: spec,
                filter: false,
                oauth2RedirectUrl: oauth2RedirectUrl,
            })
        });
    </script>
  </body>
</html>
"#;

pub struct SwaggerUi;

impl SwaggerUi {
    pub fn setup(spec_url: &'static str) -> Router {
        Router::new()
            .route("/", get(index))
            .route("/oauth-receiver.html", get(oauth_receiver))
            .layer(Extension(spec_url))
    }
}

async fn index(Extension(spec_url): Extension<&'static str>) -> Html<String> {
    let html = SWAGGER_UI_TEMPLATE
        .replace("{:index_style}", INDEX_STYLE)
        .replace("{:spec_url}", spec_url);
    Html(html)
}

async fn oauth_receiver() -> Html<&'static str> {
    Html(OAUTH_RECEIVER_HTML)
}