Skip to content

Releases: swagger-api/swagger-codegen

Swagger Codegen 3.0.0-rc0 has been released!

25 Jan 21:15
@HugoMario HugoMario
v3.0.0-rc0
d20d1a8
Compare
Choose a tag to compare
Swagger Codegen 3.0.0-rc0 has been released! Pre-release
Pre-release

This is our first official release of swagger-codegen with OpenAPI 3 support!

Being a first release (and during the RC (release candidate) releases), we highly depend on the community to provide us with feedback. There are some major changes in this release, so help us test it out. For any issues or concerns, please file a ticket so we can start a discussion. Also, first releases being RC releases - you should expect there to be breaking changes, based on feedback and further development.

Read the FAQ at the end of the release notes for more information about the changes in this version and how you can help!

This release has been implemented for java and inflector languages as a start of OpenAPI 3.0 support.

General enhancements based on issues #6041 and #6077

  • OpenAPI 3.0 support.
  • Switched to Handlebars template engine.
  • Removed all is, isNot, hasand hasNot properties from codegen pojos and use extensions instead.
  • Added helpers to replace the removed properties. i.e {{is this 'enum'}}, {{has this 'more'}} {{isNot this 'form-param'}}, etc.
  • Remote arguments loading for swagger codegen-cli and swagger generator modules.
  • Requires Java 8 for operation.
  • The templates will now be managed in a separate repository swagger-codegen-generators and will be released independently of the engine itself.
  • swagger-generator works with 'inflector 2.0', check open api spec to know endpoint details.

Known Limitations

  • java and inflector are the only supported languages.
  • No supported languages templates are no longer available in this repo. They are going to be eventually moved to swagger-codegen-generators.
  • It's likely that many parts of the documentation are not up to date yet.

FAQ

  • Q: What does support for OAS3 mean?

  • A: API definitions of previous versions of the spec will be automatically converted to OAS3, and only then the code will be generated. Since our conversion is also in RC mode right now, we expect there to be broken conversions, and with your tickets we can have those issues resolved.

  • Q: Switched to Handlebars?! Why?

  • A: Handlebars is mostly compatible with Mustache, meaning migration is not always required, or if so, changes should be minimal. On the other hand, Handlebars offers more flexibility in the templates, which would end up simplifying the templates and the generators.

  • Q: Why have the generators (templates) been separated to a new repository?

  • A: The codegen engine and the generators advance in a significantly different pace. In order to allow for more frequent releases of either, the separation made sense. It's likely that in future RC releases, each generator would be versioned independently allowing for even further release flexibility. This does introduce some challenges, read ahead in the FAQ.

  • Q: What happened to all the existing generators? Why only 2 were migrated?

  • A: We needed an initial start with the new version, and some of the Java templates made sense to us as the codegen itself is written in Java. As you know, the majority of the generators are made by our awesome community of contributors! We'll need the community's help with migrating and testing further templates.

  • Q: What are the main current challenges?

  • A: There are two main challenges. The first - migrating the long list of templates that we have and test them. The second - separating the generators to a new repository has made the build process slightly more complicated. We have thoughts on how to improve it, and would love the community input on it as well.

  • Q: Are there any other major changes coming?

  • A: Maybe, and they may or may not come as part of the 3.0 release. We have some thoughts on improving version management for the generators and the engine to ensure compliance.

  • Q: How can we, as a community, help?

  • A: The codegen community is very active and vibrant, and we're very appreciative of the help we've gotten over the years. As you would expect, with a new major version, the help can come in with testing, migrating templates, filing issues, giving suggestions, and providing feedback to the changes. We'll do our best to listen and incorporate those into the project.

  • Q: swagger-codegen-generators's README is empty?

  • A: Yes, we know. It needs some love. We'll get there by RC1!

Assets 2
Loading

Swagger Codegen 2.3.1 has been released!

17 Jan 04:33
@wing328 wing328
v2.3.1
4bdaf37
Compare
Choose a tag to compare
Swagger Codegen 2.3.1 has been released!

Thanks for the feedback from the Swagger Codegen community on the v2.3.0 stable release.

We've addressed several important issues as follows:

  • Fix to make Swagger Codegen compatible with JDK7 again #7260
  • [Scala] Fix missing json4s import #7271
  • [Typescript][Angular] fix regression/bug that parameters with an _ ignore naming convention #7313
  • [Java] allow setting boolean getter (is, has, get) in templates #7344
  • [Java][jersey2] Fix logging for jersey2 (Java6) #7348
  • [Java][Vertx] use reflection to instantiate non-generated class #7360

