Releases: swagger-api/swagger-js
Swagger js 2.1.0-M2 Released!
Swagger-client 2.1.0-M2 Released!
This is a major refactor of swagger-client to add better support for Swagger 2.0 specifications and the new features that come with it. In addition, we have shrunk the library considerably, added much more robust test coverage and removed dead code. This effort was only made possible by support from Apigee and their folks @mohsen1 and @whitlockjc. Many thanks for supporting the project! The entire community benefits from your support.
Usage notes
Note! There are some differences in the API between 2.1.x-M1 and 2.1.x-M2. For example, 1.x version swagger specifications are now converted into 2.0 versions. That means features such as multiple base paths are no longer supported! Please do not upgrade to 2.1.x-M2 if this change isn't acceptable. It will not be coming back in subsequent releases.
In converting from 1.x specs to 2.0, the resourcePath (location where the documentation for an Api was declared) is now used to develop a tag in the 2.0 specification world.
Major changes
The build process is now using gulp with mocha tests. It is now packaged in a single library (minified version available) using browserify, and is a proper npm.js package. We have also greatly enhanced the interactive help inside the client buy supporting .help() on the client, tags, and operations.
Notable features
- #160, #183, #258, #270 Added ref support for parameters, models, model properties. You can now use the Swagger 2.0 remote reference support for models, properties, paths and parameters.
- #178 Removed global variables. You can now have multiple instances of swagger-client in your app without sharing authorizations, etc.
- #182 merged 1.x and 2.0 support, including support for "single-file" 1.x specifications. This resulted in removing almost half the code in the project.
- #189 Added support for in-line schemas
- #208 Build with gulp, browserify. now a single library can be deployed for your webapps.
- #267 Switched from
shredtosuper-agent. Dropped need for jQuery as super-agent now has universal client support. - #277 Added response headers to response model description
Notable bug fixes
- #234
deprecatedis now shown correctly - #194 fixed issue where reserved names were clobbering functions
- #327 auto-generate operationId if not present
- #328 more graceful handling of CORS issues when loading swagger-client
Please open any issues directly in github and send pull-requests to the develop_2.0 branch!
Limitations
There are some unimplemented features of the swagger 2.0 specification in this release. Please see the Milestones and Issues for the final 2.1.0 release.
Swagger 2.1.5-M1 released!
A patch release for swagger-client has been released to address corner cases and add new functionality
New features:
- Support for the tag object from the 2.0 swagger spec, including description and external docs #243
- Options passed to underlying HTTP library by caller #229
Issues fixed:
Swagger-js v2.1.1-M1 Released!
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:
- Available on npmjs.org
- First official milestone release of Swagger 2.0 support. Backwards compatible with Swagger 1.2.
- Unified API to initialize either 1.1, 1.2, 2.0 clients.
- Replace cake with gulp as the build tool.
- Rebuild the test framework with mocha and pure javascript.
- Addressed syntax issues which were breaking older versions of Internet Explorer
- Allow for repeated models of the same type in sample objects.
- Provide a example value for ‘date’ format.
- Please note that 2.1.1-M1 lives in Master
Notable Bug Fixes:
- Fixed query parameter encoding (#210)
- Fixed usage of content-type (#192)
- Fixed support for multi params with brackets (#191)
- Add array schema support (#147)
- Fix consumes/produces property propagation (#138)
- Added asCurl, mock modes for testing and debugging
Breaking Changes:
- The 1.x class, SwaggerApi, has been replaced with a unified SwaggerClient class.
Limitations: - There are 2.0 features which are NOT implemented, as described in the [milestones](https://github.com/swagger-api/swagger-js/milestones page)
v2.0.48
Swagger 2.0.48 has been released!
New features
- Refactored test framework. Now using mocha (#193)
- Added better support for sample JSON macros. You can provide interceptors to dynamically populate both model properties as well as operation parameters (#177)
- Added support for asCurl documentation, to show what a curl command would be based on any swagger operation. Includes headers, params, etc (#174)
- Default success and error callbacks implemented (#130)
- Configurable accept header when fetching swagger specifications (#120)
- Removed
globalscope for authorizations, allowing swagger-client to support multiple APIs in a single deployment (#109) - Added pass-through of
optswhen making requests
Defects fixed:
Please see https://groups.google.com/forum/#!forum/swagger-swaggersocket for the swagger google group, or http://webchat.freenode.net/?channels=swagger for IRC