<div align="center">
# Orator
**Server stub generation from OpenAPI 3.1 specs.**
[](https://github.com/Validus-Risk-Management/hotfix/actions/workflows/ci.yml)
[](https://codecov.io/github/davidsteiner/orator)
[![crates-badge]](https://crates.io/crates/orator)
[![docs-badge]](https://docs.rs/orator)
[](LICENSE)
[](https://github.com/davidsteiner/orator)
[Documentation](https://davidsteiner.github.io/orator/)
</div>
> [!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