For other minor fixes and enhancements, please refer to the full list here.

We've also included a new Ada server generator in this release:

  • [Ada] Add Ada support for server code generator #7256
Assets 2
Loading

Swagger Codegen 2.3.0 has been released!

22 Dec 03:38
@wing328 wing328
v2.3.0
ea9340e
Compare
Choose a tag to compare
Swagger Codegen 2.3.0 has been released!

This release brings a record of 13 new generators in a single release with more than 600 PRs, which contain breaking changes (with fallback, without fallback).

Note! This release does not yet support OpenAPI 3.0, which will be included in the upcoming 3.0.0 release.

Many thanks again to the swagger-codegen team for their continued support of the project and the contributions from the awesome Swagger Codegen community with more than 800 contributors from all around the world.

General enhancements & bug fixes

New Generators:

API Clients

API servers

API Clients (enhancements, bug fixes)

API Servers (enhancements, bug fixes)

Documentation (enhancements, bug fixes)

Assets 2
Loading

Swagger Codegen 2.2.3 has been released!

15 Jul 22:36
@wing328 wing328
v2.2.3
049b1b2
Compare
Choose a tag to compare
Swagger Codegen 2.2.3 has been released!

This release brings a record of 11 new generators in a single release with more than 450 PRs. Note! We will stop support on the 2.2.x branch of swagger-codegen and focus on 2.3.x and soon 3.x. Please consider migrating to 2.3 now!

Many thanks again to the swagger-codegen team for their continued support of the project and the contributions from the awesome Swagger Codegen community with 643 contributors from all around the world.

General enhancements & bug fixes

New Generators:

API Clients

API servers

Configuration

API Clients (enhancements, bug fixes)

API Servers (enhancements, bug fixes)

Documentation (enhancements, bug fixes)

Assets 2
Loading

Swagger Codegen 2.2.2 has been released!

01 Mar 20:01
@fehguy fehguy
v2.2.2
ff209ad
Compare
Choose a tag to compare
Swagger Codegen 2.2.2 has been released!

This release brings 4 new API client generators and 5 new server stub generators. More than 500 enhancements and bug fixes have been successfully merged.

Many thanks to the swagger-codegen team for their continued support of the project and the contributions from the awesome Swagger Codegen community. A special thanks to @wing328 for helping drive the project (and for drafting these release notes...)

General enhancements & bug fixes

New Generators:

API Clients

API servers

API Clients (enhancements, bug fixes)

API Servers (enhancements, bug fixes)

Documentation (enhancements, bug fixes)

Assets 2
Loading

Swagger-codegen 2.2.0 Released!

18 Jul 00:18
@fehguy fehguy
v2.2.0
46545c1
Compare
Choose a tag to compare
Swagger-codegen 2.2.0 Released!

Swagger Codegen 2.2.0 has been released! This release provides major new functionality across multiple generation targets and addresses a number of potential issues.

There are changes in a number of the generation targets which may change the default behavior. Please review links associated with targets for details.

For a list of breaking changes (without fallbacks), please refer to this list.

For a list of breaking changes (with fallbacks), please refer to this list.

Once again, many thanks to the swagger-codegen team for their continued support of the project.

General enhancements & bug fixes

  • Update JMustache to the latest version (v1.12): #2360
  • Better support example value for string and number: #2689
  • Improvement to codegen model #2691, #2712
  • Fix naming of the BEARER token: #2783
  • Fix unicode issue when reading OpenAPI spec: #2785
  • Add individual options to exclude tests and docs for apis and models: #2866
  • Use title attribute as inline model name: #2872
  • Add .swagger-codegen-ignore to skip overwriting files: #2899
  • Add Apache 2.0 license to all generators: #2993
  • Minor improvements to code generator: #2921, #3005, #3289
  • Improvements to API documentation: #2928, #2929
  • Additional integration tests using Shippable and AppVeyor: #3275, #3333

Security fixes

API client generators

API server generators

Assets 2
Loading

Swagger-codegen 2.1.6 Released!

09 Apr 08:06
@wing328 wing328
v2.1.6
44ee91b
Compare
Choose a tag to compare
Swagger-codegen 2.1.6 Released!

General enhancements & bug fixes

