49 releases (31 stable)

new 7.0.0-rc1 Dec 10, 2024
6.5.0 May 29, 2024
6.4.1 Sep 5, 2023
6.3.0 Jun 30, 2023
0.7.0 Oct 2, 2017

#29 in HTTP server

Download history 865/week @ 2024-08-22 898/week @ 2024-08-29 1033/week @ 2024-09-05 1064/week @ 2024-09-12 835/week @ 2024-09-19 1014/week @ 2024-09-26 1046/week @ 2024-10-03 749/week @ 2024-10-10 1176/week @ 2024-10-17 819/week @ 2024-10-24 1027/week @ 2024-10-31 582/week @ 2024-11-07 818/week @ 2024-11-14 846/week @ 2024-11-21 937/week @ 2024-11-28 830/week @ 2024-12-05

3,588 downloads per month
Used in 30 crates (25 directly)

Apache-2.0

115KB
2K SLoC

swagger-rs

Build Status crates.io

A set of common utilities for crates generated by the rust-server openapi-generator generator

Releasing a new version

  1. Run ./release-changelog.sh <version> to update the changelog and Cargo.toml
  2. Commit and push your changes.
  3. Wait for a travis build to complete successfully.
  4. Run cargo publish.
  5. Tag the new version and push the tag.

lib.rs:

Support crate for Swagger codegen.

Crate features

Crate features exist to reduce the dependencies on the crate. Most features should be enabled by the generator when relevant.

By default, the serdejson feature is enabled.

Format support

  • multipart_form - Enable support for multipart/form-data as described in RFC 7578
  • multipart_related - Enable support for multipart/related as described in RFC 2387
  • serdejson - Enable JSON serialization/deserialization support using serde.

Feature support

  • serdevalid - Enable support for JSON schema based validation
  • conversion - Enable support for Frunk-based conversion - in particular, transmogrification

Use case support

  • client - Enable support for providing an OpenAPI client
  • server - Enable support for providing an OpenAPI server
  • http1 - Enable support for HTTP/1 based APIs - RFC 9112
  • http2 - Enable support for HTTP/2 based APIs - RFC 9113
  • tls - Enable support for HTTP over TLS (HTTPS)
  • uds - Enable support for HTTP over UDS (Unix Domain Sockets)

Dependencies

~5–18MB
~266K SLoC