wheel-stub
wheel stub package build backend
Decision gist · record as of 2026-08-14
Yes, if you need to host wheels on a non-PyPI index and want users to install them with standard pip commands. The package is low-friction to install and has no runtime dependencies. However, maintenance is aging (189 days since last release), so verify it still works with your Python version and index before adopting in production. No known security vulnerabilities.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires a third-party package index URL configured in pyproject.toml; the wheel files must already exist on that index.
- Low friction: pure Python wheel with no runtime dependencies.
- Maintenance status is aging (189 days since last release), though the package is classified as Beta and supports current Python versions.
License · maintenance · safety
Apache-2.0 (permissive) — Apache-2.0 permissive license. The package vendors packaging (BSD 2-clause and Apache 2 dual licensed) and tomli (MIT licensed), all compatible with permissive use.
last release 2026-02-06 (189 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 1,757,558 downloads/mo, #3,587 on PyPI
Alternatives
Verify before relying
# In pyproject.toml, configure wheel-stub as build backend:
[build-system]
requires = ["wheel-stub"]
build-backend = "wheel_stub"
[tool.wheel-stub]
index_url = "https://pypi.example.com"
# Then build: python -m build --sdist- Whether the package is actively maintained or in maintenance mode (aging status, no recent commits visible).
- Real-world adoption and stability beyond the top-5000 download tier.
- Compatibility with specific third-party indexes and whether stub-only mode behavior is production-ready.
What it is and what it does
wheel-stub is a PEP 517 build backend that solves the problem of distributing wheels hosted on non-PyPI indexes while preserving the standard `pip install` user experience. Instead of requiring users to specify custom index URLs or download wheels manually, you configure wheel-stub in your pyproject.toml with a third-party index URL, and it generates a stub package on PyPI that redirects pip to fetch the actual wheel from that index.
The backend has no runtime dependencies and supports Python 3.8 through 3.13 on CPython and PyPy. It vendors its own copies of packaging and tomli to avoid external dependencies. Configuration is minimal: you specify the index URL and optionally control whether to error if the wheel cannot be found, or whether to include CUDA debuginfo in error messages.
Use it for
- Distribute specialized wheels from a third-party index without requiring users to configure custom pip settings.
- Create a PyPI presence for packages that must remain on a non-PyPI index due to licensing or dependency constraints.
- Simplify installation UX for end users who should not need to know about alternative package indexes.
- Bridge a third-party index and PyPI for packages that cannot be directly mirrored to PyPI.
- Host wheels on a dedicated index while letting users install via standard `pip install` commands.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need to host wheels on a non-PyPI index and want users to install them with standard pip commands.
The package is low-friction to install and has no runtime dependencies. However, maintenance is aging (189 days since last release), so verify it still works with your Python version and index before adopting in production. No known security vulnerabilities.
Install
wheel-stub on PyPI
Before you install
Low friction: pure Python wheel with no runtime dependencies. Maintenance status is aging (189 days since last release), though the package is classified as Beta and supports current Python versions.
Requires a third-party package index URL configured in pyproject.toml; the wheel files must already exist on that index.
License in practice
Apache-2.0 permissive license. The package vendors packaging (BSD 2-clause and Apache 2 dual licensed) and tomli (MIT licensed), all compatible with permissive use.
Quickstart
# In pyproject.toml, configure wheel-stub as build backend:
[build-system]
requires = ["wheel-stub"]
build-backend = "wheel_stub"
[tool.wheel-stub]
index_url = "https://pypi.example.com"
# Then build: python -m build --sdistVerify before relying
- Whether the package is actively maintained or in maintenance mode (aging status, no recent commits visible).
- Real-world adoption and stability beyond the top-5000 download tier.
- Compatibility with specific third-party indexes and whether stub-only mode behavior is production-ready.
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release >=3.8 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Aging 189 days since the last release |
| First released | |
| Downloads | 1,757,558 / month, #3,587 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaProgramming Language :: PythonProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Programming Language :: Python :: Implementation :: CPythonProgramming Language :: Python :: Implementation :: PyPy |
Evidence: wheel_stub-0.5.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “third-party package index redirect”
- wheel-stubA PEP 517 build backend that creates stub packages on PyPI pointing…
- SocketSwapSocketSwap intercepts and redirects network traffic from third-party…
- wurlitzerCaptures C-level stdout and stderr output in Python using os.dup2,…
Give your agent the search over MCP, or paste the wish link into any chat.
More Build Tools packages
Provides reusable utilities for Python packaging interoperability, including version handling, specifiers, markers, requirements, tags, and metadata parsing according to standards like PEP 440 and PEP 425.
Wraps any iterable to display a real-time progress bar in the terminal or Jupyter notebook, showing iteration count, elapsed time, and estimated time remaining.
pip is the standard installer for Python packages, enabling you to download and install packages from the Python Package Index and other indexes into your Python environment.
Hatchling is a standards-compliant Python build backend that handles packaging, metadata, and distribution of Python projects when configured in a project's pyproject.toml file.
Generates Python gRPC service stubs and message classes from Protocol Buffer definitions, enabling developers to build gRPC clients and servers.
pre-commit is a framework for installing and running git hooks written in any language before commits are made, automating code quality and validation checks across multi-language projects.
Install it if your team needs consistent, automated validation at commit time.
See also build · pip-install-test · pdm-pep517 · whey · cmeel · pep517 · whool · PyQt-builder · poetry-core · pip2pi