A library that simplifies Swagger integrations. This library handles the minutiae of loading Swagger documents (local and remote), resolving references (local, remote), building an object model and providing you with a rich set of APIs for things like Swagger document validation, request/response validation, etc. For more details on the available APIs, please view the API Documentation.
Sway will always be built around the latest stable release of Swagger, which happens to be version 2.0 right now.
This means that its APIs and object model will be specific to that version of Swagger and supporting any other versions
of Swagger will require a conversion step prior to using Sway.
sway is available for both Node.js and the browser. Installation instructions for each environment are below.
sway binaries for the browser are available in the dist/ directory:
Note: I realize these binaries are big and I'm working on making them smaller. Unfortunately, some of this is out of my control without rewriting some of the core features provided by third-party libraries currently contributing to the size issue.
Of course, these links are for the master builds so feel free to download from the release of your choice. Once you've gotten them downloaded, to use the standalone binaries, your HTML include might look like this:
<!-- ... -->
<script src="sway.js"></script>
<!-- ... -->
Installation for Node.js applications can be done via NPM.
npm install sway --save
The documentation for this project can be found here: /docs/README
Of course, if you just want a quick link to the API documentation, that would be here:/docs/API.md
This project uses Gulp for building so npm install -g gulp once you clone this project. Running gulp in the
project root will lint check the source code and run the unit tests.
FAQs
A library that simplifies Swagger integrations.
We found that sway demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
PyPI confirms no security flaws were exploited in the Ultralytics supply chain attack and highlights improvements for safer package publishing.
Security News
Research
The Socket Research Team breaks down a malicious wrapper package that uses obfuscation to harvest credentials and exfiltrate sensitive data.
Research
Security News
Attackers used a malicious npm package typosquatting a popular ESLint plugin to steal sensitive data, execute commands, and exploit developer systems.