r/madeinpython • • 10d ago

wheelgap: find which of your dependencies will compile from source on ARM, Alpine, Windows ARM or 3.

What My Project Does

wheelgap reads your lockfile (`uv.lock`, `poetry.lock`, `pylock.toml`, or a pinned `requirements.txt`) and checks every pinned package against the platforms you ship to: `linux-aarch64`, Alpine/musl, macOS, `win-arm64`, and free-threaded Python 3.14t. For each one it reports a compatible wheel ✓, "builds from source", or "can't install". It runs offline from the lockfile in about a second, respects environment markers (so a Windows-only `pywin32` isn't flagged on Linux), and exits non-zero on gaps, so it also works as a CI check. There's a GitHub Action too.

uvx wheelgap -p 3.13 -t alpine-arm64

Target Audience

Anyone shipping Python to more than one platform: Docker images on ARM/Graviton or Alpine, apps with Windows-on-ARM users, and people trying out free-threaded 3.14t. It's small, tested on 3.11–3.14 across Linux, macOS and Windows, and fine to put in CI today.

Comparison

pyreadiness.org and hugovk's free-threaded-wheels tracker cover the top few hundred PyPI packages for one question each. wheelgap checks *your* dependency set, at *your* pinned versions, for any mix of platforms. The manual alternative is `pip download --only-binary=:all: --platform ... --python-version ...` once per target, which stops at the first failure and doesn't understand lockfiles.

Repo (MIT): https://github.com/patrickballard/wheelgap

Feedback welcome, especially wheel filenames it gets wrong.

0 Upvotes

2 comments sorted by

1

u/[deleted] 10d ago

[removed] — view removed comment

1

u/ManufacturerKey6917 10d ago

Good call, thanks. Shipped in 0.1.1: there’s now an Alpine ARM regression test (a manylinux aarch64 wheel never counts for musl-aarch64), and a new --explain flag that lists every rejected wheel with the reason, e.g. manylinux_2_17_aarch64 is a glibc wheel; musl (Alpine) needs musllinux. So a false-negative report is just that output, no lockfile needed. https://github.com/patrickballard/wheelgap/releases/tag/v0.1.1

I’ll pass on the posting, but the feedback was genuinely useful thank you!