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.

Prerequisites

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 depending on benchexec for resource handling, which currently only runs on recent versions of Linux.
For development it is necessary to have the poetry packaging and dependency management system.

Installing Test Runner

Test Runner can be easily installed from PyPI using the pip utility:

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 poetry: poetry install.
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 flake8 and pylint
Run type checking using mypy
Format your code according to the black code style

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 poetry shell. 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!

Contributors

See the Contributors page for a list of contributors. Thanks to all contributors!

License

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.

You should have received a copy of the GNU Lesser General Public License along with test-runner. If not, see https://www.gnu.org/licenses/.

Metadata

Release files for test-runner 0.7.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for test-runner 0.7.0
File	Size	Uploaded
test-runner-0.7.0.tar.gz	12.3 kB	Jan 8, 2020	Details

Built distribution (wheel)

Table of built distributions (wheels) for test-runner 0.7.0
File	Interpreter	ABI	Platform	Reset
test_runner-0.7.0-py3-none-any.whl 18.6 kB Jan 8, 2020	Python 3	none	any	Details

Total release size: 30.8 kB

Release files / test-runner-0.7.0.tar.gz

Download URL	test-runner-0.7.0.tar.gz
Size	12.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`b3b69019150910f0aaf9aaeaaf5c5fb8020799cccbdd13c199d4a3835e4d79db`
BLAKE2b-256 checksum How to use checksums	`14f02c1efb003263d0262f0c94f40fddab38e808f42c05874e993e7cd0c87024`
Upload date	Jan 8, 2020
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.0.0 CPython/3.8.1 Linux/5.4.8-gentoo-x86_64`

Release files / test_runner-0.7.0-py3-none-any.whl

Download URL	test_runner-0.7.0-py3-none-any.whl
Size	18.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`de0b997647fee9f862b3d96ecb4253a2d99d44fffe55d4c966d61567221c7c16`
BLAKE2b-256 checksum How to use checksums	`411a0c0cbd5acb1b30f0f5797d34192e4093f06c9b083714db16080088a9ec1a`
Upload date	Jan 8, 2020
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.0.0 CPython/3.8.1 Linux/5.4.8-gentoo-x86_64`