https://github.com/davidsteiner/orator

Rust server stub generation from OpenAPI 3.1 specs
https://github.com/davidsteiner/orator

axum codegen openapi openapi3 rust

Last synced: 3 months ago
JSON representation

Rust server stub generation from OpenAPI 3.1 specs

• Host: GitHub
• URL: https://github.com/davidsteiner/orator
• Owner: davidsteiner
• License: mit
• Created: 2026-03-03T20:15:17.000Z (4 months ago)
• Default Branch: main
• Last Pushed: 2026-03-23T19:31:08.000Z (3 months ago)
• Last Synced: 2026-04-02T02:40:50.746Z (3 months ago)
• Topics: axum, codegen, openapi, openapi3, rust
• Language: Rust
• Homepage: https://davidsteiner.github.io/orator/
• Size: 2.81 MB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 14
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          


# Orator

**Server stub generation from OpenAPI 3.1 specs.**

[![CI](https://github.com/davidsteiner/orator/actions/workflows/ci.yml/badge.svg)](https://github.com/Validus-Risk-Management/hotfix/actions/workflows/ci.yml)

[![codecov](https://codecov.io/github/davidsteiner/orator/graph/badge.svg?token=GM4T49SSDO)](https://codecov.io/github/davidsteiner/orator)

[![crates-badge]](https://crates.io/crates/orator)

[![docs-badge]](https://docs.rs/orator)

[![Crates.io](https://img.shields.io/crates/l/orator)](LICENSE)

[![status](https://img.shields.io/badge/status-experimental-orange)](https://github.com/davidsteiner/orator)

[Documentation](https://davidsteiner.github.io/orator/)



> [!WARNING]

> This is work in progress — do not use it in production yet.

## Examples

The best way to get a feel for what the crate is capable of

is looking at the tennis club example in `examples/`.

Please refer to the example's README for more detail.

## Features & status

- [x] Code generation of schemas for requests and responses

    - [x] String enums

    - [x] Complex types involving `allOf`, `anyOf` and `oneOf`

    - [x] Optional properties mapped to `Option`

- [x] Code generation for operations

    - [x] Per-tag traits

    - [x] Generic context propagation to handlers for flexibility

- [x] Axum router generation

- [x] Parameter extraction

    - [x] Path parameters

    - [x] Query parameters

    - [x] Headers

    - [x] Cookie parameter support

- [x] CLI tool for explicit code generation into your project

- [x] Default response handling

- [ ] Support for security schemes

- [ ] Support for webhooks

[crates-badge]: https://img.shields.io/crates/v/orator.svg

[docs-badge]: https://docs.rs/orator/badge.svg