utoipa
utoipa copied to clipboard
juhaku
Simple, Fast, Code first and Compile time generated OpenAPI documentation for Rust
 What is the recommended way to add swagger ui to arp framework? If there is any? I tried to use it like that (https://github.com/juhaku/utoipa/blob/6e3cb4b9be5072108e999b982b17ffae117d65ac/examples/todo-axum/src/main.rs#L52) but it is not type...
Hey! It would be really nice to have an escape-hatch for situations where generating a JSON Schema for the type isn't trivial/possible. Is there a way to do that already,...
Adding an example to a stuct field of type Vec results in a incorrect swagger example for the struct. The generated swagger example has a double pair of square brackets....
Given the following path, ``` #[utoipa::path( request_body(content=MyRequest, content_type="application/json"), responses( (status = 200, content_type=["application/json", "application/cbor"], description = "RPC call was successful", body = FindByIdResponse), (status = 400, content_type=["application/json", "application/cbor"], description =...
Say I have the following handler ```rust #[utoipa::path( request_body = request::SomeRequestBody, responses( (status = 200, body = response::SomeResponseBody), ), )] ``` And it is defined like so in the `OpenApiDoc`...
I have this type that occurs in a handler param: ```rs #[derive(Debug, FromForm, Component)] pub struct FilterParams { pub ids: Option, pub archived: Option, #[form(field = "dueDateStart")] pub due_date_start: Option,...
Representations of types/paths which are parsed into schemas are spread throughout `utoipa-gen` and their level of parsing support varies: + https://github.com/juhaku/utoipa/blob/6cec1029f57e3fd81d6b2c7e4680c34e482060e6/utoipa-gen/src/ext.rs#L21 + https://github.com/juhaku/utoipa/blob/6cec1029f57e3fd81d6b2c7e4680c34e482060e6/utoipa-gen/src/ext/rocket.rs#L118 + https://github.com/juhaku/utoipa/blob/6cec1029f57e3fd81d6b2c7e4680c34e482060e6/utoipa-gen/src/ext/rocket.rs#L75 + https://github.com/juhaku/utoipa/blob/6cec1029f57e3fd81d6b2c7e4680c34e482060e6/utoipa-gen/src/lib.rs#L806 which is used...
Currently [adjacently tagged](https://serde.rs/enum-representations.html#adjacently-tagged) enums are not supported in `Component` derive. This behaviour would need following tasks do be done. **Tasks:** - [ ] Experiment adjacently tagged enums support capabilities -...
Hi, is there a simple way to export the generated OpenAPI spec to a file at compile time instead of serving it at runtime? This would fit my use case...
