pytest-remaster 0.0.1a1

Golden master testing for pytest with automatic regeneration.

pytest-remaster

Golden master testing for pytest. Compare output against expected files, auto-regenerate on mismatch.

Example 1: directory per test case

Each test case is a directory with input files and numbered expected outputs:

tests/cases/
  greet/hello/
    command             # input
    expected_0.txt      # first expected output
  help/unknown/
    command
    expected_0.txt
    expected_1.txt      # multiple outputs supported

import pytest
from pytest_remaster import CaseData, GoldenMaster, discover_test_cases

CASES_DIR = Path(__file__).parent / "cases"

@pytest.mark.parametrize("case", discover_test_cases(CASES_DIR))
def test_command(case: CaseData, golden_master: GoldenMaster) -> None:
    cmd = (case.input / "command").read_text().strip()
    golden_master.check_all(lambda: my_app(cmd), case.input, suffix=".txt")

Example 2: one file per test case

Each test case is a source file, with expected output derived from the filename:

tests/functional/
  arguments.py          # input (source to lint)
  arguments.txt         # expected output
  anomalous.py
  anomalous.txt

import pytest
from pytest_remaster import CaseData, GoldenMaster, discover_test_files

FUNC_DIR = Path(__file__).parent / "functional"

@pytest.mark.parametrize("case", discover_test_files(FUNC_DIR, "*.py"))
def test_lint(case: CaseData, golden_master: GoldenMaster) -> None:
    golden_master.check(lambda: lint(case.input), case.expected(suffix=".txt"))

Both examples auto-update expected files on mismatch. Review the diff in git, rerun. Pass --no-remaster for strict comparison.

API

golden_master.check(actual, expected_path)

Compare one value against one expected file:

golden_master.check(output, case.expected(suffix=".txt"))
golden_master.check(data, path / "db.json", normalizer=json_normalizer)

Options: serializer=str, normalizer=None.

golden_master.check_all(actuals, directory)

Compare a list against expected_0, expected_1, ... files in a directory:

golden_master.check_all(lambda: my_app(cmd), case.input, suffix=".txt")

Options: serializer=str, normalizer=None, suffix="".

Discovery

discover_test_cases(base_dir)               # leaf directories → CaseData
discover_test_files(base_dir, "*.py")       # files by pattern → CaseData

CaseData.input is the source path. CaseData.expected(index, suffix) derives expected file paths.

FilePatchRegistry

Auto-load fixture files from case directories and patch mock targets:

from pytest_remaster import FilePatchRegistry

patcher = FilePatchRegistry()
patcher.register("api_result.json", target="myapp.api.call")
patcher.register("user.json", target="myapp.get_user", default=None)

@pytest.mark.parametrize("case", discover_test_cases(CASES_DIR))
@patcher.use
def test_command(case, golden_master):
    golden_master.check_all(lambda: my_app(case), case.input)

Options: target=None (load only), side_effect=True, loader=json.loads, case_param="case".

Configuration

[tool.pytest.ini_options]
remaster-by-default = false  # default: true