openapi-eller
Generate OpenAPI v3 clients and servers from the command line
Last updated 8 days ago by zbrox .
ISC · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install openapi-eller 
SYNC missed versions from official npm registry.

Eller logo

Build Status

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
    • TypeScript
  • Servers:

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.

Current Tags

  • 0.3.4                                ...           latest (8 days ago)

9 Versions

  • 0.3.4                                ...           8 days ago
  • 0.3.3                                ...           9 months ago
  • 0.3.1                                ...           a year ago
  • 0.3.0                                ...           a year ago
  • 0.2.3                                ...           a year ago
  • 0.2.2                                ...           2 years ago
  • 0.2.1                                ...           2 years ago
  • 0.2.0                                ...           2 years ago
  • 0.1.0                                ...           2 years ago
Downloads
Today 0
This Week 0
This Month 15
Last Day 0
Last Week 15
Last Month 2
Dependencies (10)
Dependents (0)
None

Copyright 2014 - 2016 © taobao.org |