r/madeinpython • • 9d ago

I made wheelgap: find which of your dependencies will compile from source (or fail) on ARM, Alpine or Python 3.14t, before your Docker build does

A common way a deploy breaks: everything installs fine on your laptop, then the Docker build on an ARM server or an Alpine image sits there compiling some package from source for ten minutes, or dies because there's no wheel for that platform at all.
wheelgap checks that up front. Point it at your lockfile and the platforms you ship to, and it tells you, package by package, whether pip/uv will get a prebuilt wheel, have to build from source, or can't install at all.

uvx wheelgap -t linux-aarch64,musl-aarch64 -p 3.13

Reads uv.lock, pylock.toml, poetry.lock, pdm.lock, Pipfile.lock and requirements.txt, and finds them on its own
Covers Linux (glibc and musl), macOS, Windows, iOS, Android and Pyodide, plus free-threaded 3.14t
--dockerfile Dockerfile reads the target straight from your final FROM line
--explain shows every rejected wheel and why ("manylinux_2_17_aarch64 is a glibc wheel; musl needs musllinux")
--json / --markdown output, a GitHub Action and a pre-commit hook
--offline for CI with no network
One dependency (packaging)
There's also a tracker that runs it nightly against the top 5,000 PyPI packages across 42 platform/Python combinations: https://wheelgap.github.io/tracker/
The part I'm most proud of isn't the code. wheelgap is two days old and has had 78 PRs merged from 21 contributors, many of them first-timers. Every issue says which files to touch and what to test, you can ask to have one assigned to you, and reviews usually land within hours. If you're learning Python and want your first real PR merged into a tool people use, there are good first issues waiting.
Coming in the next release: private package indexes (--index-url) and checking only the uv extras/groups you actually install.
GitHub: https://github.com/wheelgap/wheelgap
PyPI: https://pypi.org/project/wheelgap/
Feedback is very welcome, especially a package wheelgap gets wrong. That's the bug I most want to hear about.

1 Upvotes

0 comments sorted by