pytest-resources 0.2.0__tar.gz → 0.2.2__tar.gz

{pytest_resources-0.2.0 → pytest_resources-0.2.2}/.gitignore

@@ -210,7 +210,7 @@ tempCodeRunnerFile.py
 .pypirc
 
 # Local release secrets — never commit
-gh_token
+*_token
 *.token
 
 # Marimo

{pytest_resources-0.2.0 → pytest_resources-0.2.2}/CHANGELOG.md

@@ -6,6 +6,31 @@ adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.2.2] - 2026-09-24
+
+### Changed
+
+- Documentation: the synthesis surface (`make` / `batch` / `file`) is covered end to end,
+  with a new async-testing section (pure-CPU `make`/`batch`, `awalk` over adopted files,
+  off-loop `to_thread` for the network-backed `mp3`); the format matrix notes the document
+  and image kinds. The coverage floor is raised from 90% to 95% (current: 100%).
+
+### Added
+
+- Tests for `TypedDict` model synthesis, the `batch` default size, the extra synthetic file
+  suffixes, and the synthesis provider's memoization.
+
+No behavioural change to the packaged wheel.
+
+## [0.2.1] - 2026-09-24
+
+### Fixed
+
+- The test suite is now cross-platform: file formats that `faker-file`/Pillow cannot
+  synthesize on Windows/macOS (missing system font, temporary-file locks) skip with a reason
+  instead of failing, and the synthetic-text assertion compares against the loader's raw
+  byte decode. No change to shipped behaviour.
+
 ## [0.2.0] - 2026-09-24
 
 ### Added
@@ -54,6 +79,8 @@ First release.
 - A module-lifetime decode cache per tree, and typed misses (`EntryNotFoundError` /
   `KeyError`) that carry a `difflib` "did you mean" hint.
 
-[unreleased]: https://github.com/damvolkov/pytest-resources/compare/v0.2.0...HEAD
+[unreleased]: https://github.com/damvolkov/pytest-resources/compare/v0.2.2...HEAD
+[0.2.2]: https://github.com/damvolkov/pytest-resources/releases/tag/v0.2.2
+[0.2.1]: https://github.com/damvolkov/pytest-resources/releases/tag/v0.2.1
 [0.2.0]: https://github.com/damvolkov/pytest-resources/releases/tag/v0.2.0
 [0.1.0]: https://github.com/damvolkov/pytest-resources/releases/tag/v0.1.0

{pytest_resources-0.2.0 → pytest_resources-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: pytest-resources
-Version: 0.2.0
+Version: 0.2.2
 Summary: Lazy, typed, attribute-navigable fixtures for test resource files, with pluggable canonical loaders (e-serde by default).
 Project-URL: Homepage, https://github.com/damvolkov/pytest-resources
 Project-URL: Source, https://github.com/damvolkov/pytest-resources
@@ -39,12 +39,21 @@ extensible to **any** canonical `bytes -> object` loader, and anything else hand
 raw `bytes`.
 
 You point it at one or more directories of sample files; it recursively indexes the tree
-without reading anything, and you reach, filter and randomise parsed values the way they
-read:
+without reading anything, and you reach, filter, randomise and synthesize parsed values
+the way they read:
 
 ```python
+from dataclasses import dataclass
+
 import pytest_resources as pr
 
+
+@dataclass
+class User:
+    name: str
+    age: int
+
+
 def test_profile(resources: pr.Resources):
     user = resources.structured.user          # sample dir -> dict (decoded, cached)
     body = resources.unstructured.intro       # a .md -> str
@@ -69,7 +78,10 @@ uv add --group test "pytest-resources[random]"  # both
 ```
 
 The `resources` fixture auto-loads via the `pytest11` entry point — no imports in your
-`conftest.py`.
+`conftest.py`. Everything (index, navigation, synthesis) is async-test friendly:
+`make`/`batch` are pure in-memory CPU and `abuild_resources`/`awalk` keep the loop free;
+calling a synthesis method without its extra raises `ExtraNotInstalledError` with the
+exact install command — the plugin never hard-depends on polyfactory or faker-file.
 
 ## What you get
 

{pytest_resources-0.2.0 → pytest_resources-0.2.2}/README.md

@@ -6,12 +6,21 @@ extensible to **any** canonical `bytes -> object` loader, and anything else hand
 raw `bytes`.
 
 You point it at one or more directories of sample files; it recursively indexes the tree
-without reading anything, and you reach, filter and randomise parsed values the way they
-read:
+without reading anything, and you reach, filter, randomise and synthesize parsed values
+the way they read:
 
 ```python
+from dataclasses import dataclass
+
 import pytest_resources as pr
 
+
+@dataclass
+class User:
+    name: str
+    age: int
+
+
 def test_profile(resources: pr.Resources):
     user = resources.structured.user          # sample dir -> dict (decoded, cached)
     body = resources.unstructured.intro       # a .md -> str
@@ -36,7 +45,10 @@ uv add --group test "pytest-resources[random]"  # both
 ```
 
 The `resources` fixture auto-loads via the `pytest11` entry point — no imports in your
-`conftest.py`.
+`conftest.py`. Everything (index, navigation, synthesis) is async-test friendly:
+`make`/`batch` are pure in-memory CPU and `abuild_resources`/`awalk` keep the loop free;
+calling a synthesis method without its extra raises `ExtraNotInstalledError` with the
+exact install command — the plugin never hard-depends on polyfactory or faker-file.
 
 ## What you get
 

{pytest_resources-0.2.0 → pytest_resources-0.2.2}/pyproject.toml

@@ -160,7 +160,7 @@ branch = true
 parallel = true
 
 [tool.coverage.report]
-fail_under = 90
+fail_under = 95
 show_missing = true
 skip_covered = true
 exclude_also = ["if TYPE_CHECKING:", "@overload", "raise NotImplementedError", '^\s*\.\.\.$']

{pytest_resources-0.2.0 → pytest_resources-0.2.2}/tests/integration/test_synth_library.py

@@ -8,7 +8,7 @@ same loader table as any authored resource.
 from __future__ import annotations
 
 from dataclasses import dataclass
-from typing import TYPE_CHECKING, Any
+from typing import TYPE_CHECKING, Any, TypedDict
 
 import attrs
 import msgspec
@@ -45,6 +45,11 @@ class Book:
     pages: int
 
 
+class Row(TypedDict):
+    k: str
+    v: int
+
+
 @pytest.fixture
 def tree(tmp_path: Path) -> Resources:
     return pr.build_resources(tmp_path)
@@ -62,6 +67,18 @@ def test_make_autodetects_every_model_family(tree: Resources, model: type[Any])
     assert isinstance(tree.make(model), model)
 
 
+def test_make_builds_a_typeddict_model(tree: Resources) -> None:
+    row = tree.make(Row)
+    assert isinstance(row, dict)
+    assert set(row) == {"k", "v"}
+    assert isinstance(row["k"], str)
+    assert isinstance(row["v"], int)
+
+
+def test_batch_defaults_to_ten(tree: Resources) -> None:
+    assert len(tree.batch(User)) == 10
+
+
 def test_batch_returns_n_instances(tree: Resources) -> None:
     squad = tree.batch(User, 4)
     assert [type(item) for item in squad] == [User] * 4
@@ -120,7 +137,10 @@ def test_make_is_reproducible_under_a_seed(tree: Resources) -> None:
 )
 @pytest.mark.filterwarnings("ignore:imghdr was removed in Python 3.13:DeprecationWarning")
 def test_file_writes_a_real_non_empty_file(tree: Resources, kind: FileType) -> None:
