38 of 76 package doctests are broken (hidden by `testpaths`)

[thorwhalen]

Summary

38 of 76 doctests in the uf/ package fail. They are currently invisible because [tool.pytest.ini_options] testpaths = ["tests"] scopes collection to tests/ only, so nothing under uf/ is doctested — locally or in CI.

testpaths was deliberately not widened during the 2026-07-30 rollout pass for exactly this reason: widening it first would have turned the repo red.

Fleet-level tracking of the mechanism (why testpaths silently disables package doctests despite the run-tests-uv root-dir input): i2mint/wads#56.

Order of work

1. Fix the doctests first, with testpaths left alone so the gate stays green while you work:

   python -m pytest uf --doctest-modules -q

2. Mirror the CI invocation when checking, because wads CI force-overrides doctest flags and drops NORMALIZE_WHITESPACE — whitespace-sensitive examples can pass locally and fail in CI:

   python -m pytest uf --doctest-modules -o doctest_optionflags='ELLIPSIS IGNORE_EXCEPTION_DETAIL' -q

3. Only when they pass, widen testpaths to ["uf", "tests"] and confirm the collected-item count actually rises:

   python -m pytest --collect-only -q

Caution

Some of these doctests may exercise the ju integration, which behaves differently under the except ImportError fallback documented in the sibling issue in this repo. Check whether a given doctest is asserting fallback behaviour or real ju behaviour before "fixing" its expected output — otherwise you may pin the degraded path.

Surfaced during the 2026-07-30 wave-0 rollout batch.