pytest-resources 0.1.0__tar.gz

pytest_resources-0.1.0/.gitignore

@@ -0,0 +1,218 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#   Usually these files are written by a python script from a template
+#   before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+# Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+# uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+# poetry.lock
+# poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+# pdm.lock
+# pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+# pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# Redis
+*.rdb
+*.aof
+*.pid
+
+# RabbitMQ
+mnesia/
+rabbitmq/
+rabbitmq-data/
+
+# ActiveMQ
+activemq-data/
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#   JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#   be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#   and can be added to the global gitignore or merged into this file.  For a more nuclear
+#   option (not recommended) you can uncomment the following to ignore the entire idea folder.
+# .idea/
+
+# Abstra
+#   Abstra is an AI-powered process automation framework.
+#   Ignore directories containing user credentials, local state, and settings.
+#   Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#   Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#   that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#   and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#   you could uncomment the following to ignore the entire vscode folder
+# .vscode/
+# Temporary file for partial code execution
+tempCodeRunnerFile.py
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+
+# Streamlit
+.streamlit/secrets.toml

pytest_resources-0.1.0/CHANGELOG.md

@@ -0,0 +1,39 @@
+# Changelog
+
+All notable changes to **pytest-resources** are documented here.
+The format follows [Keep a Changelog](https://keepachangelog.com/) and the project
+adheres to [Semantic Versioning](https://semver.org/).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-09-23
+
+First release.
+
+### Added
+
+- `resources` pytest fixture: a session-scoped, lazy index over one or more resource
+  directories, navigable as an attribute / item / iterable tree
+  (`r.a.b`, `r["a"]["b"]`, `list(r.a)`, `.keys()/.values()/.items()`, `in`, `len`).
+- `FileType` (`StrEnum`) resolving extensions to canonical kinds through a frozen suffix
+  table; anything unknown resolves to `BINARY`.
+- A pluggable loader table (`default_loaders`) that prefers
+  [`e-serde`](https://pypi.org/project/e-serde/) native codecs (JSON / JSONC / YAML / TOML /
+  INI) when installed and falls back to the standard library (`json` + `tomllib`); kinds
+  with no parser return raw `bytes`. e-serde is an optional `[serde]` extra, never a core
+  dependency.
+- Extraction helpers on every node: `select` / `first` (filtered values), `paths` (file
+  paths), `walk` / `awalk` (recursive, sync and async), `similar` (fuzzy stem match),
+  `choice` (randomised pick) and `as_dict` (nested dict export).
+- Root configuration: `--resources-root` (repeatable), the `resources_root` ini list, and
+  the `pytest_resources_roots` hook for contributions; multiple roots are merged into one
+  tree, with the later root winning a top-level clash. The fixture creates a missing root;
+  the programmatic API stays strict.
+- A `pytest_resource_loaders(register)` hook to bind or override any codec declaratively.
+- Programmatic `build_resources` / `abuild_resources` (sync and off-the-loop), each taking a
+  single path or a sequence of paths.
+- 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.1.0...HEAD
+[0.1.0]: https://github.com/damvolkov/pytest-resources/releases/tag/v0.1.0

pytest_resources-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Damien Volkov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pytest_resources-0.1.0/PKG-INFO

@@ -0,0 +1,139 @@
+Metadata-Version: 2.5
+Name: pytest-resources
+Version: 0.1.0
+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
+Project-URL: Issues, https://github.com/damvolkov/pytest-resources/issues
+Project-URL: Changelog, https://github.com/damvolkov/pytest-resources/blob/main/CHANGELOG.md
+Author-email: damvolkov <damvolkovv@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: config,e-serde,fixtures,json,pytest,pytest-plugin,resources,testing,toml,yaml
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: Pytest
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Testing
+Classifier: Typing :: Typed
+Requires-Python: >=3.14
+Requires-Dist: pytest>=8.0
+Provides-Extra: serde
+Requires-Dist: e-serde<0.3,>=0.2.0; extra == 'serde'
+Description-Content-Type: text/markdown
+
+# pytest-resources
+
+Lazy, typed, attribute-navigable fixtures for test resource files — JSON / JSONC / YAML /
+TOML / INI decoded through [`e-serde`](https://pypi.org/project/e-serde/) by default,
+extensible to **any** canonical `bytes -> object` loader, and anything else handed back as
+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:
+
+```python
+import pytest_resources as pr
+
+def test_profile(resources: pr.Resources):
+    user = resources.structured.user          # sample dir -> dict (decoded, cached)
+    body = resources.unstructured.intro       # a .md -> str
+    blob = resources.binary.logo              # no codec bound -> raw bytes
+
+    jsons = resources.data.select("*.json")   # filter a folder (glob / regex / kind)
+    pick = resources.data.choice("*.json")    # random pick, seeded per run
+```
+
+## Install
+
+```bash
+uv add --group test "pytest-resources[serde]"   # e-serde default codecs
+uv add --group test pytest-resources            # stdlib-only (json + tomllib)
+```
+
+The `resources` fixture auto-loads via the `pytest11` entry point — no imports in your
+`conftest.py`.
+
+## What you get
+
+| Idea | Mechanism |
+|---|---|
+| **Recursive index, zero read** | each root is walked once (off the loop); only paths are held |
+| **Lazy + cached** | a file decodes on first access and is memoized for the session |
+| **Attr / item / iter views** | `r.a.b`, `r["a"]["b"]`, `list(r.a)` → list of decoded values |
+| **Extract from a folder** | `select`/`first` · `paths` · `walk`/`awalk` (sync/async, lazy) · `similar` (fuzzy) · `as_dict`, by glob / regex / `kind` |
+| **Randomise the pick** | `r.a.choice(...)` (session-seeded) or pass your own `rng` |
+| **Typed by suffix** | `FileType` (`StrEnum`) resolves the extension; the loader table decodes |
+| **Open-ended fallback** | `CSV`/`TSV`/`PDF`/… and any unknown kind stay raw `bytes` |
+| **Many roots, one tree** | CLI / ini / `pytest_resources_roots` hook, merged (later wins), auto-created |
+| **Pluggable codecs** | override or add any kind through the `pytest_resource_loaders` hook |
+| **e-serde default, optional** | native Rust/C config codecs when installed; stdlib otherwise |
+| **Friendly misses** | `EntryNotFoundError` / `KeyError` carry a "did you mean" hint |
+
+## Configuring the roots
+
+By default the plugin indexes `<rootdir>/tests/resources` (and **creates it if missing**).
+Point it at one or several directories:
+
+```toml
+# pyproject.toml
+[tool.pytest.ini_options]
+resources_root = ["fixtures", "fixtures/shared"]   # default: <rootdir>/tests/resources
+```
+
+Or per run (`--resources-root` is repeatable), or additively from your `conftest.py`:
+
+```python
+from pathlib import Path
+
+def pytest_resources_roots(roots):
+    roots.append(Path("tests/fixtures/shared"))
+```
+
+CLI wins over ini, which wins over the default. Every resolved root is merged into one
+navigable tree; on a top-level clash the **later** root wins.
+
+## Custom loaders (the extension seam)
+
+The plugin never assumes e-serde. Bind any parser declaratively in your `conftest.py`:
+
+```python
+from pytest_resources import FileType
+import yaml, csv, io
+
+def pytest_resource_loaders(register):
+    register({FileType.CSV: lambda b: list(csv.DictReader(io.StringIO(b.decode())))})
+    register({FileType.YAML: yaml.safe_load})
+```
+
+`register` merges into the session's table, so you can override a default kind as easily
+as add an unknown one. Kinds left unbound hand back **raw bytes**.
+
+## Programmatic use
+
+Outside pytest, build a tree yourself:
+
+```python
+from pathlib import Path
+import pytest_resources as pr
+
+tree = pr.build_resources(Path("fixtures"))                      # sync, one root
+tree = pr.build_resources([Path("a"), Path("b")])               # merged roots, later wins
+tree = await pr.abuild_resources(Path("fixtures"))              # off the event loop
+table = pr.default_loaders()                                    # best available codecs
+```
+
+## Development
+
+```bash
+make install   # uv sync + git hooks
+make check     # ruff + ty + tach + validate + tests
+make ci        # everything the pipeline runs (adds coverage gate + docs + zizmor)
+```
+
+## License
+
+MIT

pytest_resources-0.1.0/README.md

@@ -0,0 +1,113 @@
+# pytest-resources
+
+Lazy, typed, attribute-navigable fixtures for test resource files — JSON / JSONC / YAML /
+TOML / INI decoded through [`e-serde`](https://pypi.org/project/e-serde/) by default,
+extensible to **any** canonical `bytes -> object` loader, and anything else handed back as
+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:
+
+```python
+import pytest_resources as pr
+
+def test_profile(resources: pr.Resources):
+    user = resources.structured.user          # sample dir -> dict (decoded, cached)
+    body = resources.unstructured.intro       # a .md -> str
+    blob = resources.binary.logo              # no codec bound -> raw bytes
+
+    jsons = resources.data.select("*.json")   # filter a folder (glob / regex / kind)
+    pick = resources.data.choice("*.json")    # random pick, seeded per run
+```
+
+## Install
+
+```bash
+uv add --group test "pytest-resources[serde]"   # e-serde default codecs
+uv add --group test pytest-resources            # stdlib-only (json + tomllib)
+```
+
+The `resources` fixture auto-loads via the `pytest11` entry point — no imports in your
+`conftest.py`.
+
+## What you get
+
+| Idea | Mechanism |
+|---|---|
+| **Recursive index, zero read** | each root is walked once (off the loop); only paths are held |
+| **Lazy + cached** | a file decodes on first access and is memoized for the session |
+| **Attr / item / iter views** | `r.a.b`, `r["a"]["b"]`, `list(r.a)` → list of decoded values |
+| **Extract from a folder** | `select`/`first` · `paths` · `walk`/`awalk` (sync/async, lazy) · `similar` (fuzzy) · `as_dict`, by glob / regex / `kind` |
+| **Randomise the pick** | `r.a.choice(...)` (session-seeded) or pass your own `rng` |
+| **Typed by suffix** | `FileType` (`StrEnum`) resolves the extension; the loader table decodes |
+| **Open-ended fallback** | `CSV`/`TSV`/`PDF`/… and any unknown kind stay raw `bytes` |
+| **Many roots, one tree** | CLI / ini / `pytest_resources_roots` hook, merged (later wins), auto-created |
+| **Pluggable codecs** | override or add any kind through the `pytest_resource_loaders` hook |
+| **e-serde default, optional** | native Rust/C config codecs when installed; stdlib otherwise |
+| **Friendly misses** | `EntryNotFoundError` / `KeyError` carry a "did you mean" hint |
+
+## Configuring the roots
+
+By default the plugin indexes `<rootdir>/tests/resources` (and **creates it if missing**).
+Point it at one or several directories:
+
+```toml
+# pyproject.toml
+[tool.pytest.ini_options]
+resources_root = ["fixtures", "fixtures/shared"]   # default: <rootdir>/tests/resources
+```
+
+Or per run (`--resources-root` is repeatable), or additively from your `conftest.py`:
+
+```python
+from pathlib import Path
+
+def pytest_resources_roots(roots):
+    roots.append(Path("tests/fixtures/shared"))
+```
+
+CLI wins over ini, which wins over the default. Every resolved root is merged into one
+navigable tree; on a top-level clash the **later** root wins.
+
+## Custom loaders (the extension seam)
+
+The plugin never assumes e-serde. Bind any parser declaratively in your `conftest.py`:
+
+```python
+from pytest_resources import FileType
+import yaml, csv, io
+
+def pytest_resource_loaders(register):
+    register({FileType.CSV: lambda b: list(csv.DictReader(io.StringIO(b.decode())))})
+    register({FileType.YAML: yaml.safe_load})
+```
+
+`register` merges into the session's table, so you can override a default kind as easily
+as add an unknown one. Kinds left unbound hand back **raw bytes**.
+
+## Programmatic use
+
+Outside pytest, build a tree yourself:
+
+```python
+from pathlib import Path
+import pytest_resources as pr
+
+tree = pr.build_resources(Path("fixtures"))                      # sync, one root
+tree = pr.build_resources([Path("a"), Path("b")])               # merged roots, later wins
+tree = await pr.abuild_resources(Path("fixtures"))              # off the event loop
+table = pr.default_loaders()                                    # best available codecs
+```
+
+## Development
+
+```bash
+make install   # uv sync + git hooks
+make check     # ruff + ty + tach + validate + tests
+make ci        # everything the pipeline runs (adds coverage gate + docs + zizmor)
+```
+
+## License
+
+MIT

pytest_resources-0.1.0/pyproject.toml

@@ -0,0 +1,158 @@
+##### BUILD #####
+[build-system]
+requires = ["hatchling>=1.32", "uv-dynamic-versioning>=0.14"]
+build-backend = "hatchling.build"
+
+##### PROJECT #####
+[project]
+name = "pytest-resources"
+dynamic = ["version"]
+description = "Lazy, typed, attribute-navigable fixtures for test resource files, with pluggable canonical loaders (e-serde by default)."
+readme = "README.md"
+requires-python = ">=3.14"
+license = "MIT"
+license-files = ["LICEN[CS]E*"]
+authors = [{ name = "damvolkov", email = "damvolkovv@gmail.com" }]
+keywords = ["pytest", "pytest-plugin", "fixtures", "resources", "config", "e-serde", "json", "yaml", "toml", "testing"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Framework :: Pytest",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development :: Testing",
+    "Typing :: Typed",
+]
+dependencies = ["pytest>=8.0"]
+
+[project.optional-dependencies]
+serde = ["e-serde>=0.2.0,<0.3"]
+
+[project.urls]
+Homepage = "https://github.com/damvolkov/pytest-resources"
+Source = "https://github.com/damvolkov/pytest-resources"
+Issues = "https://github.com/damvolkov/pytest-resources/issues"
+Changelog = "https://github.com/damvolkov/pytest-resources/blob/main/CHANGELOG.md"
+
+[project.entry-points."pytest11"]
+resources = "pytest_resources.plugin"
+
+##### DEPS #####
+[dependency-groups]
+lint = [
+    "ruff>=0.16",
+    "ty>=0.0.75",
+    "tach>=0.35",
+    "validate-pyproject[all]>=0.26",
+    "zizmor>=1.25",
+]
+test = [
+    "pytest>=9.1",
+    "pytest-asyncio>=1.4",
+    "pytest-cov>=7.1",
+    "pytest-randomly>=5.0",
+    "pytest-timeout>=2.4",
+    "e-serde>=0.2.0,<0.3",
+]
+docs = [
+    "mkdocs-gen-files>=0.6",
+    "mkdocs-literate-nav>=0.6",
+    "mkdocs-material>=9.7",
+    "mkdocs-section-index>=0.3",
+    "mkdocstrings[python]>=1.0",
+]
+dev = [
+    { include-group = "lint" },
+    { include-group = "test" },
+    { include-group = "docs" },
+    "prek>=0.4",
+]
+
+[tool.uv]
+required-version = ">=0.12"
+default-groups = ["dev"]
+exclude-newer = "7 days"
+### e-serde is first-party and can publish same-day; exempt only it from the freshness guard.
+exclude-newer-package = { e-serde = "1 hour" }
+cache-keys = [{ file = "pyproject.toml" }, { git = { commit = true, tags = true } }]
+
+##### VERSION #####
+[tool.hatch.version]
+source = "uv-dynamic-versioning"
+
+[tool.uv-dynamic-versioning]
+vcs = "git"
+style = "pep440"
+bump = true
+fallback-version = "0.1.0"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/pytest_resources"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/", "tests/", "README.md", "CHANGELOG.md"]
+
+##### LINT #####
+[tool.ruff]
+line-length = 120
+target-version = "py314"
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = [
+    "F", "E", "W", "I", "N", "UP", "B", "A", "C4", "DTZ", "T10", "T20", "EM", "ISC",
+    "PIE", "PT", "RET", "SIM", "TID", "TC", "ARG", "PTH", "PL", "PERF", "FURB",
+    "ASYNC", "S", "BLE", "FBT", "LOG", "G", "RUF",
+]
+ignore = ["E501", "ISC001", "PLR0913"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = ["S101", "PLR2004", "ARG", "FBT", "S311"]
+
+[tool.ruff.lint.isort]
+known-first-party = ["pytest_resources", "tests"]
+
+[tool.ruff.lint.flake8-tidy-imports]
+ban-relative-imports = "all"
+
+[tool.ruff.format]
+docstring-code-format = true
+
+##### TYPES #####
+[tool.ty.environment]
+python-version = "3.14"
+
+[tool.ty.src]
+include = ["src", "tests"]
+
+[tool.ty.terminal]
+error-on-warning = true
+
+##### TEST #####
+[tool.pytest]
+minversion = "9.0"
+testpaths = ["tests"]
+### Block the pytest11 entry point so the plugin loads from conftest *after* coverage
+### starts (see tests/conftest.py); otherwise it is imported at startup and unmeasurable.
+addopts = ["--import-mode=importlib", "-ra", "-p", "no:resources"]
+strict = true
+filterwarnings = ["error"]
+timeout = "60"
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "session"
+markers = ["slow: slow tests (deselect with -m 'not slow')"]
+
+##### COVERAGE #####
+[tool.coverage.run]
+### Path source, not source_pkgs: a pytest11 plugin is imported at startup, before
+### coverage starts; package-name resolution then marks it "not measured".
+source = ["src/pytest_resources"]
+branch = true
+parallel = true
+
+[tool.coverage.report]
+fail_under = 90
+show_missing = true
+skip_covered = true
+exclude_also = ["if TYPE_CHECKING:", "@overload", "raise NotImplementedError", '^\s*\.\.\.$']