swagger-api / swagger-api/swagger-codegen

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

Open
#12,467 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Issue: Bug P2 pull-request-welcome
Dominant language
Mustache
Stars
17.8k
Forks
6k
PR merge metrics
No merged PRs in 30d

Description

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)

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by running the supplied swagger-codegen-cli command against openapi_v3.0.3.yaml and compare its Go output with the linked OpenAPITools output. Inspect the generated main.go files and the referenced ModelError and ModelMap types; done means explaining the project relationship and correcting the missing model generation without breaking the generated client.

Written by the indexing model from the issue text.

Assessment

Tech stack
go, openapi
Domain
documentation, tooling
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.