wheel-filename
Parse wheel filenames
Decision gist · record as of 2026-08-14
Yes. This is a focused, well-maintained utility with no dependencies, permissive licensing, and active development. Install it if you work with wheel files, need to validate filenames, or extract compatibility metadata in packaging tools or build systems.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or higher.
- Low friction: pure Python, no runtime dependencies, and actively maintained with recent releases.
License · maintenance · safety
MIT (permissive) — MIT license permits unrestricted use, modification, and distribution with minimal obligations.
last release 2025-12-20 (237 days) · last repo commit 2026-07-20 · 16 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 587,226 downloads/mo, #5,876 on PyPI
Alternatives
Verify before relying
from wheel_filename import WheelFilename
pwf = WheelFilename.parse('pip-18.0-py2.py3-none-any.whl')
print(pwf.project, pwf.version, pwf.python_tags)What it is and what it does
wheel-filename is a lightweight parser for the standardized wheel binary distribution filename format. It takes a wheel filename (as a string, bytes, or path-like object) and parses it into its component parts: project name, version, optional build tag, and the three compatibility tag lists (Python, ABI, and platform). The parser adheres strictly to PEP 427 with minor exceptions: version components are not validated for PEP 440 compliance, and the .whl extension is matched case-insensitively.
The package provides both a Python API via the WheelFilename dataclass and a command-line tool. The dataclass offers methods to extract individual fields, compute build tag tuples for sorting, and generate all simple tag triples from the compatibility tags. It raises ParseError (a ValueError subclass) for invalid filenames. The CLI outputs parsed components as JSON, making it useful in build pipelines and packaging workflows.
Use it for
- Validate wheel filenames in a package repository or build system before processing.
- Extract compatibility tags to determine which Python versions and platforms a wheel supports.
- Parse wheel metadata in dependency resolution or package compatibility checking tools.
- Automate wheel filename generation or validation in CI/CD pipelines.
- Sort wheels by build tag in package management or distribution workflows.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
This is a focused, well-maintained utility with no dependencies, permissive licensing, and active development. Install it if you work with wheel files, need to validate filenames, or extract compatibility metadata in packaging tools or build systems.
Install
wheel-filename on PyPI
Before you install
Low friction: pure Python, no runtime dependencies, and actively maintained with recent releases. Requires Python 3.10 or higher.
Requires Python 3.10 or higher.
License in practice
MIT license permits unrestricted use, modification, and distribution with minimal obligations.
Quickstart
from wheel_filename import WheelFilename
pwf = WheelFilename.parse('pip-18.0-py2.py3-none-any.whl')
print(pwf.project, pwf.version, pwf.python_tags)Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Actively maintained 237 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 587,226 / month, #5,876 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableProgramming 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 :: 3.14Programming Language :: Python :: Implementation :: CPythonProgramming Language :: Python :: Implementation :: PyPyTopic :: System :: Software DistributionTyping :: Typed |
Evidence: wheel_filename-2.1.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 › “wheel filename parsing”
- wheel-filenameParse and validate wheel filenames according to PEP 427, extracting…
- pyrfc6266Parses RFC 6266 Content-Disposition headers to extract filename and…
- trollsiftTrollsift provides modules for parsing, formatting, and filtering…
Give your agent the search over MCP, or paste the wish link into any chat.
More Software Distribution packages
Pexpect spawns and controls interactive console applications by sending input and matching output patterns, automating tasks that would otherwise require manual interaction.
Automatically extracts and manages Python package versions from git or Mercurial metadata instead of hardcoding them, and includes SCM-tracked files in source distributions.
Extracts and queries package metadata from source distributions (sdists), binary distributions (wheels, eggs), and installed packages by reading PKG-INFO, EGG-INFO, or dist-info files.
Install it if you need to programmatically extract or inspect package metadata from distributions or installed packages.
Invoke is a Python library for defining and running shell commands and executable Python code as CLI-invokable tasks, with subprocess management and task organization.
Install it if you need to organize shell commands and Python code into CLI tasks without the overhead of larger frameworks or shell scripting.
Provides data models, validators, and serialization tools to create, read, and render CycloneDX Bill of Materials (BOM) documents in Python.
Install it if you are building tooling that needs to create, read, or validate CycloneDX documents; do not install it as a standalone SBOM generator—use CycloneDX…
Parses pip requirement files into structured data, extracting package names, version specifiers, and metadata like extras, URLs, and version control references.
See also wheel · guessit · auditwheel · cmeel · whey · packvers · pyproject-toml · sanitize-filename · pathvalidate · trollsift