rust-template-foundation 0.1.0

Shared infrastructure for projects spawned from rust-template.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

//! OpenAPI spec and Scalar UI route builder.

use aide::{openapi::OpenApi, scalar::Scalar};
use axum::{routing::get, Json, Router};
use std::sync::Arc;

/// Build routes that serve the OpenAPI JSON spec and the Scalar interactive
/// documentation UI.
pub fn openapi_routes(api: Arc<OpenApi>, title: &str) -> Router {
  let scalar_handler = Scalar::new("/api-docs/openapi.json")
    .with_title(title)
    .axum_handler();

  Router::new()
    .route(
      "/api-docs/openapi.json",
      get({
        let api = api.clone();
        move || async move { Json((*api).clone()) }
      }),
    )
    .route("/scalar", get(scalar_handler))
}