API client generators

API server generators

  • Java server (Spring, JAX-RS) generator - enhancements and bug fixes #2421, 2346, #2256, #2249, #2021, #1960, #1882
  • Haskell Servant generator - first release #2009
  • ASP.NET 5 server generator - first release #2024
  • Python Flask generator - #1958, #1957

For a list of breaking changes (without fallbacks), please refer to this list

For a list of breaking changes (with fallbacks), please refer to this list

Assets 2
Loading

Swagger-codegen 2.1.5 Released!

15 Jan 00:07
@fehguy fehguy
v2.1.5
cc0d29f
Compare
Choose a tag to compare
Swagger-codegen 2.1.5 Released!

Another big update to swagger-codgen. 198 pull requests have been merged and over 150 issues closed. Codegen now has 36 different targets to build from your Swagger (now OAI) specifications.

We've also started pushing docker images of the swagger-online generator directly to DockerHub. You can pull these images and generate code directly inside your Docker infrastructure in seconds, without building anything.

The swagger-codegen-cli has updated options, all which are available inside the swagger-generator server.

General enhancements & bug fixes

  • A bug with inline response models has been addressed (#1618, #1734)
  • A static javascript client has been added (#1671, #1690)
  • Better support for variable + parameter name collisions (#1821, #1824)
  • Binary and Byte types are now exposed to the template system (#1757)
  • Dependency updates (#1776)
  • Duplicate operationId prevention (#1823)
  • General code hygiene (#1794)
  • Options sanitization, datatype declaration for configuration purposes (#1786, #1805)
  • Profiling added to scripts (#1709, #1708, #1702)
  • Publish docker image on build (#1813)
  • Vendor extension support (#1768)

Language-specific updates

Assets 2
Loading

Swagger-codegen 2.1.4 Released!

26 Oct 19:18
@fehguy fehguy
v2.1.4
c00f4ba
Compare
Choose a tag to compare
Swagger-codegen 2.1.4 Released!

Tons of updates in the latest swagger-codegen release. In addition to having a number of
template and language-specific fixes & updates, there are some core changes to the codegen
which provide more complete spec support and enhanced debugging.

We’ve also added maven central badges (#1368) and greatly improved the README for the
project.

The swagger-codegen-cli executable jar has greatly improved documentation and the ability to use configuration files instead of a mountain of CLI options (#1306).

Here are some details of updates in this release. Overall there were 160 PRs merged!

General enhancements & bug fixes

  • README updated with better instructions, TOC
  • NPE fixed for empty OAuth scopes
  • Better online generator support documentation
  • Configuration set via file (#1306)
  • Better exception handling (#1359, #1356, #1276)
  • Migrated tests to be pure java (#1312, #1304)
  • Authorization scope added to security models (#1390, #1392)
  • Support for inline models through new swagger-parser features (#1410)
  • Support for top-level consumes & produces (#1411, #1370)
  • Better handling for missing/invalid operationId (#1431)

Language-specific updates

Assets 2
Loading

Swagger-codegen 2.1.2 Released!

09 Jun 14:48
@webron webron
v2.1.2
eafcc43
Compare
Choose a tag to compare
Swagger-codegen 2.1.2 Released!

This is the first formal release of swagger-codegen with 2.0 spec support. Many thanks to the community for furthering the development of swagger and especially to @wing328 and @xhh (among others) for their generous contributions to the project.

Please note! We have repackaged the project from com.wordnik to io.swagger. The code API is the same!

Usage notes

Swagger-codegen has a fresh new command-line interface, and can be run, stand-alone or as a web-service from open-source tools.

Major changes

With the added support in swagger-parser, swagger-codegen now supports more complete swagger 2.0 specifications as well as YAML file formats.

Added support for c++ in the QT5 framework, as well as Perl, and Swift.

Notable features

  • added C# generator #373, #399, #665
  • Better support for 1.2 specs #606
  • Improved PHP support #614, #622, #103, #635, #628
  • Python support improvement #594, 595
  • Improved Ruby template support #253
  • Auto-generated method naming improvements #639, #274
  • Java client support improvement #305, #690, #445
  • Objc client support improvement #638, #633
  • Switched to native JSON parsing for Android #687

Notable bug fixes

  • enum support for 1.2 specs fixed #621
  • Nested models in java/android generations fixed #290
  • Fix for recursive examples #728
Assets 2
Loading