Are there any generators that support OpenAPI 3?

Question

At the time of writing this the OpenAPI 3 spec is relatively new. I am struggling to find any documentation generators that support version 3.0.

Does anyone know of generators that support OpenAPI v3.0?

Answer 1

You can try OpenAPI Generator (https://openapi-generator.tech), which supports both OpenAPI spec v2, v3 and released a stable version (3.0.0) a few days ago.

Using docker, you can easily generate the API documentation:

docker run --rm -v ${PWD}:/local openapitools/openapi-generator-cli generate \
    -i https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/2_0/petstore.yaml \
    -g html2 \
    -o /local/out/html2

Answer 2

You will find a curated list of tools and libraries in the OAI Implementations document found at GitHub.

Answer 3

A bit late to the party, I found it very useful for node.js express projects

oas-generator for Open API 3.0 spec: Link

Answer 4

A couple of new developments to add:

• RepreZen API Studio now supports OpenAPI-Generator, referenced above by William. (Note: I work for RepreZen.)
• OpenAPI.Tools is another great resource for OpenAPI v3-compatible editors, generators, doc formats, and other tools.