# @axway/axsway

> A library that simplifies Swagger integrations.

Latest version **2.1.1** (published 2021-06-25) · MIT license · 0 weekly downloads

## Install

```sh
npm install @axway/axsway
pnpm add @axway/axsway
yarn add @axway/axsway
bun add @axway/axsway
```

## Health

**Score 25/100 (F)** — status: abandoned.

Positive: has types; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 2.1.1 |
| Published | 2021-06-25 |
| First published | 2020-03-02 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 10 |
| Unpacked size | 142.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Jeremy Whitlock |
| Maintainers | cdobrica, axway-vertex, mbonchev-axway, pbozhkovaxway, nkeranova, axway-npm, cb1kenobi, jamie.peabody, awam, bladedancer, pboev-axway, jvos-axway, neon-axway, vchauhan, mdimitrova, pdzhorev, axway_alasdair, pltod2, npetrovski-axway |
| Keywords | api, openapi, swagger |

## Links

- npm: https://www.npmjs.com/package/@axway/axsway
- Repository: https://github.com/axway/axsway
- Issues: https://github.com/axway/axsway/issues
- npm.io page: https://npm.io/package/@axway/axsway

## Dependencies (10)

- [debug](https://npm.io/package/debug.md) ^3.1.0
- [lodash](https://npm.io/package/lodash.md) ^4.17.10
- [js-yaml](https://npm.io/package/js-yaml.md) ^3.13.1
- [z-schema](https://npm.io/package/z-schema.md) ^5.0.1
- [js-base64](https://npm.io/package/js-base64.md) ^2.4.5
- [json-refs](https://npm.io/package/json-refs.md) ^3.0.13
- [path-to-regexp](https://npm.io/package/path-to-regexp.md) ^1.7.0
- [swagger-methods](https://npm.io/package/swagger-methods.md) ^1.0.0
- [native-promise-only](https://npm.io/package/native-promise-only.md) ^0.8.1
- [swagger-schema-official](https://npm.io/package/swagger-schema-official.md) 2.0.0-bab6bed

## Recent versions

- 2.1.1 (latest) — 2021-06-25
- 2.1.0 — 2021-06-23
- 2.0.0-1 — 2020-03-02
- 2.0.0-0 — 2020-03-02

## README

A library that simplifies [Swagger][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](https://github.com/apigee-127/sway/blob/master/docs/API.md).

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.

## Project Badges

* Build status: [![Build Status](https://travis-ci.org/apigee-127/sway.svg)](https://travis-ci.org/apigee-127/sway)
* Dependencies: [![Dependencies](https://david-dm.org/apigee-127/sway.svg)](https://david-dm.org/apigee-127/sway)
* Developer dependencies: [![Dev Dependencies](https://david-dm.org/apigee-127/sway/dev-status.svg)](https://david-dm.org/apigee-127/sway#info=devDependencies&view=table)
* Downloads: [![NPM Downloads Per Month](http://img.shields.io/npm/dm/sway.svg)](https://www.npmjs.org/package/sway)
* Gitter: [![Join the chat at https://gitter.im/apigee-127/sway](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/apigee-127/sway?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
* License: [![License](http://img.shields.io/npm/l/sway.svg)](https://github.com/apigee-127/sway/blob/master/LICENSE)
* Version: [![NPM Version](http://img.shields.io/npm/v/sway.svg)](https://www.npmjs.org/package/sway)

## Installation

sway is available for both Node.js and the browser.  Installation instructions for each environment are below.

### Browser

sway binaries for the browser are available in the `dist/` directory:

* [sway-standalone.js](https://raw.github.com/apigee-127/sway/master/dist/sway.js): _9,160kb_, full source  and source maps
* [sway-standalone-min.js](https://raw.github.com/apigee-127/sway/master/dist/sway-min.js): _864kb_, minified, compressed and no source map

**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:

``` html
<!-- ... -->
<script src="sway.js"></script>
<!-- ... -->
```

### Node.js

Installation for Node.js applications can be done via [NPM][npm].

```
npm install sway --save
```

## Documentation

The documentation for this project can be found here: [/docs/README](/docs/README.md)

Of course, if you just want a quick link to the API documentation, that would be here:[/docs/API.md](/docs/API.md)

## Contributing

This project uses [Gulp][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.

[gulp]: http://gulpjs.com/
[npm]: https://www.npmjs.org/
[swagger]: http://swagger.io

---
_Source: https://npm.io/package/@axway/axsway · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
