---
id: semantic-version
version: "2.10.0"
license: BSD
license_treatment: permissive
maintenance: dormant
---

# semantic-version — A library implementing the 'SemVer' scheme.

License: permissive · Maintenance: dormant · Popularity: top 1,000 on PyPI

## Install

pip install semantic-version
uv add semantic-version
poetry add semantic-version

## Description

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

Links
-----

- Package on `PyPI`_: https://pypi.org/project/semantic-version/
- Doc on `ReadTheDocs <http://readthedocs.org/>`_: https://python-semanticversion.readthedocs.io/
- Source on `GitHub...

## AI interpretation — verify before relying

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.

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.

[View on SkillFed](https://skillfed.io/packages/semantic-version) · [View on PyPI](https://pypi.org/project/semantic-version/)