...

use utoipauto::utoipauto;

...
#[utoipauto]
#[derive(OpenApi)]
#[openapi(
    tags(
        (name = "todo", description = "Todo management endpoints.")
    ),
    modifiers(&SecurityAddon)
)]

pub struct ApiDoc;

...

从模块导入

以下是添加其余模块中所有方法和结构的示例。

use utoipauto::utoipauto;

#[utoipauto(
  paths = "./src/rest"
  )]
#[derive(OpenApi)]
#[openapi(
    tags(
        (name = "todo", description = "Todo management endpoints.")
    ),
    modifiers(&SecurityAddon)
)]

pub struct ApiDoc;

以下是添加位于子文件夹中的其余模块中所有方法和结构的示例

use utoipauto::utoipauto;

#[utoipauto(
  paths = "(./src/lib/rest from crate::rest)"
  )]
#[derive(OpenApi)]
#[openapi(
    tags(
        (name = "todo", description = "Todo management endpoints.")
    ),
    modifiers(&SecurityAddon)
)]

pub struct ApiDoc;

从文件名导入

以下是添加 test_controller 和 test2_controller 模块中所有方法的示例。您也可以将自动添加和手动添加相结合，如在这里，我们手动将方法添加到文档 "other_controller::get_users" 和模式 "TestDTO" 中。

use utoipauto::utoipauto;

#[utoipauto(
  paths = "./src/rest/test_controller.rs,./src/rest/test2_controller.rs "
  )]
#[derive(OpenApi)]
#[openapi(
    paths(

        crate::rest::other_controller::get_users,
    ),
    components(
        schemas(TestDTO)
    ),
    tags(
        (name = "todo", description = "Todo management endpoints.")
    ),
    modifiers(&SecurityAddon)
)]

pub struct ApiDoc;

排除方法自动扫描

您可以通过添加以下宏 #[utoipa_ignore] 从 Doc Path 列表排除一个函数。

示例

    /// Get all pets from database
    ///
    #[utoipa_ignore]  //<============== this Macro
    #[utoipa::path(
        responses(
            (status = 200, description = "List all Pets", body = [ListPetsDTO])
        )
    )]
    #[get("/pets")]
    async fn get_all_pets(req: HttpRequest, store: web::Data<AppState>) -> impl Responder {
        // your CODE
    }

从自动扫描中排除一个结构体

您也可以通过添加以下宏 #[utoipa_ignore] 从模型和响应列表中排除一个结构体。

示例

    #[utoipa_ignore]  //<============== this Macro
    #[derive(ToSchema)]
    struct ModelToIgnore {
        // your CODE
    }

自定义路径检测

默认情况下，此宏将查找具有 #[utoipa::path(...)] 属性的函数，但您也可以指定要查找的自定义属性。

#[handler]
pub fn custom_router() {
    // ...
}

#[utoipauto(function_attribute_name = "handler")] //Custom attribute
#[derive(OpenApi)]
#[openapi(tags()))]
pub struct ApiDoc;

您还可以为模型和响应检测指定自定义属性。

#[derive(Schema, Response)]
pub struct CustomModel {
    // ...
}

#[utoipauto(schema_attribute_name = "Schema", response_attribute_name = "Response")] //Custom derive
#[derive(OpenApi)]
#[openapi(tags())]
pub struct ApiDoc;

注意

包含带有 utoipa::path 标签的方法的子模块也会自动检测。

贡献

欢迎贡献，请随意提交 PR 或问题。

灵感

灵感来源于 utoipa_auto_discovery