A small test runner library for Python testing
test-runner—A Runner for Python Tests
Running Python tests is a complicated task, as it seems that there is not
standard way of doing it.
test-runner implements some heuristics that try to run tests with or without
coverage measuring, independent of the used testing framework.
Before you begin, ensure you have met the following requirements:
- You have installed Python at least in version 3.6.
- You have a recent Linux machine.
The library is most likely to not work on another operating system since it is
benchexecfor resource handling, which currently only runs on recent versions of Linux.
- For development it is necessary to have the
poetrypackaging and dependency management system.
Installing Test Runner
Test Runner can be easily installed from PyPI using the
pip install test-runner
Contributing to Test Runner
To contribute to Test Runner, follow these steps:
- Fork this repository.
- Setup a virtual environment for development using
- Create a branch:
git checkout -b <branch_name>.
- Make your changes and commit them
git commit -m '<commit_message>'.
- Push to the original branch:
git push origin <project_name>/<location>.
- Create the pull request.
Please note that we require you to meet the following criteria:
- Write unit tests for your code.
- Run linting with
- Run type checking using
- Format your code according to the
To ease the execution of the tools, we provide a
Makefile with various targets.
The easiest way to execute all checks is to run
make check on a
Push your commits only if they pass all checks!
These tools are also executed in continuous integration on TravisCI and will also
check you pull request.
Failing a check will block your pull request from being merged!
See the Contributors page for a list of contributors. Thanks to all contributors!
test-runner is free software: you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
test-runner is distributed in the hope that it will be useful
but WITHOUT ANY WARRANT; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Lesser General Public License for more details.
Release history Release notifications
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size test_runner-0.7.0-py3-none-any.whl (18.6 kB)||File type Wheel||Python version py3||Upload date||Hashes View hashes|
|Filename, size test-runner-0.7.0.tar.gz (12.3 kB)||File type Source||Python version None||Upload date||Hashes View hashes|
Hashes for test_runner-0.7.0-py3-none-any.whl