pytest-datadir

What it is and what it does

pytest-datadir is a pytest plugin that simplifies working with test data by providing fixtures that automatically locate and manage test data files. It supports two organizational patterns: module-specific data directories (named to match your test module) and a shared global data folder. The plugin copies data to temporary locations during test execution, ensuring test isolation and preventing accidental modifications to original files.

The package offers three main fixtures: datadir for module-specific data, shared_datadir for global test data, and lazy variants (lazy_datadir and lazy_shared_datadir) that defer copying until files are actually accessed. All fixtures return pathlib.Path objects, making file operations straightforward. It requires Python 3.8 or later and integrates seamlessly into existing pytest workflows.

Use it for

• Load fixture files (JSON, CSV, XML) in unit tests without modifying originals or managing temporary cleanup.
• Share common test data across multiple test modules via a global data directory.
• Test file I/O operations safely by working with isolated copies that don't affect the source data.
• Reduce test setup boilerplate by automatically discovering and preparing test data based on directory naming conventions.
• Optimize test performance with lazy_datadir when only a subset of test data files are needed per test.

Worth the install?

AI-flagged interpretation of the facts on this page. Verify before relying on it.

Install

pytest-datadir on PyPI

Before you install

Low friction: pure Python wheel with only pytest as a runtime dependency. Actively maintained with a recent release (2025-07-30) and no known vulnerabilities.

Requires Python 3.8 or later; test data directories must follow naming conventions (module-specific test_* folders or a global data folder).

License in practice

MIT license permits unrestricted use, modification, and distribution in both open-source and commercial projects with minimal obligations.

Quickstart

pip install pytest-datadir

# In test_hello.py with data/hello.txt and test_hello/spam.txt present:
from pathlib import Path

def test_read_global(shared_datadir):
    contents = (shared_datadir / "hello.txt").read_text()
    assert contents == "Hello World!\n"

def test_read_module(datadir):
    contents = (datadir / "spam.txt").read_text()
    assert contents == "eggs\n"

Package facts

Evidence: pytest_datadir-1.8.0-py3-none-any.whl

Tags

More Testing packages

See also pytest-regressions · pytest-container · pytest-redis · pytest-datafiles · pytest-mypy-plugins · pytest-pgsql · pytest-unused-fixtures · pytest-mypy · pytest-describe · pytest-cookies