Struct Asset 

pub struct Asset;

used with swagger openapi eg: I have a swagger.json at path swagger-files/api.json, so I can start a http service for generate swagger

use awesome_operates::embed::{server_dir, EXTRACT_DIR_PATH};
use awesome_operates::swagger::InitSwagger;
use axum::{Router, Extension, routing::get, Json, response::{Response, IntoResponse}};
use tower::ServiceBuilder;
use tower_http::compression::CompressionLayer;
use aide::openapi::OpenApi;
use aide::transform::TransformOpenApi;
use std::sync::Arc;

async fn serve_docs(Extension(api): Extension<Arc<OpenApi>>) -> Response {
    Json(serde_json::json!(*api)).into_response()
}

fn api_docs(api: TransformOpenApi) -> TransformOpenApi {
    api.title("数据采集")
}

#[tokio::test]
async fn server() -> anyhow::Result<()> {
    aide::gen::on_error(|error| {
        println!("{error}")
    });
    aide::gen::extract_schemas(true);
    let mut api = OpenApi::default();

    awesome_operates::extract_all_files!(awesome_operates::embed::Asset);
    InitSwagger::new(EXTRACT_DIR_PATH, "swagger-init.js", "swagger.html", "../api.json").build().await.unwrap();
    let app = Router::new()
        // .api_route("/example", post_with(handlers::example, handlers::example_docs))
        .nest_service("/docs/", server_dir(EXTRACT_DIR_PATH).await.unwrap())
        .route("/api.json", get(serve_docs))
        .finish_api_with(&mut api, api_docs)
        .layer(ServiceBuilder::new()
                .layer(CompressionLayer::new())
                .layer(Extension(Arc::new(api))));

    let listener = tokio::net::TcpListener::bind("0.0.0.0:3000").await.unwrap();
    Ok(())
 }

finally, you can visit at browser at http://127.0.0.1:3000/docs/ for your swagger

Implementations

impl Asset

pub fn get(file_path: &str) -> Option<EmbeddedFile>

Get an embedded file and its metadata.

pub fn iter() -> impl Iterator<Item = Cow<'static, str>>

Iterates over the file paths in the folder.

Trait Implementations

impl RustEmbed for Asset

fn get(file_path: &str) -> Option<EmbeddedFile>

Get an embedded file and its metadata.

fn iter() -> Filenames

Iterates over the file paths in the folder.