swagger-changelog

Generate a changelog between two versions of a swagger spec

Showing:

Popularity

Downloads/wk

11

GitHub Stars

17

Maintenance

Last Commit

14d ago

Contributors

3

Package

Dependencies

3

Size (min+gzip)

0.2KB

License

MIT

Type Definitions

Tree-Shakeable

No?

Categories

Readme

Swagger Changelog

⚠️ This project is not maintained any longer. Please feel free to fork it if you need to make changes to the library.

npm version

Generate a changelog between two versions of a swagger spec

Install

npm install -g swagger-changelog

Usage

swagger-changelog [options] <path/to/spec1> <path/to/spec2>

Options

-h, --help          output usage information
-V, --version       output the version number
-e, --endpoint <n>  Endpoint Threshold, 0-1.0 (Default 0.85, higher means closer)
-p, --param <n>     Param Threshold, 0-1.0 (Default 0.75, higher means closer)

Distance Thresholds

The Endpoint and Param thresholds are the minimum value for the Damerau - Levenshtein comparison ratio. It scores from 0-1 how similar the two words are.

Example

$ swagger-changelog src/tests/specs/petstore.1.json src/tests/specs/petstore.1.1.json
Changes: /pet (put) - Method added
Renamed: Path '/pet/findByStatus' renamed to '/pet/findByStatii'
Renamed: Path '/pet/findByTags' renamed to '/pet/findByTag'
Renamed: /pet/{petId} (get) - Param 'petId' renamed to 'petIdz'

API Usage

const changelog = require(swagger-changelog).changelog;

changelog('path/to/spec1', 'path/to/spec2', config)
  .then((log) => {
    console.log(log.paragraph);
  });

Credits

swagger-changelog is a Swimlane open-source project; we believe in giving back to the open-source community by sharing some of the projects we build for our application. Swimlane is an automated cyber security operations and incident response platform that enables cyber security teams to leverage threat intelligence, speed up incident response and automate security operations.

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100