-    path = tree.file(kind)
+    try:
+        path = tree.file(kind)
+    except OSError as exc:
+        pytest.skip(f"faker-file cannot synthesize {kind.value} here: {exc}")  # needs a system font / no temp lock
     assert path.exists()
     assert path.stat().st_size > 0
     assert pr.FileType.of_path(path) is kind
@@ -133,7 +153,7 @@ def test_file_resolves_a_suffix_from_a_filename(tree: Resources) -> None:
 
 def test_named_file_is_adopted_and_decoded_like_an_authored_one(tree: Resources) -> None:
     path = tree.file("txt", name="note")
-    assert tree.note == path.read_text()
+    assert tree.note == path.read_bytes().decode()  # the node value is exactly the loader's decode
     assert path in tree.paths("*.txt")
 
 
@@ -148,7 +168,10 @@ def test_csv_synthetic_stays_raw_bytes_until_a_loader_is_bound(tree: Resources)
 
 
 def test_choice_and_walk_see_synthetic_files(tree: Resources) -> None:
-    path = tree.file("png", name="logo")
+    try:
+        path = tree.file("png", name="logo")
+    except OSError as exc:
+        pytest.skip(f"faker-file cannot synthesize png here: {exc}")  # needs a system font
     assert tree.choice("*.png") == path.read_bytes()
     assert path in list(tree.walk("*.png"))
 

{pytest_resources-0.2.0 → pytest_resources-0.2.2}/tests/unit/test_formats.py

@@ -16,6 +16,16 @@ from pytest_resources import FileType
         (".cfg", FileType.INI),
         (".jsonl", FileType.NDJSON),
         (".md", FileType.MARKDOWN),
+        (".pdf", FileType.PDF),
+        (".docx", FileType.DOCX),
+        (".xlsx", FileType.XLSX),
+        (".jpg", FileType.JPEG),
+        (".jpeg", FileType.JPEG),
+        (".tif", FileType.TIFF),
+        (".tiff", FileType.TIFF),
+        (".webp", FileType.WEBP),
+        (".eml", FileType.EML),
+        (".zip", FileType.ZIP),
     ],
 )
 def test_filetype_of_known_suffix(suffix: str, expected: FileType) -> None:

{pytest_resources-0.2.0 → pytest_resources-0.2.2}/tests/unit/test_nodes_synth.py

@@ -9,6 +9,7 @@ from typing import TYPE_CHECKING
 import pytest
 
 from pytest_resources import build_resources
+from pytest_resources.synth import SynthProvider
 
 if TYPE_CHECKING:
     from pytest_resources.nodes import Resources
@@ -50,6 +51,17 @@ def test_synth_module_stays_unloaded_until_first_use(tree: Resources) -> None:
     assert tree._synth is None
 
 
+def test_synth_is_built_once_and_memoized(tree: Resources) -> None:
+    tree.make(int)
+    assert isinstance(tree._synth, SynthProvider)
+    assert tree._common_synth() is tree._synth
+
+
+def test_assigned_synth_is_not_rebuilt(tree: Resources) -> None:
+    tree._synth = stub = _StubProvider()
+    assert tree._common_synth() is stub
+
+
 def test_make_forwards_spec_seed_and_fields(tree: Resources) -> None:
     tree._synth = stub = _StubProvider()
     assert tree.make(User, seed=5, name="ada") == "OBJECT"