Best method to split openapi into multiple files

[Christoph-AK]

Hey there,
I want to migrate a project with multiple endpoints to poem_openapi.

In actix I could define all my functions and structs in their own modules and call server.get("/ep1", mod1::fn1).post("/ep2", mod2::fn1) and so on. This makes for a nice, tidy main and structured modules.

If I understand correctly in poem every endpoint definition needs to be in the same file in the same impl block.

Of cause I could treat every function as a wrapper, so for example

#[oai(path = "/test", method = "get")]
async fn test(&self, auth: authmod::struct1) -> PlainText<mod1::struct2> {
    mod1::test(&self, auth)
}

#[oai(path = "/test2", method = "get")]
async fn test2(&self, auth: authmod::struct1) -> PlainText<mod2::struct1> {
    mod2::test(&self, auth)
}

but that is quite a handfull to maintain too.

Is there maybe a way to glue multiple API-definitions into one?

[sunli829]

use the combine method to merge multiple OpenAPIs into one.

poem/examples/openapi/combined-apis/src/main.rs

Line 41 in da103be

let api_service = OpenApiService::new(Api1.combine(Api2).combine(Api3), "Combined APIs", "1.0")

[Christoph-AK]

Thank you! I seem to be absolutely blind today.

[invokermain]

The answer is outdated, nowadays OpenApiSerivce::new can be passed a tuple to combine multiple API objects.