docs: warn about wrong-package PyPI download counts

The pypi downloads sweep looks up counts by README display name; when
the display name differs from the canonical package, the row silently
measures an unrelated squatter or a dead predecessor. Document the
failure mode in both the fetcher's docstring and the audit skill so
famous entries with off-looking counts get identity-verified before
being cited.

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Vinta Chen 2026-08-16 15:57:15 +08:00
parent 194b386d06
commit 39eeab7dff
2 changed files with 6 additions and 2 deletions

View file

@ -12,7 +12,11 @@ excludes mirrors by default.
This script is the sole writer of data/pypi_downloads.tsv and rewrites it
from scratch each run, so entries removed from README.md drop out
naturally; names with no PyPI rows are written as NOT_FOUND. The file
naturally; names with no PyPI rows are written as NOT_FOUND. Counts are
looked up by README display name: when the display name differs from the
canonical PyPI package, the row silently measures the wrong package (a
squatter or a dead predecessor) — verify identity at
pypi.org/pypi/{name}/json before citing a count. The file
starts with a header row (name, downloads, fetched_at) and every row
carries the sweep date: a cache fetched within the last 7 days is current
enough for audit verdicts, so only re-run when older. Cross-checks