[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

Sphinx docs

docs/ builds with sphinx, autodoc, napoleon, autodoc-typehints and myst on the pydata theme, from a docs dependency group. The index includes the README. A hand-written page states the rules of Coordinate and Roi: integer arithmetic and division, None as unbounded, half-open intervals, empty ROIs, grow with negative amounts, and the three snap_to_grid modes, with examples taken from the tests. The API page is generated from the docstrings (the Roi class docstring needed one blank line for docutils). 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.

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.geometry (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