oapi-codegen vs OpenAPI Generator
oapi-codegen
github.com
OpenAPI Generator
openapi-generator.techSide by side
| Figure | oapi-codegen | OpenAPI Generator |
|---|---|---|
| Price from | Free | Free |
| Free plan | Yes | Yes |
| Free trial | — | — |
| Open source | — | — |
| Web | — | Yes |
| Windows | — | Yes |
| macOS | — | Yes |
| Linux | Yes | Yes |
| Self-hosted | Yes | Yes |
| Plans published | 1 | 1 |
| Spec score · API Generation Software | 7.5 (#12) | 7.7 (#11) |
| Spec score · Code Generators | 7.5 (#24) | 7.8 (#21) |
| Customization | Generated Go templates can be overridden, and supported OpenAPI extensions can customize generated types, names, JSON behavior, and struct tags. | Users can replace templates with Mustache templates, provide additional files and extensions through configuration, or create custom generators. |
| Integrations | It can be installed as a Go tool or binary and used with go:generate; the project also documents Renovate for updating a pinned configuration schema. | The project documents Gradle, Maven, sbt, Bazel, GitHub, and CI/CD integrations; Cake is a third-party add-in. |
| Purpose | oapi-codegen is a command-line tool and library that converts OpenAPI specifications into Go server implementations, API clients, and HTTP models. | Generates clients, servers, and documentation from OpenAPI 2.0 and 3.x documents. |
Plans
In their own words
oapi-codegen
oapi-codegen has no write-up on Specifiction yet; its figures are above.
OpenAPI Generator
OpenAPI Generator produces API clients, server stubs, and documentation from OpenAPI 2.0 and 3.x documents. It offers more than 50 client generators and server stub generation for over 40 languages and technologies, including Java, Kotlin, Go, and PHP. Other outputs include Apache2 configuration, MySQL, GraphQL schemas, and formats such as HTML and Cwiki. It can also convert OpenAPI 2.0 documents into OpenAPI 3.x JSON or YAML. Generated output can be adapted with Mustache templates, configuration-provided files and extensions, or custom generators. Installation choices include npm, Homebrew, Scoop, PyPI, Docker, JAR, JBang, and a Bash launcher. The project documents Gradle, Maven, sbt, Bazel, GitHub, and CI/CD integrations. Supported operating systems include Linux, macOS, and Windows, though installer availability varies by system. The JAR option requires Java 11 or later. The project is free and describes a Slack community for questions and guidance.