open/llm-ingestion-okf
1
0
Fork 0
Code Issues Releases 1 Activity

docs(install): measure the uv install channel and correct the per-tree wheel range

Browse source 
The comment on [tool.uv.sources] claimed the built wheel carries
`Requires-Dist: llm-ingestion-guard<0.3,>=0.2`. That is the `v0.4.0` tag's
range, not this tree's, and it had been stale since the pin moved. A wheel
built from this tree carries `<0.4,>=0.3`, measured against the built wheel.
The old value is kept and attributed to the tag it belongs to rather than
substituted, because it is still true there.

Five measurements were run before editing, on uv 0.9.8 with an empty cache,
because the plan of record was to REMOVE this entry and the README claim it
supports had never been measured in more than one form:

- uv, direct: the README one-command install resolves the guard from the
  tag's [tool.uv.sources]. Third independent confirmation (07-25, 08-20,
  08-21).
- uv, transitive: a separate consumer project naming only this package still
  resolves the guard from the entry, because this package reaches it as a git
  source. Not previously measured.
- pip, negative: installing this package alone fails with exactly the error
  the README names, and the message prints the tag's own range.
- pip, positive: the README's two commands in order install clean and import.
- core install: brings the guard and no binary parser packages.

The entry is therefore load-bearing, not scaffolding: a wheel carries
Requires-Dist and nothing else, so it cannot survive an index install, and
while the guard is off-index removing it would break the documented uv path.
No package index carries the guard today, which was the premise removal
depended on.

The README install block measured correct as published and is unchanged. Its
test count had drifted: 596 with the [extract] extra, 589 passed and 7 skipped
without, both measured today.

Wheel metadata is byte-identical before and after, so the change is inert.
This commit is contained in:
Kjell Tore Guttormsen 2026-08-21 21:10:28 +02:00
commit fb9812fbe7
2 changed files with 29 additions and 10 deletions
Download patch file Download diff file Expand all files Collapse all files

7
README.md
View file

@ -248,8 +248,11 @@ From a checkout, the test suite runs with:
.venv/bin/python -m pytest
```
The suite is the verification surface for everything above: 589 tests, run on
2026-08-13 against this branch. It is not shipped in an installed
The suite is the verification surface for everything above: 596 tests, run on
2026-08-21 against this branch with the `[extract]` extra installed. Without
the extra the same suite is 589 passed and 7 skipped, measured the same day:
the seven cover the parser path, and the tests holding the fail-fast rejection
for an uninstalled extra run in both. It is not shipped in an installed
distribution — `tests/` lives at the repository root, so this command needs a
clone rather than a `pip install`.