swagger-api / swagger-api/swagger-codegen
Node.js generator implementation with OpenAPI 3.0 support
Nobody has claimed this yet.
- Dominant language
- Mustache
- Stars
- 17.8k
- Forks
- 6k
- PR merge metrics
- No merged PRs in 30d
Description
Description
In the absence of official support for OpenAPI 3.0 so far, I have put together a Node.js implementation of the generator engine, using the swagger-codegen templates. It supports OpenAPI 3.0 natively, and Swagger 1.2 and 2.0 by converting the definition internally. It is a 'clean-room' re-implementation rather than a port of the Java source. It is Apache-2.0 licensed, has Docker support and work to build it for the browser has started.
It is configuration-file driven, and help would be appreciated in creating config files for languages where they do not yet exist, and especially testing the generated code. Issues should be raised on the openapi-codegen repository.
Related issues/PRs
#6598 #4669 #6517 #4981 #3948 #6332 #6386
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the linked openapi-codegen implementation and its configuration files; this issue says that support is implemented outside swagger-codegen. Review which language configurations are missing and test the generated code for any language you choose. Raise follow-up issues on the openapi-codegen repository, as requested.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- node.js, openapi
- Domain
- api, tooling
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 20/100