A library for your API that provides:
- Automated Integration Testing
- Automated Live Documentation
Given an API specification, written in YAML/JSON format, ScanAPI hits the specified endpoints, runs the test cases, and generates a detailed report of this execution - which can also be used as the API documentation itself.
With almost no Python knowledge, the user can define endpoints to be hit, the expected behavior for each response and will receive a full real-time diagnostic report of the API!
Contents
- Quick Start
- Documentation
- Tutorial
- Examples
- Dependency Management
- Contributing
- Contributors
- Supporters Through Time
Quick Start
Requirements
How to install
$ pip install scanapi
Install with pipx (isolated CLI)
If pip install scanapi collides with the dependencies in your project's environment, install it with pipx instead. pipx gives ScanAPI its own virtual environment and still puts the scanapi command on your PATH:
$ pipx install scanapi
This is the recommended path when you want ScanAPI as a standalone CLI rather than a project dependency.
Basic Usage
You will need to write the API's specification and save it as a YAML or JSON file. For example:
endpoints:
- name: scanapi-demo # The API's name of your API
path: http://demo.scanapi.dev/api/v1 # The API's base url
requests:
- name: list_all_users # The name of the first request
path: users/ # The path of the first request
method: get # The HTTP method of the first request
tests:
- name: status_code_is_200 # The name of the first test for this request
assert: ${{ response.status_code == 200 }} # The assertion
And run the scanapi command
$ scanapi run <file_path>
Then, the lib will hit the specified endpoints and generate a scanapi-report.html file with the report results.
Documentation
The full documentation is available at scanapi.dev
Tutorial
Get started with ScanAPI by following our step-by-step tutorial.
Examples
You can find complete examples at scanapi/examples!
This tutorial helps you to create integration tests for your REST API using ScanAPI
Dependency Management
ScanAPI aims to minimize dependency conflicts and ensure a smooth developer experience. Most dependencies are specified as compatible version ranges to allow flexibility and avoid unnecessary conflicts. However, a few dependencies are strictly pinned for stability:
- MarkupSafe==3.0.3: Pinned to the latest version for security and compatibility. Relax if future versions are verified safe.
- pytest-freezegun==0.4.2: This package is unmaintained and only 0.4.2 is available. Strict pin is required for test stability.
- requests-mock==1.12.1: Pinned to the latest version for compatibility. Relax if future versions are verified safe.
All other dependencies use safe version ranges (e.g., >=X.Y,<X+1.0) to reduce the likelihood of dependency conflicts. If you encounter issues with dependency installation, please open an issue or PR.
Dependency updates are regularly reviewed to ensure compatibility with supported Python versions and CI stability.
Contributing
Collaboration is super welcome! Check out our contribution guide to get started. Every little bit of help counts! Feel free to create new GitHub issues and interact here.
Let's build it together 🚀🚀
❤️ Contributors
Made with contrib.rocks.
Supporters Through Time
3 maintainers
Metadata
3 maintainers
Release files for scanapi 2.13.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| scanapi-2.13.3.tar.gz | 38.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| scanapi-2.13.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 79.8 kB
Release files / scanapi-2.13.3.tar.gz
| Download URL | scanapi-2.13.3.tar.gz |
|---|---|
| Size | 38.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f91243f570b88dc2d5dd20744eb5f7643fb4626763852ad3b9414948326106e6
|
|
BLAKE2b-256 checksum How to use checksums |
bb79e322e3ae1aee79fe5c08f05c5752cc5a3fc0e53fa42eb262de0ed2148ac7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / scanapi-2.13.3-py3-none-any.whl
| Download URL | scanapi-2.13.3-py3-none-any.whl |
|---|---|
| Size | 41.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
03dd8b3d06a7bf7a8b719a6882f0865e977e2b36b89da6b34c2678c9a284fa0f
|
|
BLAKE2b-256 checksum How to use checksums |
e273cbd68e45fea5b7f839f676e1e7d12d7d270460b417cd14ab488922e7e33f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
