http-rs / http-rs/tide

Generating Swagger from Tide

Open
#101 13 comments 26 reactions 0 assignees View on GitHub
feature
Dominant language
Rust
Stars
5.1k
Forks
329
PR merge metrics
No merged PRs in 30d

Description

I'm a big fan of whats happening in Tide and the overall approach. Many web server frameworks in other languages allow for extensions that produce swagger output. The swagger output enables use of swagger tools which can codegen interactive documentation and clients in many popular programming languages.

While Tide is in an active design phase, I'm curious about the possibility of generating swagger output. Given the current thoughts on routes and extractors, would it be possible to generate swagger output from a server built atop Tide at compile time? Could this be accomplished as ergonomically as `#[derive(Swagger)]`? Would this have to a procedural macro?

I'd love to hear if swagger support is something Tide would like to someday support.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.