[pattonw]

uv run pytest now measures coverage

[tool.pytest.ini_options] addopts carries --cov --cov-report=term-missing, so the README's uv run pytest prints the coverage table and enforces the committed fail_under floor exactly as CI does. The CI step drops the flags it no longer needs. A single file can be run without the floor:

uv run pytest --no-cov tests/<file>.py

testpaths = ["tests"] replaces the tests argument on the command line.

Sphinx docs

docs/ builds with sphinx, autodoc, napoleon, autodoc-typehints, autodoc_pydantic and myst on the pydata theme, from a docs dependency group. The index includes the README. Two hand-written pages: Arrays and metadata (the five metadata fields and their defaults, how a MetaDataFormat maps them onto attributes, and the four config file locations with their precedence) and Graph databases (attribute types, Vec, and the rule that an edge belongs to the ROI of its u endpoint on read and write). The API page is generated from the docstrings; three malformed `class:Roi` roles in array.py become :class:`Roi` . The docs workflow builds with -W on push to main and deploys to GitHub Pages; the README and [project.urls] link the site, which goes live with the first run on main. Ruff now excludes *.md, since ruff 0.17 formats code blocks inside Markdown.

Verified locally: uv run pytest passes the floor, uv run --group docs sphinx-build -W docs/source docs/build/html succeeds, ruff and ty clean.

Import time and test duration, tracked per commit

The tests job times its own uv run pytest and measures the cold import of funlib.persistence (benchmarks/run.py), and uploads the two numbers as an artifact from the floor-interpreter, highest-resolution cell. A new benchmark workflow runs when a tests run on main completes, downloads that artifact, creates the gh-pages branch if it is missing, and publishes with github-action-benchmark to gh-pages:dev/bench, with a comparison table in the job summary and a commit comment when a metric gets 1.5x worse. The docs gain a Benchmarks page that charts every metric from that data; the docs workflow now runs after each benchmark run (instead of on push) and copies dev/bench from gh-pages into the deployed site, so the charts carry the newest point and the action's own dashboard stays reachable under the docs site. Nothing runs the test suite twice.

The same setup runs end to end in pattonw/prototype-lib.

🤖 Generated with Claude Code