Skip to main content

An interactive GUI test runner for PyTest

Project description

PyTest Commander

Code style: black

A UI for controlling PyTest interactively. With it, you can explore your test hierarchy (test packages/modules/classes/methods etc.), run tests at the click of a button and see the results presented in your web browser.

Screenshot

Features

  • Run tests by group (module, class etc.) or individually.
  • Clear pass/fail labelling so you can dig down and find what failed quickly, instead of having to scroll up through many screens of terminal output.
  • Test files and dependencies are reloaded every time so you can run, tweak your code, then run again in a fast iteration cycle.
  • Runs on any modern OS and browser (tested on Win10, macOS and Ubuntu with Chrome, Firefox and Safari). IE is not supported.
  • Automatically start and stop docker services while running if specified in a docker-compose.yml file in the root test directory.
  • Tests are run in separate processes and reloaded for each invocation, allowing tests to be tweaked and re-run without restarting the main process.

Prerequisites

  • Requires Python3.6+ and pip.

Quickstart

Install and get started running your own PyTest tests:

pip install pytest-commander
pytest_commander /path/to/your/tests

I recommend installing into an activated virtual environment. You will want to make sure that all additional dependencies required to run your tests are installed into the same virtual environment.

When you run with default options, the web app to browse and run tests should be opened automatically in your default browser. To view full docs for the command-line parameters, run pytest_commander --help.

Build from source

Alternatively you may build from source. In addition to the prerequisites above, you must ensure you have installed pipenv and npm.

git clone https://github.com/ryanc414/pytest_commander.git
cd pytest_commander
python build.py
python test.py

You may then install the local directory into an activated virual environment, along with other dependencies installed to run your tests:

pip install .
pytest_commander /path/to/your/tests

PyTest Configuration

Configuration for PyTest such as extra command-line arguments may be specified by adding a pytest.ini file in the same directory. See https://docs.pytest.org/en/latest/reference/customize.html#pytest-ini for more details.

Note that there is a known issue when using pytest_commander along with the xdist plugin, used to parallelise tests among multiple processes. You will have to remove xdist config options from your pytest.ini in order to use pytest-commander.

Renaming

Previously this project was called "pytest_web_ui". I felt that this name gave too much emphasis to the implementation detail of the UI being a web app, when it could easily have been implemented in some other way (e.g. as an electron app) and still serve the same purpose. I chose the name "pytest_commander" to reflect the true purpose of this project: giving a friendly and intuitive interface for developers to take command of their tests.

Happy testing!

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pytest_commander-2.7.0.tar.gz (962.8 kB view details)

Uploaded Source

Built Distribution

pytest_commander-2.7.0-py3-none-any.whl (973.9 kB view details)

Uploaded Python 3

File details

Details for the file pytest_commander-2.7.0.tar.gz.

File metadata

  • Download URL: pytest_commander-2.7.0.tar.gz
  • Upload date:
  • Size: 962.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.6.4 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.1 CPython/3.8.11

File hashes

Hashes for pytest_commander-2.7.0.tar.gz
Algorithm Hash digest
SHA256 a748571a7f9d3b44b555c7581938bd9453a5b5c268c3b96c52a31e5f61238f75
MD5 2d7beba0a5218ac9f839d3ce4d90dcf6
BLAKE2b-256 cdf6e667ea5000f469c3228dc91fe0a2aeb5c2132c9c5657cb22802b7666a280

See more details on using hashes here.

File details

Details for the file pytest_commander-2.7.0-py3-none-any.whl.

File metadata

  • Download URL: pytest_commander-2.7.0-py3-none-any.whl
  • Upload date:
  • Size: 973.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.6.4 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.1 CPython/3.8.11

File hashes

Hashes for pytest_commander-2.7.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ca0527399cf7de473788b4343e9b688cce1b352e588e741e5a972051eb7128c9
MD5 4415f75e8ef11eeb352bd41a17b29fe9
BLAKE2b-256 823058c5189fe5798a437445d1ace5777ebd0d1ecf2445cf6c0e59be227f068c

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page