Executor of unittest.TestCase subclasses ordered by groups.
Project description
TestCasesExecutor
Execute configured groups of TestCases (subclasses of unittest.TestCase), display human readable result in terminal, ordered by group and testcase, and generate a html file report.
Install
$ pip install testcases_executor
This also install Jinja2 used to generate html report.
Config
Create a file named testcases.py in the root directory of your project.
Inside it, import yours TestCases and make a list (or tuple) named groups that is made up of tuples, each representing a group. For example:
from your_app.test_script import TCaseOne, TCaseTwo, TCaseThree, TCaseFour
groups = [ # or (
('Group one', 'one', [TCaseThree, TCaseTwo]), # or (TCaseThree, TCaseTwo)),
('Group two', 'two', [TCaseOne, TCaseFour]), # or (TCaseOne, TCaseFour)),
] # or )
Constraints
-
groups must be a list or a tuple.
-
groups's item (group's representation) must be a tuple.
-
each tuple must contain 3 items:
- group's name must be a string.
- argument's name used to run all group's testcases string without space.
- unittest.TestCase subclasses must be a list or a tuple.
-
group and argument names, unittest.TestCase subclass must used once.
Usage
$ python -m testcases_executor
This run all tests, display result in terminal before generate, in the root directory, the html report file named tc_executor_report.html. It's possible to customize the command with following availabe arguments.
Available arguments
-
Options
- -h, --help: display help message.
- -o, --open: open html report in browser after test.
-
Tests selection
- -group_argument_name: run all group's testcases's tests.
- -TestCaseName:(without parameter) run all testcase's tests.
- -TestCaseName:(with test's names in parameter) run desired tests.
Some examples:
$ python -m testcases_executor -two
$ python -m testcases_executor -one -TCaseFour -o
$ python -m testcases_executor -TCaseTwo test_one -TCaseOne test_three
...
Result's screenshots
Terminal
Html Report
It use Bootstrap4, jQuery and Fontawesome icons (via stackpath cdn).
Click on table's lines to see tests's infos.
Test
For the same reasons that meeting your future self would cause a spacio temporal shock, testing a tester using this same tester would cause a spacio testorial shock. So above all, don't.
Run testcases_executor.tests, using unittest:
$ python -m unittest testcases_executor.tests -v
:+1: HtmlTestRunner was a great inspiration, so thank you for that.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for testcases_executor-1.0.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b56ba43500ead9ee94acd41543b9a44c328198d08e0970d1b26599ffdf3ca316 |
|
MD5 | 1c3c96c095a95483151fbfe324ea7b3c |
|
BLAKE2b-256 | 3e83b6830d01023b120a4bd18dd30fae8f790f9db6ad5967be4a24947e3db027 |