check-wheel-contents
Check your wheels have the right contents
Decision gist · record as of 2026-08-14
Yes. This is a focused, well-maintained tool that solves a real problem in Python packaging—preventing subtle but common mistakes from reaching production. Low install friction, permissive license, no security vulnerabilities, and active maintenance make it a safe addition to any packaging workflow. Install it if you publish wheels to PyPI or maintain strict wheel quality standards.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or higher.
- Low install friction with seven straightforward dependencies.
- Actively maintained with recent commits; last release was 377 days ago and the repository shows ongoing activity.
License · maintenance · safety
MIT (permissive) — MIT license permits free use, modification, and distribution with minimal restrictions, making it suitable for both open-source and commercial projects.
last release 2025-08-02 (377 days) · last repo commit 2026-07-20 · 168 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 500,965 downloads/mo, #6,318 on PyPI
Alternatives
Verify before relying
pip install check-wheel-contents
check-wheel-contents path/to/wheel.whl
# With configuration file:
check-wheel-contents --config pyproject.toml path/to/wheel.whl- Whether the tool integrates with common CI/CD platforms or build systems beyond manual invocation
- Performance characteristics when checking large numbers of wheels or very large wheel files
What it is and what it does
check-wheel-contents is a command-line linter that inspects wheel archives for common packaging mistakes before they reach PyPI. It detects issues like compiled bytecode files (.pyc/.pyo), cache directories, test files, and mismatched top-level module declarations—problems that are easy to miss during manual review but break installations or bloat packages for end users.
The tool works by analyzing wheel contents against a configurable set of checks, each identified by a code (W001, W002, etc.). You point it at one or more wheels or directories, and it reports failures with specific file paths and guidance on fixes. Configuration can be read from pyproject.toml, setup.cfg, tox.ini, or a dedicated config file, allowing integration into build pipelines and project workflows.
Use it for
- Pre-upload validation in CI/CD to catch wheel defects before publishing to PyPI
- Local wheel inspection during development to verify packaging setup is correct
- Batch checking of wheels in a monorepo or multi-package project
- Enforcing consistent wheel structure across a team or organization
- Debugging why a published wheel contains unexpected files or missing modules
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
This is a focused, well-maintained tool that solves a real problem in Python packaging—preventing subtle but common mistakes from reaching production. Low install friction, permissive license, no security vulnerabilities, and active maintenance make it a safe addition to any packaging workflow. Install it if you publish wheels to PyPI or maintain strict wheel quality standards.
Install
check-wheel-contents on PyPI
Before you install
Low install friction with seven straightforward dependencies. Actively maintained with recent commits; last release was 377 days ago and the repository shows ongoing activity.
Requires Python 3.10 or higher.
License in practice
MIT license permits free use, modification, and distribution with minimal restrictions, making it suitable for both open-source and commercial projects.
Quickstart
pip install check-wheel-contents
check-wheel-contents path/to/wheel.whl
# With configuration file:
check-wheel-contents --config pyproject.toml path/to/wheel.whlVerify before relying
- Whether the tool integrates with common CI/CD platforms or build systems beyond manual invocation
- Performance characteristics when checking large numbers of wheels or very large wheel files
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 7 packagesattrsbackports-cached-propertyclickpackagingpydantictomliwheel-filename |
| Maintenance | Actively maintained 377 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 500,965 / month, #6,318 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Environment :: ConsoleIntended Audience :: DevelopersProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: Implementation :: CPythonProgramming Language :: Python :: Implementation :: PyPyTopic :: Software Development :: Build ToolsTopic :: Software Development :: Libraries :: Python ModulesTopic :: Software Development :: Quality Assurance |
Evidence: check_wheel_contents-0.6.3-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 › “wheel validation tool”
- check-wheel-contentsValidates wheel file contents before publishing, detecting common…
- abi3auditabi3audit scans Python extension wheels and shared objects for…
- wheel-filenameParse and validate wheel filenames according to PEP 427, extracting…
Give your agent the search over MCP, or paste the wish link into any chat.
More Python Modules packages
Converts domain names between Unicode and ASCII-compatible encoding (Punycode) according to IDNA 2008 and Unicode Technical Standard 46, with security validation and broader script coverage than the standard library.
Install it if you work with internationalized domain names, need to validate domains, or use HTTP clients that depend on it transitively.
Setuptools is a Python build backend and package management tool that handles building, distributing, and installing Python packages, including support for C/C++ extension modules.
PyYAML parses and emits YAML 1.1 data format, enabling serialization and deserialization of configuration files and Python objects to and from human-readable YAML text.
Pydantic validates Python data structures against type hints, coercing and checking input at runtime to ensure it matches a declared schema.
Provides reusable metadata objects for use with PEP-593 `typing.Annotated` to express common constraints like bounds, collection sizes, and predicates on types.
Install it if you use or build libraries that need to express type constraints in a standardized, inspectable way—or if you want to annotate your own types with…
Provides runtime tools to inspect and introspect Python type annotations, enabling programmatic examination of type hints at execution time.
See also check-manifest · pyc-wheel · change-wheel-version · gitmatch · pyclean · wheel · auditwheel · yamllint · editables · slipcover