pytest-testdox 3.1.0

Description:

pytesttestdox 3.1.0

pytest-testdox



A TestDox format reporter for pytest.

Install
pip install pytest-testdox

Usage
Add the parameter --testdox when running pytest. For example:
pytest --testdox your-tests/

Tip: If you don't want to type --testdox every time you run pytest, add it
to addopts
in your ini file.
For example:
# content of pytest.ini or tox.ini
[pytest]
addopts = --testdox

# or if you use setup.cfg
[tool:pytest]
addopts = --testdox

When using --testdox, the plugin will disable itself when not running on a
terminal. If you want the testdox report no matter what, use the parameter
--force-testdox instead.
Markers
@pytest.mark.describe
Override the class name in the testdox report. For example:
# test_demo.py
@pytest.mark.describe('create_file')
class TestCreateFile():

def test_creates_a_file_in_the_so(self):
pass

Will produce the output:
test_demo.py

create_file
[x] creates a file in the so

@pytest.mark.it
Override the test title in the testdox report. For example:
# test_demo.py
class TestCreateFile():

@pytest.mark.it('Creates a local file in the SO')
def test_creates_a_file_in_the_so(self):
pass

Will produce the output:
test_demo.py

Create File
[x] Creates a local file in the SO

Configuration file options
testdox_format
Specifies TestDox report format, plaintext or utf8 (default:
utf8). For example:
# content of pytest.ini
# (or tox.ini or setup.cfg)
[pytest]
testdox_format = plaintext

$ pytest test_demo.py
============================= test session starts ==============================
platform darwin -- Python 3.5.0, pytest-3.0.7, py-1.4.33, pluggy-0.4.0
rootdir: /private/tmp/demo, inifile: pytest.ini
plugins: testdox-dev
collected 2 items

test_demo.py
Pytest Testdox
[x] prints a BDD style output to your tests
[x] lets you focus on the behavior