swaggo/swag alternative, but should generate OpenAPI 3.0 spec file

This page summarizes the projects mentioned and recommended in the original post on /r/golang

Our great sponsors
  • InfluxDB - Power Real-Time Data Analytics at Scale
  • WorkOS - The modern identity platform for B2B SaaS
  • SaaSHub - Software Alternatives and Reviews
  • swag

    Automatically generate RESTful API documentation with Swagger 2.0 for Go.

  • I have been using https://github.com/swaggo/swag with https://github.com/swaggo/gin-swagger.

  • gin-swagger

    gin middleware to automatically generate RESTful API documentation with Swagger 2.0.

  • No I use this one https://github.com/swaggo/gin-swagger. It's with swagger 2.0, but I think it can be easily converted to OpenApi 3.0. I tried it once and the only thing it complained about was some simple "metadata" like contact person etc.

  • InfluxDB

    Power Real-Time Data Analytics at Scale. Get real-time insights from all types of time series data with InfluxDB. Ingest, query, and analyze billions of data points in real-time with unbounded cardinality.

    InfluxDB logo
  • goa

    šŸŒŸ Goa: Elevate Go API development! šŸš€ Streamlined design, automatic code generation, and seamless HTTP/gRPC support. āœØ

  • I am using goa.design as is described there https://goa.design/design/overview/ (I am do not use gRPC - only REST).

  • oapi-codegen

    Generate Go client and server boilerplate from OpenAPI 3 specifications

  • Iā€™m personally using this project for open api code generation https://github.com/deepmap/oapi-codegen

  • twirp

    A simple RPC framework with protobuf service definitions

  • We have better experience with https://goa.design/ than with https://github.com/twitchtv/twirp

  • examples

    Examples for goa showing specific capabilities (by goadesign)

  • After the source code is generated, the gen/http directory contains yaml and json files in two versions (openapi, openapi3). Here is an example: https://github.com/goadesign/examples/tree/master/basic/gen/http

  • kin-openapi

    OpenAPI 3.0 (and Swagger v2) implementation for Go (parsing, converting, validation, and more)

  • I recently used https://github.com/getkin/kin-openapi openapi2 and openapi2conv to convert the v2 yaml to v3 yaml.

  • WorkOS

    The modern identity platform for B2B SaaS. The APIs are flexible and easy-to-use, supporting authentication, user identity, and complex enterprise features like SSO and SCIM provisioning.

    WorkOS logo
  • swagger-editor

    Swagger Editor

  • https://editor.swagger.io and select Edit > Convert to OpenAPI 3 from the menu

NOTE: The number of mentions on this list indicates mentions on common posts plus user suggested alternatives. Hence, a higher number means a more popular project.

Suggest a related project

Related posts