Common fixtures for pytest
To use, just install it and pytest will automatically detect and load all fixtures:
pip install pytest-fixtures
To install automatically, add it to your test requirements in tox.ini or setup.py.
This package does not depend on any other packages and never will. It uses standard libraries or uses run-time imports and therefore it is lightweight to add to any project. As for which external run-time dependency a fixture needs, that is documented here and shouldn't matter as you would only use the fixtures that your project already has dependencies on.
Fixtures based on standard Python libraries
To get path, read, and write test data in tests/data folder, use the test_data fixture.
First, setup the path to test data path in tests/conftest.py:
from pathlib import Path
from fixtures import TestData
TestData.BASE_PATH = Path(__file__).parent / 'data'
And then get path to data files in tests/data using test_data fixture:
def test_integration(test_data):
obj = MyClass(test_data.path('sample.csv'))
To write out test data:
def test_integration(test_data):
output = run_cli()
test_data.write('test_integration.output', output)
Then read the test data to assert:
def test_integration(test_data):
output = run_cli()
expected_output = test_data.read('test_integration.output')
assert expected_output == output
Fixtures for Click <http://click.pocoo.org/>
To invoke, assert exit, with stdout/stderr outputs on error:
.. code-block:: python
- def test_cli(cli_runner):
- result = cli_runner.invoke( ... ) # Prints out stdout/stderr from result with headings result = cli_runner.invoke_and_assert_exit(0, ... ) # Same as above and asserts exit code == 0