https://github.com/technocreatives/openapi-eller
Generate OpenAPI v3 clients and servers from the command line
https://github.com/technocreatives/openapi-eller
openapi openapi-codegen openapi3 swagger
Last synced: 15 days ago
JSON representation
Generate OpenAPI v3 clients and servers from the command line
- Host: GitHub
- URL: https://github.com/technocreatives/openapi-eller
- Owner: technocreatives
- License: isc
- Created: 2018-04-22T14:25:35.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2023-01-23T20:56:08.000Z (about 3 years ago)
- Last Synced: 2025-10-20T08:40:58.486Z (5 months ago)
- Topics: openapi, openapi-codegen, openapi3, swagger
- Language: TypeScript
- Homepage: https://technocreatives.github.io/openapi-eller
- Size: 1.77 MB
- Stars: 20
- Watchers: 6
- Forks: 4
- Open Issues: 22
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/technocreatives/openapi-eller/actions) [](https://www.npmjs.org/package/openapi-eller)
# 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.
- [Documentation](https://technocreatives.github.io/openapi-eller)
---
Looking for an easy way to generate a mock server from an OpenAPI v3 spec? We've got you covered.
Try [openapi-mock-eller](https://github.com/technocreatives/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](https://tools.ietf.org/html/rfc6749) and
[RFC6750](https://tools.ietf.org/html/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.