versions
Parsing, inspecting and specifying versions.
Decision gist · record as of 2026-08-14
Yes, if you need robust version parsing and matching in your application. The package is production-stable, permissively licensed, has zero known vulnerabilities, and carries low install friction. The main caveat is dormant maintenance—last release was 900 days ago—so if you encounter a bug or need a feature, expect slow or no response. For straightforward version handling, it's a solid choice; for active development requiring rapid fixes, consider the maintenance lag.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.8 or above.
- Low install friction; pure Python wheel.
- Maintenance is dormant—last release was 900 days ago, though the repository remains active with a recent commit.
License · maintenance · safety
MIT (permissive) — MIT license is permissive; you can use this package freely in commercial and private projects with minimal restrictions, provided you retain the license notice.
last release 2024-02-26 (900 days) · last repo commit 2024-06-14 · 7 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 98,638 downloads/mo, #13,068 on PyPI
Alternatives
Verify before relying
from versions import parse_version, parse_version_set
version = parse_version("1.3.0")
version_set = parse_version_set("^1.0.0")
print(version.matches(version_set)) # True- Whether the package handles all version specification edge cases or has known limitations.
- Performance characteristics when parsing or comparing large numbers of versions.
- Whether dormant status means the package will receive security updates if vulnerabilities are discovered.
What it is and what it does
versions is a semantic version parser and matcher for Python. It parses version strings into structured objects with named segments (release, pre-release, dev, local), supports total ordering for comparison, and can match versions against specification sets or individual specifiers. The package also provides utilities to extract version attributes from Python modules.
The library is built on a stack of utility dependencies and is fully typed. It's useful when you need to programmatically work with version constraints—parsing user input, comparing releases, or checking whether a given version satisfies a requirement—rather than relying on string comparison or external tools.
Use it for
- Parse and compare semantic versions in dependency resolution or package management workflows.
- Match a given version against a version set or specifier to validate compatibility.
- Extract and inspect version components from version strings programmatically.
- Programmatically check version requirements in build scripts or runtime version guards.
- Access the __version__ attribute of installed packages for logging or compatibility checks.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need robust version parsing and matching in your application.
The package is production-stable, permissively licensed, has zero known vulnerabilities, and carries low install friction. The main caveat is dormant maintenance—last release was 900 days ago—so if you encounter a bug or need a feature, expect slow or no response. For straightforward version handling, it's a solid choice; for active development requiring rapid fixes, consider the maintenance lag.
Install
versions on PyPI
Before you install
Low install friction; pure Python wheel. Maintenance is dormant—last release was 900 days ago, though the repository remains active with a recent commit. The package is marked production/stable and supports Python 3.8 through 3.12.
Requires Python 3.8 or above.
License in practice
MIT license is permissive; you can use this package freely in commercial and private projects with minimal restrictions, provided you retain the license notice.
Quickstart
from versions import parse_version, parse_version_set
version = parse_version("1.3.0")
version_set = parse_version_set("^1.0.0")
print(version.matches(version_set)) # TrueVerify before relying
- Whether the package handles all version specification edge cases or has known limitations.
- Performance characteristics when parsing or comparing large numbers of versions.
- Whether dormant status means the package will receive security updates if vulnerabilities are discovered.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.8 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 9 packagesattrstyping-aliasestyping-extensionsclickfuncsitersorderingssolusentrypoint |
| Maintenance | Dormant 900 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 98,638 / month, #13,068 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/StableIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Topic :: UtilitiesTyping :: Typed |
Evidence: versions-2.1.2-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 › “semantic version parsing”
- versionsParses, compares, and validates semantic versions and version…
- semverParse, compare, and manipulate semantic version strings following the…
- semantic-versionParses, validates, and compares semantic version strings according to…
Give your agent the search over MCP, or paste the wish link into any chat.
More Utilities 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.
Detects and normalizes text encoding from unknown or ambiguous sources, supporting all IANA character sets that Python's core library provides codecs for, with the ability to register custom codecs.
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.
Pluggy provides a plugin system that lets you define hook specifications and register implementations to be called in sequence, enabling extensible Python applications without tight coupling.
Install it if you're building an extensible application or framework.
Pygments is a syntax highlighter that colorizes source code and text in over 500 languages and formats, outputting to HTML, LaTeX, RTF, SVG, images, or ANSI terminal sequences.
Install it if you need to display or transform source code.
Six provides utility functions to write Python code that runs on both Python 2.7 and Python 3.3+, smoothing over language differences between the two versions.
See also verspec · version-parser · semver · node-semver · orderings · single-source · python-semantic-release · packaging · autosemver · okonomiyaki