Skip to content

v0.1.1: --explain

Choose a tag to compare

@patrickballard patrickballard released this 08 Nov 23:34
· 294 commits to main since this release

New: --explain

When a package shows up as a gap, --explain lists the published wheels the target can't use and why, closest misses first:

armlib 1.4.0 on musl-aarch64: ● source
  armlib-1.4.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl  manylinux_2_17_aarch64 is a glibc wheel; musl (Alpine) needs musllinux

Reasons it reports: glibc wheel on musl (and vice versa), glibc/musl/macOS version newer than the target, wrong Python or ABI, and abi3 on free-threaded builds. --json --explain adds a rejected list per gap target.

If you think wheelgap got a package wrong, paste that output into an issue. No need to share your lockfile.

Also

  • Regression tests for the Alpine ARM trap: a manylinux_*_aarch64 wheel never counts for musl-aarch64. (Thanks to a suggestion on r/madeinpython.)
  • The summary line points to --explain when there are gaps.
  • Fixed "1 packages" in the header.
uvx wheelgap@0.1.1 --explain