⚠️ This project is not maintained any longer. Please feel free to fork it if you need to make changes to the library.
Generate a changelog between two versions of a swagger spec
npm install -g swagger-changelog
swagger-changelog [options] <path/to/spec1> <path/to/spec2>
-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)
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.
$ 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'
const changelog = require(swagger-changelog).changelog;
changelog('path/to/spec1', 'path/to/spec2', config)
.then((log) => {
console.log(log.paragraph);
});
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.