Skip to main content

Provides path for uniform access to test resources in isolated directory

Project description

pytest-resource-path

Test Test Coverage Maintainability Code Climate technical debt Updates Python versions PyPI - Downloads Twitter URL

Provides path for uniform access to test resources in isolated directory

Features

Let's isolate test resources from test code

The test which use test resource is not so many. If we place test resource with test code, these resources will fill the display area of explorer. Wouldn't it be more productive if the files or directories which is not related with almost tests wasn't usually displayed?

pytest-resource-path provides path for uniform access to test resources in isolated directory.

This pytest plugin assumes that test resource is placed under testresources directory directly under tests. (Don't worry, you can customize these directory names by pytest.ini)

tests/
+-- some_test_package/
|   +-- some_test_module.py
+-- testresources/
    +-- some_test_package/
        +-- some_test_module/

Installation

You can install "pytest-resource-path" via pip from PyPI:

pip install pytest-resource-path

Usage

Basic

You can use fixture resource_path which is pathlib.Path instance (absolte path).

def test_method(resource_path):
    text_test_resource = (resource_path / 'test_resource.txt').read_text()

When assume that above test_method is in tests/some_tests_package_some_test_module.py, you have to place test_resource.txt following directory:

tests/
+-- some_test_package/
|   +-- some_test_module.py
+-- testresources/
    +-- some_test_package/
        +-- some_test_module/
            +-- test_method/
                +-- test_resource.txt

If you want to omit directory per method, you can do:

def test_method(resource_path):
    text_test_resource = Path(f'{resource_path}.txt').read_text()

Note that the class name is not used in the path since It felt redundant in design.

Get path to test resources root directory

You can use fixture resource_path_root which is pathlib.Path instance (absolte path) pointing to testresources.

def test_method(resource_path_root):
    text_test_resource = (resource_path_root / 'test_resource.txt').read_text()
tests/
+-- some_test_package/
|   +-- some_test_module.py
+-- testresources/
    +-- test_resource.txt

This fixture may be your help duaring migration period of directory structure. Or, may be usiful to preapare common directory with some of tests.

def test_method(resource_path_root):
    text_test_resource = (resource_path_root / 'common/test_resource.txt').read_text()
tests/
+-- some_test_package/
|   +-- some_test_module.py
+-- testresources/
    +-- common/
        +-- test_resource.txt

How to customize directory names

To traverse directory structure, this plugin requires to fix directory names.

By default:

directory requires to be named
Root directory of tests tests
Root directory of test resources testresources

You can customize these required names by pytest.ini

Ex:

[pytest]
resource-path.directory-name-tests = integrationtests
resource-path.directory-name-test-resources = data

Above customize fits following directory strucure:

integrationtests/
+-- some_test_package/
|   +-- some_test_module.py
+-- data/
    +-- some_test_package/
        +-- some_test_module/

License

Distributed under the terms of the MIT license, "pytest-resource-path" is free and open source software

Issues

If you encounter any problems, please file an issue along with a detailed description.

Contributing

Contributions are very welcome. Please ensure the coverage at least stays the same before you submit a pull request.

Credits

This pytest plugin was generated with Cookiecutter along with @hackebrot's cookiecutter-pytest-plugin template.

Project details


Download files

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

Files for pytest-resource-path, version 1.2.1
Filename, size File type Python version Upload date Hashes
Filename, size pytest_resource_path-1.2.1-py3-none-any.whl (12.0 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size pytest-resource-path-1.2.1.tar.gz (11.0 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page