swagger-test
This is a tool for
Property Based Testing
of swagger APIs.
It basically allow you to approximate the computation of the following
proposition:
valid(response, schema), response = execute(request), ∀ request ∈ schema
Which translates to:
For all valid requests that can be derived from my Swagger schema, the
API response obtained from executing that request is valid according to the
same Swagger schema.
The tool exposes several ways to configure get value from parts of it, for
example, you may be interested in getting just a random valid request from the
schema (use the generate
command), or validating if a given response (from a
particular operation) is valid (use the validate
command), or, run one sample
instance of the full proposition, which picks a random request and validate it's
resulting response (use the request
command).
The generator random request values are reproducible by re-using the same seed
value, or one can focus on a particular operation by specifying the operation
id.
The tool also simplifies integration with other systems by allowing to configure
output formats as standard HTTP message, JSON, or curl. Additionally, there
are Haskell modules exposed as a library if one wants to build on top of it.
Command Line Interface
swagger-test supports three commands:
generate
- generates a new random valid request from Swagger schema.
validate
- validate a response to a given operation id, according to the
schema.
request
- generate and make the request, then validates the response
(combines generate and validate).
swagger-test --help
Testing tool for Swagger APIs
Usage: swagger-test [-s|--schema FILENAME] COMMAND
Generate Swagger requests and validates responses
Available options:
-s,--schema FILENAME swagger JSON schema file to read
from (default: "swagger.json")
-h,--help Show this help text
Available commands:
generate Generate a random request according to Schema
validate Validate a response against Schema
request Generate, make the request, and validate response
Sub-commands
Generate
Usage: swagger-test generate [--seed N] [-o|--operation ID]
[--request-format http|curl|none|json] [-i|--info]
[--size N]
Generate a request
Available options:
--seed N specify the seed for the random generator
-o,--operation ID specify a operation id to test (default pick
randomly)
--request-format http|curl|none|json
output format of the HTTP request (default: http)
-i,--info render information about seed and operation id
--size N control the size of the generated
request (default: 30)
-h,--help Show this help text
Validate
Usage: swagger-test validate [FILENAME] (-o|--operation ID)
Validate a response
Available options:
FILENAME http response file to read from (default=stdin)
-o,--operation ID specify a operation id to test (default pick
randomly)
-h,--help Show this help text
Request
Usage: swagger-test request [--seed N] [-o|--operation ID]
[--request-format http|curl|none|json]
[--response-format http|json|none] [-i|--info]
[--size N]
Generate, make the request, and validate response
Available options:
--seed N specify the seed for the random generator
-o,--operation ID specify a operation id to test (default pick
randomly)
--request-format http|curl|none|json
output format of the HTTP request (default: none)
--response-format http|json|none
output format of the HTTP request (default: none)
-i,--info render information about seed and operation id
--size N control the size of the generated
request (default: 30)
-h,--help Show this help text