rust-codegen-group/openapi-nexus
rust-codegen-group/openapi-nexus has 92 GitHub stars and 0 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-15 22:08 UTC. Last push 2026-11-13.
Measured star growth
- in 24h
- 0
- in 7 days
- Collecting history
- in 15 days
- Collecting history
- in 1 month
- Collecting history
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
OpenAPI 3.x code generator for deterministic, type-safe SDKs and API tooling across languages and runtimes.
Developer ToolsREADME.md
OriginalOpenAPI Nexus
OpenAPI 3.0 / 3.1 / 3.2 to multi-language code generator
OpenAPI Nexus transforms OpenAPI specifications into type-safe client libraries. Generated output is deterministic, compile-checked in CI, and tested byte-for-byte via golden tests.
Language Support
| Language | Generator | HTTP Client | Status |
|---|---|---|---|
| TypeScript | typescript-fetch |
fetch | Beta |
| Go | go-http |
net/http | Beta |
| Rust | rust-reqwest |
reqwest | Beta |
| Rust | rust-ureq |
ureq | Beta |
| Rust | rust-aioduct |
aioduct | Beta |
| Python | python-httpx |
httpx | Beta |
| Python | python-requests |
requests | Beta |
| Java | java-okhttp |
OkHttp | Beta |
| Kotlin | kotlin-okhttp |
OkHttp | Beta |
Quick Start
Install
Shell installer (no Rust toolchain needed):
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/rust-codegen-group/openapi-nexus/releases/download/0.3.0/openapi-nexus-installer.sh | sh
Build from source:
cargo install openapi-nexus
Requires Rust 1.90+.
Generate
# TypeScript client
openapi-nexus generate -i spec.yaml -o output --generators typescript-fetch
# Go client
openapi-nexus generate -i spec.yaml -o output --generators go-http
# Rust client (reqwest)
openapi-nexus generate -i spec.yaml -o output --generators rust-reqwest
# Python client (httpx)
openapi-nexus generate -i spec.yaml -o output --generators python-httpx
# Java client
openapi-nexus generate -i spec.yaml -o output --generators java-okhttp
# Generate another target into its own directory
openapi-nexus generate -i spec.yaml -o output/go --generators go-http
openapi-nexus generate -i spec.yaml -o output/rust --generators rust-reqwest
Configuration
Configuration resolves in order: CLI args > environment variables (OPENAPI_NEXUS_*) > config file (openapi-nexus-config.toml) > defaults.
# Environment variables
export OPENAPI_NEXUS_INPUT="spec.yaml"
export OPENAPI_NEXUS_OUTPUT="generated"
export OPENAPI_NEXUS_GENERATORS="typescript-fetch"
Generator-specific options go in the config file:
[generators.go-http]
module_path = "github.com/myorg/myproject/sdk"
[generators.rust-reqwest]
workspace_mode = true
workspace_deps = "workspace_version"
[generators.rust-reqwest.extra_derives.structs]
derives = ["PartialEq"]
[generators.rust-reqwest.extra_derives.enums]
derives = ["Hash"]
[generators.rust-reqwest.utoipa]
enabled = true
dependency = '{ version = "5" }'
[generators.rust-aioduct.aioduct]
compression = ["gzip", "zstd"]
features = ["tracing"]
[generators.typescript-fetch]
emit_enum_constants = true
emit_type_guards = true
property_naming = "camelCase"
How It Works
OpenAPI YAML/JSON → parse → lower to IR → CodeGenerator::generate(&IrSpec) → write
Parsing auto-detects OAS version (3.0, 3.1, 3.2). Lowering produces a version-agnostic IrSpec. Each generator receives the pre-lowered IR and uses sigil-stitch for type-safe code emission.
Documentation
Full documentation is available at the project docs site.
Examples live under examples/, including multipart file upload and raw binary body usage in examples/multipart-binary.
Development
# Run all tests
cargo test
# Clippy (required before commit)
cargo clippy --all-targets --all-features -- -D warnings
# Update golden files after intentional output changes
UPDATE_GOLDEN=1 cargo test
# Compile-check generated output for all languages
just golden-build-all
License
Dual-licensed under MIT or Apache-2.0 at your option.