---
id: semver
version: "3.0.4"
license: Copyright (c) 2013, Konstantine Rybnikov All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are… (full text in the JSON record)
license_treatment: permissive
maintenance: active
---

# semver — Python helper for Semantic Versioning (https://semver.org)

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

## Install

pip install semver
uv add semver
poetry add semver

## Description

Quickstart
==========

.. teaser-begin

A Python module to simplify `semantic versioning`_.

|GHAction| |python-support| |downloads| |license| |docs| |black|
|openissues| |GHDiscussion|

.. teaser-end

The module follows the ``MAJOR.MINOR.PATCH`` style:

* ``MAJOR`` version when you make incompatible API changes,
* ``MINOR`` version when you add functionality in a backwards compatible manner, and
* ``PATCH`` version when you make backwards compatible bug fixes.

Additional labels for pre-release and build metadata are supported.

To import this library, use:

.. code-block:: python

    >>> import semver

Working with the library is quite straightforward. To turn a version string into the
different parts, use the ``semver.Version.parse`` function:

.. code-block:: python

    >>> ver = semver.Version.parse('1.2.3-pre.2+build.4')
    >>> ver.major
    1
    >>> ver.minor
    2
    >>> ver.patch
    3
    >>> ver.prerelease
    'pre.2'
    >>> ver.build
    'build.4'

To raise parts of a version, there are a couple of functions available for
you. The function ``semver.Version.bump_major`` leaves the original object untouched, but
returns a new ``semver.Version`` instance with the...

## AI interpretation — verify before relying

Parses, compares, and manipulates semantic version strings following the MAJOR.MINOR.PATCH format, with support for pre-release and build metadata.

Verdict: A stable, zero-dependency semantic versioning utility in active maintenance with broad Python support (3.7–3.14) and no known vulnerabilities. Permissive BSD license and top-1000 popularity make it a low-risk choice for version handling.

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