semantic-version

A library implementing the 'SemVer' scheme.

semantic-version Permissive license BSD DORMANT ★ 293 v2.10.0 released 2022-05-26

Install

semantic-version on PyPI

pip

pip install semantic-version

uv

uv add semantic-version

poetry

poetry add semantic-version

Package facts

License	BSD (permissive)
Python support	supports the current Python release (>=2.7)
Install friction	low — pure-Python wheel
Runtime dependencies	none
Maintenance	dormant — 1,540 days since the last release
Last repo commit	2024-04-04
First released	2012-05-17
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: semantic_version-2.10.0-py2.py3-none-any.whl

Keywords: semantic version, versioning, version

Development Status :: 5 - Production/StableIntended Audience :: DevelopersLicense :: OSI Approved :: BSD LicenseOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 2.7Programming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.4Programming Language :: Python :: 3.5Programming Language :: Python :: 3.6Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Topic :: Software Development :: Libraries :: Python Modules

About semantic-version

from the package's own PyPI description — quoted content, verbatim

Introduction

This small python library provides a few tools to handle SemVer_ in Python. It follows strictly the 2.0.0 version of the SemVer scheme.

.. image:: https://github.com/rbarrois/python-semanticversion/actions/workflows/test.yml/badge.svg :target: https://github.com/rbarrois/python-semanticversion/actions/workflows/test.yml

.. image:: https://img.shields.io/pypi/v/semantic_version.svg :target: https://python-semanticversion.readthedocs.io/en/latest/changelog.html :alt: Latest Version

.. image:: https://img.shields.io/pypi/pyversions/semantic_version.svg :target: https://pypi.python.org/pypi/semantic_version/ :alt: Supported Python versions

.. image:: https://img.shields.io/pypi/wheel/semantic_version.svg :target: https://pypi.python.org/pypi/semantic_version/ :alt: Wheel status

.. image:: https://img.shields.io/pypi/l/semantic_version.svg :target: https://pypi.python.org/pypi/semantic_version/ :alt: License

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

semantic-version parses, compares, and manipulates semantic version strings according to the SemVer 2.0.0 specification, and supports version range matching via SimpleSpec and NpmSpec.

Low friction: pure Python wheel with zero runtime dependencies. Maintenance is dormant (1540 days since last release in May 2022, last commit April 2024), but the library is stable and marked Production/Stable; suitable for projects that need a mature, unchanging semver tool.

BSD permissive license allows commercial and private use with minimal restrictions; no copyleft obligations.

Usage

pip install semantic-version

import semantic_version

v = semantic_version.Version('1.2.3')
spec = semantic_version.SimpleSpec('>=1.0.0,<2.0.0')
if v in spec:
    print('Version matches spec')

Verdict: semantic-version is a stable, dependency-free library for SemVer 2.0.0 handling with no known vulnerabilities. Its dormant maintenance (last release May 2022) reflects the maturity of the semver spec itself rather than abandonment; it remains suitable for any project needing reliable version parsing and range matching without active development.

Needs verification

Whether the 1540-day gap since last release reflects intentional stability or reduced maintainer engagement
Current test coverage and CI status beyond the April 2024 commit date

semantic versioning librarysemver version parsingversion comparison pythonsemver range matchingversion specification matchingsemver 2.0.0 implementationversion bump helper