Preacher: Web API Verification without Coding
Preacher verifies API servers, which requests to the servers and verify the responses along to given scenarios.
Test scenarios are written only in YAML declaratively, without coding. In spite of that, Preacher can validate your web API flexibly, which enables you to test using real (neither mocks nor sandboxes) backends.
- Responses are analyzed jq or XPath queries
- Validation rules are based on Hamcrest (implemented by PyHamcrest).
The full documentation is available at preacher.readthedocs.io.
Targets
- Flexible validation to test with real backends: neither mocks nor sandboxes.
- Matcher-based validation.
- CI Friendly to automate easily.
- A CLI application and YAML-based scenarios.
Usage
First, install Preacher.
The most basic way to install Preacher is using pip. Supports only Python 3.7+.
$ pip install preacher
$ preacher-cli --version
Instead of pip, Docker images are also available on
Docker Hub
as ymoch/preacher.
By default, the container working directory is /work,
and the host directory may be mounted here.
$ docker pull ymock/preacher
$ docker run -v $PWD:/work ymoch/preacher preacher-cli --version
Second, write your own scenario.
# scenario.yml
label: An example of a scenario
cases:
- label: An example of a case
request: /path/to/foo
response:
status_code: 200
body:
- describe: .foo
should:
equal: bar
Then, run preacher-cli command.
$ preacher-cli -u http://your.domain.com/base scenario.yml
For more information such as grammer of scenarios, see the full documentation.
License
Copyright (c) 2019 Yu MOCHIZUKI
1 maintainer
Metadata
1 maintainer
Release files for preacher 0.15.11
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| preacher-0.15.11.tar.gz | 44.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| preacher-0.15.11-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 123.3 kB
Release files / preacher-0.15.11.tar.gz
| Download URL | preacher-0.15.11.tar.gz |
|---|---|
| Size | 44.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
52e8599e5c643d5ebbef3659249dc4cd3e2ff2fdcca1613c1dee4d1a2f7da1f7
|
|
BLAKE2b-256 checksum How to use checksums |
597993c060114be1e5d1c77255131f6606ad0db3ec3f3c8ab6008389d792c7c8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.1.13 CPython/3.7.13 Linux/5.13.0-1023-aws
|
Release files / preacher-0.15.11-py3-none-any.whl
| Download URL | preacher-0.15.11-py3-none-any.whl |
|---|---|
| Size | 79.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1b7469647f23d663f306582c3655e6a9238861edc8e54b9b85004026ecae839d
|
|
BLAKE2b-256 checksum How to use checksums |
d2edb2000abb56a95c06aaa387085504e4e9d8cc1e1812f23489320a8072bb29
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.1.13 CPython/3.7.13 Linux/5.13.0-1023-aws
|
