Getting Started

Clone the pytest-gui repository

Install dependencies (pip install -r requirements.txt)

Run command and select the directory to search/run tests from (python main.py)

General Usage

Initial screen consists of a left side pane, showing all the test cases that are discovered
in the selected directory. By default, this would load tests from ../tests directory. We can
load tests from any other directory using the Reload Tests button.

On left side we can select one or multiple test cases. To select multiple test cases, click the control
button and select more test cases. If a parent of a test case is selected, then all tests under that
parent are selected to run.

Commands.

Run Button

The Run button provides option to run selected test cases. This would run all test cases that are selected.
If any higher level tests are selected (either a test class or a test file), then all tests under that test
are executed.

Re-run Button

The Re-run button runs only failures. If no tests have been run, this is similar to Run-All button whereby
it would run all test cases.

Run-all Button

This would run all test cases.

Stop Button

This would stop any running test cases. The status of already run test cases would remain as is.

Test Case Status

There are 4 test cases statuses and they are appropriately color-coded.

Unrun: Test cases are not run yet. They would be highlighted with black color.

Pass: Test cases are run and passing. They would be highlighted with green color. We also show a green circle on the right pane in details section.

Fail:Test cases are run and failing. They would be highlighted with red color. We also show a red circle on the right pane in details section.

Skip: Test cases are skipped using @unittest.skip directive. They would be highlighted with blue color. We also see a blue circle on the right pane in details section.