Are there any generators that support OpenAPI 3?
Asked Answered
R

4

11

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?

Refrigerant answered 19/9, 2017 at 2:39 Comment(1)
Known 3.0-compatible tools are listed in IMPLEMENTATIONS.md.Arctogaea
U
11

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
Une answered 5/6, 2018 at 15:54 Comment(1)
@Refrigerant I would advice you to consider this more recent answerLuisluisa
A
3

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

Altarpiece answered 3/12, 2017 at 21:5 Comment(3)
Link only answers are discouraged. Please consider listing some here in your post.Lovmilla
Thanks for the input. I'm new to contributing to Stack Overflow. Have used it for many years as a consumer, though.Altarpiece
Helen's answer to the question is correct, but it appears as a comment and not an answer per se. My earlier post only duplicates Helen's response as an answer. Nothing more.Altarpiece
U
1

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.
Unanswerable answered 21/7, 2018 at 17:29 Comment(0)
S
0

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

Seed answered 3/1, 2019 at 9:36 Comment(0)

© 2022 - 2024 — McMap. All rights reserved.