Skip to main content

Utilities to create temporary file hierarchies in pytest.

Project description

Last release Python version Documentation Test status Test coverage Last commit

pytest_tmp_files is a pytest plugin that provides a fixture for creating temporary file hierarchies. This fixture is called tmp_files, and you can think of it as an extension of the built-in tmp_path fixture. In addition to creating a unique temporary directory for each test, tmp_files also fills in that directory with any files needed for that test.

The files to create are specified by a dictionary provided to fixture via indirect parametrization. For example, here’s a test for a function that searches for files whose contents match a given regular expression:

import pytest, re
from pathlib import Path

def find_text(top, pattern):
    hits = set()

    for path in Path(top).glob('**/*'):
        if path.is_file() and re.search(pattern, path.read_text()):
            hits.add(path)

    return hits

@pytest.mark.parametrize(
    'tmp_files, pattern, expected', [
        ({'a': 'x'}, 'x', {'a'}),
        ({'a': 'x'}, 'y', set()),
        ({'a/b': 'x'}, 'x', {'a/b'}),
        ({'a/b': 'x'}, 'y', set()),
        ({'a/b': 'x', 'c': 'y'}, 'x', {'a/b'}),
        ({'a/b': 'x', 'c': 'y'}, 'y', {'c'}),
        ({'a/b': 'x', 'c': 'y'}, '[xy]', {'a/b', 'c'}),
    ],
    indirect=['tmp_files'],
)
def test_find_text(tmp_files, pattern, expected):
    expected = {
            tmp_files / p
            for p in expected
    }
    assert find_text(tmp_files, pattern) == expected

The first parameter in each set (the dictionary) specifies the files to create. The keys are file paths and the values are file contents, so {'a/b': 'x'} specifies a subdirectory a containing a text file b with the contents x. Although not shown here, it’s also possible to create different kinds of files (e.g. binary files, symlinks, hard links, named FIFOs) and to specify file metadata (e.g. permissions, modification times).

If this plugin sounds useful to you, you may also be interested in Parametrize From File. These two packages work really well together, because tmp_files lends itself to long, multi-line parameters and Parametrize From File makes such parameters easier to manage.

Check out the documentation for more information.

Project details


Download files

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

Source Distribution

pytest_tmp_files-0.0.2.tar.gz (5.7 kB view details)

Uploaded Source

Built Distribution

pytest_tmp_files-0.0.2-py3-none-any.whl (6.6 kB view details)

Uploaded Python 3

File details

Details for the file pytest_tmp_files-0.0.2.tar.gz.

File metadata

  • Download URL: pytest_tmp_files-0.0.2.tar.gz
  • Upload date:
  • Size: 5.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/35.0 requests/2.31.0 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.62.3 importlib-metadata/4.11.3 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.10.0

File hashes

Hashes for pytest_tmp_files-0.0.2.tar.gz
Algorithm Hash digest
SHA256 9b2c98559d4d79c0f44b49d9010d65b2508a68c21312d51d50363f005e718666
MD5 2c961125eed2f70812da59c98ddd5492
BLAKE2b-256 036347b7aca34b6f496eea6525a44e773d72c8bdc5be5a63cc83734c94701267

See more details on using hashes here.

File details

Details for the file pytest_tmp_files-0.0.2-py3-none-any.whl.

File metadata

  • Download URL: pytest_tmp_files-0.0.2-py3-none-any.whl
  • Upload date:
  • Size: 6.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/35.0 requests/2.31.0 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.62.3 importlib-metadata/4.11.3 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.10.0

File hashes

Hashes for pytest_tmp_files-0.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 47ff5267063285c5388137c284fc46d26bbbf0331e6b2c68bc9815fe116d5a29
MD5 bf3d1752d7aefa145982141009f4507b
BLAKE2b-256 5a9d572fccbc32e03334c6154cdcd6b0b0679e52ae3961d68074263b4aa2ac51

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page