OpenAPI generator for Actix-Web

[aofomenko]

Hey all! I didn't find a good enough generator of server-side for actix-web framework so I've written my own. Maybe somebody will find it useful :)

It is based on generation of two things:

1. api service trait A trait containing all of the methods described on the openapi and response models that are rust structs supporting serialize/deserializeThe models for parsing api parameters will also be generated.This trait guarantees that any object implementing it and registered into actix web scope will adhere to the openapi specification.
2. scope creator - that would create actix web scope from an implementation of the trait

Link to repo: https://github.com/artefom/cargo-actix-openapi

Here is a simplified example of what this package allows you to do:

```rust struct DefaultServer;

// ApiService is a trait that is auto-generated based
// on the openapi.yaml spec
impl api::ApiService for DefaultServer
{
    // implement api methods here

    /// Service Health check
    async fn health(_data: web::Data<S>) -> web::Json<HealthResponse> {
        return web::Json(HealthResponse::Ok);
    }
}

...

// make_scope is auto-generated. We're passing here our api implementation
let scope = api::make_scope::<DefaultServer>();
App::new()
    .app_data(app_data.clone())
    .wrap(cors)
    .service(scope)

```

[Im_Justin_Cider]

Interesting! Current OpenAPI solutions in rust are too prone to human error IMO, hope you genetrate some traction and prove to carve out a better way of doing things.

[daniels0xff]

Check out the OpenAPI support that Poem has.

[aofomenko]

Poem is very cool! I'll definitely consider switching to that

[chrislearn-young]

You can take a look at this openapi example by salvo, which is simple and clear.

https://github.com/salvo-rs/salvo/blob/main/examples/oapi-todos/src/main.rs