Skip to content

Swagger-core v1.5.0-M1 Released!
Compare
Choose a tag to compare
@fehguy fehguy released this 03 Feb 15:20
· 3222 commits to master since this release
v1.5.0-M1
b628bb2

The Swagger team is proud to announce the M1 release of three of our main libraries and tools: swagger-js, swagger-ui and swagger-core. All release provide official initial support for Swagger 2.0’s main features. The missing features will be added in the next milestone releases until the final release is available.

In order to better improve these libraries and tools, we ask that you start using them and provide us with feedback in form of issues on the github repository. The issues are a huge help in finding what’s missing or not working properly (though note some issues are already submitted). We would also appreciate any PRs that improve existing or new tickets.

These releases could not have happened without the intensive support of the Swagger community. Each of the projects had a few PRs that really helped us push these projects forward!

Be aware that the release notes contain the notable changes, but there may some changes that we missed in the list.

Notable Features:

  • First official milestone release of Swagger 2.0 support. Swagger-Core now produces Swagger 2.0 specs only.
  • (Software) API compatible with 1.3.6+. For supported configurations, only a dependency upgrade is required. You may need a slight alteration to your configuration.
  • Swagger-core is pure Java. Only the tests are in Scala, and those do not affect the dependencies of the library.
  • Model introspection is now done by Jackson, and is much more robust.
  • No more reliance on com.sun.* packages, making swagger-core safe for Google App Engine deployments.
  • New, extension model for processing different annotation types. Extensions are loaded via Java SPI, see here for an example
  • Available on Maven central, and the sources are in the 1.5.0-M1 branch. PRs should be submitted against the develop_2.0 branch.
  • Please note that the swagger-core-1.5.x-M1 code lives in the 1.5.0-M1 branch.

Limitations:

  • There will be a M2 and M3 release of swagger-core which will provide updated support for Play! framework and scala-based servers. Please see the github milestones page for details
  • Subresource support is not implemented
  • Model converters have a new, incompatible signature with 1.3.x. Please see here for an example for details of the new interface
Assets 2
Loading