Swagger Codegen 3.0.0 has been released!
First official 3.0.0 release of swagger-codegen with OpenAPI 3 support.
NOTE: artifact groupId and root package of modules have been updated since 3.0.0-RC1
(#8431); the new groupId is io.swagger.codegen.v3
and the new root package is io.swagger.codegen.v3
Supported V3 generators
- dynamic-html
- html
- html2
- java
- jaxrs-cxf-client
- jaxrs-cxf
- inflector
- jaxrs-cxf-cdi
- jaxrs-spec
- jaxrs-jersey
- jaxrs-di
- jaxrs-resteasy-eap
- jaxrs-resteasy
- spring
- openapi
- openapi-yaml
- kotlin-client
- kotlin-server
- php
- swift3
- swift4
- typescript-angular
Notable features
- groupId and package renaming #8431
- allow capability to generate templates with mustache engine #8618
- refactored online generator (
swagger-generator
) supporting V3 generators for V3 and V2 converted specs, and V2 generators for V2 specs (#8524). Provides also web UI and advanced docker image (swaggerapi/swagger-generator-v3
). See also readme - [JAVA] OAS 3.0 - Support both OAS 3.0 and Swagger 1.5.x / OAS 2.x annotations in affected java generators swagger-codegen-generators issue #90
- Supports jdk 9+ build
- Ability to specify output json/yaml filename #8480
Notable bug fixes:
-
Fixed template path resolvement to work also on Windows OS #8284
-
Fixed DefaultGenerator.getHandleBars to not use a regex string for the templateDir #8246
-
java.util.regex.PatternSyntaxException: Illegal/unsupported escape sequence near index 3 #8273
-
refactor
getHandlebars
method to handle properly files paths #8327 -
DefaultCodegenConfig - CodegenProperty minimum and maximum is not set for NumberSchema swagger-codegen-generators issue #80
-
All operation parameters are incorrectly marked as enums swagger-codegen-generators issue #97
-
Updated samples fixing various issues
-
[JAVA] Request body's of multipart/form-data requests are ignored by at least all Java generators swagger-codegen-generators issue #148
-
[JAVA] Port #6852 to 3.0.0 : need to expose getters / setters for readTimeout and writeTimeout values on the generated java clients #8193
-
[JAXRS-CXF-CDI] Invalid argument on OAS 3.0 annotation @parameter swagger-codegen-generators issue #132
-
[JAXRS-RESTEAST-EAP]Build fail for JavaResteasyEapServerCodegen output swagger-codegen-generators issue #141
-
[JAXRS-JERSEY] @patch not found swagger-codegen-generators issue #142
-
[KOTLIN] HandlebarsException in kotlin-client #8300
-
[SPRING] Spring-MVC CamelCase or underscore - not both. 3.0 codegen #8330
-
[SPRING] Duplicate "is" in boolean getter method names swagger-codegen-generators issue #91
-
[SPRING] @JsonTypeInfo property not set to Discriminator propertyName swagger-codegen-generators issue #103
-
[SPRING] @JsonTypeId not set on discriminator property causing serialization issues swagger-codegen-generators issue #105
-
[PHP] php syntax error swagger-codegen-generators issue #121