swagger-codegen icon indicating copy to clipboard operation
swagger-codegen copied to clipboard

What is the difference between this project/repo and github.com/OpenAPITools/openapi-generator ?

Open veqryn opened this issue 1 year ago • 2 comments

Description

I have been trying out all the open api generators for Golang that I can find, and I noticed that the client sdk created by this project (swagger-codegen) is basically identical to the client sdk created by OpenAPITools/openapi-generator There was a slight different in the names of a few functions. And the golang code created by swagger-codegen would not compile because it forgot to generate one of the models it needed. But other than, it was basically identical.

Is one of the projects a fork of the other? Are both under active development?

Swagger-codegen version

3.0.61

Swagger declaration file content or url

https://github.com/veqryn/awesome-go-api/blob/main/openapiv3/openapi_v3.0.3.yaml

Command line used for generation

swagger-codegen-cli generate -i openapi_v3.0.3.yaml -l go -o ./swagger_codegen/go/gen/

Steps to reproduce

Swagger Golang Client: https://github.com/veqryn/awesome-go-api/blob/main/openapiv3/swagger_codegen/go/main.go (ModelMap was never generated, though it is referenced by the generated ModelError struct)

OpenAPITools Golang Client: https://github.com/veqryn/awesome-go-api/blob/main/openapiv3/openapi_generator/go/client/main.go

Suggest a fix/enhancement

Clarify the difference between the projects. (and fix the bug)

veqryn avatar Sep 14 '24 06:09 veqryn

cf OpenAPITools/openapi-generator/README.md section "6.3 - History of OpenAPI Generator") :

OpenAPI Generator is a fork of Swagger Codegen. In view of the issues with the Swagger Codegen 3.0.0 (beta) release and the disagreement on the project's direction, more than 40 top contributors and template creators of Swagger Codegen decided to fork Swagger Codegen and maintain a community-driven version called "OpenAPI Generator". Please refer to the Q&A for more information.

So https://github.com/OpenAPITools/openapi-generator has been forked from https://github.com/swagger-api/swagger-codegen/ .

Lenormju avatar Oct 08 '24 10:10 Lenormju

Yup, OpenAPI Generator is a fork and both projects are active and have varying support for the different languages. The underlying parser/core is the same but the glue code and templates may differ. Will keep this ticket open for the Go-lang issue you've spotted @veqryn

ponelat avatar Oct 18 '24 12:10 ponelat