The goal of Swagman is to generate test specification from API specification. More specifically, Swagman generates Newman collection files from given Swagger YAML file.
Swagman fits well with Test Driven Development. Once API description documentation is maden, development can be started with generated test specification.
Further, testing/developing API with auto-generated test specification from API specification can validate that API implementation is reflecting it's newest version of API specification.
- Postman
- Postman is a REST API test tool. You can make/launch collection (sequence of request item) with Postman.
- Newman
- Newman is a command line collection runner for Postman application.
swagman is a Perl script which generates the test specification.
$ ./swagman sample_swagger.yml
Generated collection files will locate under ./autogen-collections directory. Each request item in the collection file contains it's assertion code for server response in Javascript syntax.
When executing collection files, it will be more convenient to use swagman-runner instead of directly launch Newman. This is because current Newman does not support shell's globing feature and dynamic setting of the server's base URL.
$ ./swagman-runner 'http://localhost:8080' ./autogen-collections/*.postman_collection.json
http://localhost:8080 is the base URL in this sample. Other URL such as dev/test/production server can be used here.
swagman-runner exits with return code which Jenkins recognizes so that the entire Jenkins build can success or fail. Other CI/CD Pipeline or Docker Cloud can also be used.
For large API, test fixture or/and ordering of requests is required to success use case test. Further, you might want to change test behavior for server response.
These customization can be done by importing collection files to Postman application. After customizing, You can export it back to collection file to run with swagman-runner.
*Note that you need to make environments for base URL when using Postman application.
perl is required to run swagman and swagman-runner.
for Mac users
No need to install perl by yourself.
for Windows users
Install StrauberryPerl or ActivePerl.
YAML module is required to run Swagman.
Check cpan is on your system or not. If not, install cpan.
$ cpan -version
Install YAML module using cpan.
$ sudo cpan YAML
$ npm install -g newman
Download Postman form here.
Swagman is open source software released under the Apache 2.0 license.