search

swaggo / swag

Automatically generate RESTful API documentation with Swagger 2.0 for Go.
MIT License
10.14k stars 1.17k forks source link

Question: Will v2 be released? #1766

Open r3st opened 4 months ago

r3st commented 4 months ago

I'm interested to generate openapi 3.x.x specification for api and already tested rc3 of v2 release. Will the v2 released soon?

sdghchj commented 4 months ago

@Nerzal

Nerzal commented 4 months ago

Good question. From my point of view v2 is not yet stable enough and needs some more help to get it going

r3st commented 4 months ago

What is missing to get it stable? Perhaps I can help with some issue.

jvilhuber commented 3 months ago

I'm also interested in openapi v3 (or at least something like the pattern tag). Any chance you can tag some of the issues that the v2 branch still needs so others can help? https://github.com/swaggo/swag/labels/v2 I could probably invest some time..

8thgencore commented 3 months ago

The repository is dying, as for me, it looks promising https://github.com/danielgtaylor/huma

ANDREYDEN commented 3 months ago

As a temporary workaround I'm using swagger-codegen to convert v2 to v3.

For Mac users it looks like this:

brew install swagger-codegen
swagger-codegen generate -l openapi -i ./input-swagger.json -o ./output-directory

Note: you might find that a custom JAVA_HOME declaration will interfere with swagger-codegen (SO question)

alexrjones commented 2 months ago

I'd be keen to help build out the OpenAPI 3 functionality, but it's not clear what remains to be done. @Nerzal or other maintainers, is there any tracking of the work that's left - a milestone or issue or similar?