Open API 3

[Jean-Baptiste-Lasselle]

I won't use the well known go-swagger, because it lacks open api 3, apparently, and :

• I need code generation, from swagger file, and vice versa
• and I need documentation generation

see https://github.com/deepmap/oapi-codegen, and do that on feature/swagger branch

also try to compare, https://github.com/Azure/autorest

[Jean-Baptiste-Lasselle]

on worst case I can generate a first swagger using https://editor.swagger.io/

[Jean-Baptiste-Lasselle]

ok, here is a simple way to generate my open-api.yaml Open API Spec v3 :

A small version of apicurio : https://github.com/Apicurio/apicurito

Ok, this one I could make it work in standalone mode :

git clone git clone https://github.com/Apicurio/apicurito ~/apicurito

yarn && npm i -g @angular/cli && npm i

cd ui/

yarn && npm i && ng serve

• then with the yaml spec, we have to generate the source code : https://github.com/deepmap/oapi-codegen - Generate Go server boilerplate from an OpenAPI 3 spec

• see also https://github.com/go-openapi

• see also some projects that depend on kin-openapi , and pick those of interest for tests :

• https://github.com/getkin/kin - "A configurable backend"

• https://github.com/danielgtaylor/apisprout - "Lightweight, blazing fast, cross-platform OpenAPI 3 mock server with validation"

• https://github.com/deepmap/oapi-codegen - Generate Go server boilerplate from an OpenAPI 3 spec

• https://github.com/dunglas/vulcain - "Use HTTP/2 Server Push to create fast and idiomatic client-driven REST APIs"

• https://github.com/danielgtaylor/restish - "...a CLI for interacting with REST-ish HTTP APIs with some nice features built-in" (Feel free to add your project by creating an issue or a pull request)