openapi-eller
v0.3.8
Published
Generate OpenAPI v3 clients and servers from the command line
Downloads
18
Readme
OpenAPI Generator, eller?
Generate OpenAPI v3 clients and servers from the command line with nothing more than Node.js.
Just run:
npm i -g openapi-eller
See openapi-eller --help
for usage details.
Looking for an easy way to generate a mock server from an OpenAPI v3 spec? We've got you covered.
Try openapi-mock-eller today!
PLEASE NOTE: This codebase is still a work-in-progress, but it does produce production-grade code for those targets listed as supported. Behaviour is subject to change between variants until 1.0.0.
Features
- Supports* the full OpenAPI v3 specification
- Uses an interceptor pattern for handling security schemas in clients
- OAuth 2 clients comply with RFC6749 and RFC6750 (Bearer Token Usage)
- Targets can be configured with a JSON or YAML file for simple, reproducable generations
- Easily extensible Handlebars templates for core structure of files, with TypeScript target-specific code for handling with pointy bits
Supported targets
- Clients:
- Kotlin (Android)
- Swift (iOS)
- TypeScript
- Servers:
- ASP.NET (MVC Framework 4.5)
There are other targets in the tree, though they are a work-in-progress.
Roadmap to 0.4
- [ ] Generating platform-conformant API documentation
- [ ] Handle returning headers, status codes and raw response objects where necessary
- [ ] Handle mandatory configuration for targets
- [ ] Generate documentation for target configuration
Users
- The Techno Creatives
Contributing
We happily accept contributions! We simply ask that you please make sure that any dependencies of your targets use a permissive license compatible with the ISC license (which means no AGPL or GPL dependencies, unfortunately.)
If you're unsure, open an issue and we can help you out!
License
ISC license - see LICENSE file.
Any code outputted by this generator is the license of your choice.