NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI
PyPI, #1625 most downloaded on PyPI
Parse and manipulate version numbers.
Latest stable
1.0.1.post0
Last release 3 months ago
30 Jul 2026
Release timing varies
gaps range from 4 weeks to 2.6 years
Nearly every release is documented
notes for 10 of 11 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
11 releases · first in 2018
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
Support for Python 3.15. (#96 _)
Your coding agent can read these notes before it upgrades. Set up the MCP server →
BREAKING CHANGE. The ~parver.Version constructor is now keyword-only.
New parser which preserves case and leading zeros.
Improved error messages.
The following methods preserve leading zeros, and gain a new width argument.
~parver.Version.bump_epoch
~parver.Version.bump_release
~parver.Version.bump_release_to
~parver.Version.set_release
~parver.Version.bump_pre
~parver.Version.bump_post
~parver.Version.bump_dev
Support for non-standard development release tags, such as DEV, across:
~parver.Version.dev_tag
The dev_tag argument to ~parver.Version
The tag argument to ~parver.Version.bump_dev
Support for Python 3.13 and 3.14.
BREAKING CHANGE. The ~parver.Version constructor is now keyword-only.
BREAKING CHANGE. Version.parse() now requires strict to be passed as a keyword argument.
BREAKING CHANGE. Version.v now stores "v", "V", or None instead of True or False.
BREAKING CHANGE. dev_sep was renamed to ~parver.Version.dev_sep1.
Support for Python 3.8 and 3.9.
Development releases can now use a separator between dev and the following number as permitted by PEP 440. The separator is exposed as ~parver.Version.dev_sep2 and as a ~parver.Version keyword argument (#33).
Added ~~~~~ - Support for Python 3.12 Removed ~~~~~~~ - Support for Python 3.7
Support for Python 3.12
Support for Python 3.7
Support for Python 2.7, 3.5, and 3.6.
Type hints.
Support for Python 2.7, 3.5, and 3.6.
__version__, __author__, and __email__ attributes from parver module. Use importlib.metadata instead.
attrs deprecation warning. The minimum attrs version is now 19.2
Grammar is parsed when first used to improve import time.
attrs deprecation warning. The minimum attrs version is now 19.2
Errors raised for keyword-only argument errors on Python 3 did not have the right error message.
BREAKING CHANGE. The Version constructor now uses an empty string to represent an implicit zero instead of None.
Version.truncate method to remove trailing zeros from the release segment.
Version now validates each item in the release sequence.
Version.bump_epoch method.
Add by keyword argument to bump_pre, bump_post, and bump_dev methods, which e.g. .bump_dev(by=-1).
BREAKING CHANGE. The Version constructor now uses an empty string to represent an implicit zero instead of None.
>>> Version(release=1, post='')
<Version '1.post'>
BREAKING CHANGE. Version.clear is no longer necessary. Use Version.replace(pre=None, post=None, dev=None) instead.
Version incorrectly allowed an empty release sequence.
Version rejects bool for numeric components.
Version rejects negative integers for numeric components.
The strict parser no longer accepts local versions with - or _ separators, or uppercase letters.
The strict parser no longer accepts numbers with leading zeros.
The local version was only being converted to lowercase when parsing with strict=False. It is now always converted.
The local version separators were not being normalized to use ..
On Python 2, Version was incorrectly rejecting long integer values.
On Python 2, Version was incorrectly rejecting long integer values.
BREAKING CHANGE. The argument to Version.bump_release is now a keyword only argument, e.g. Version.bump_release(index=0).
Version.bump_release_to method for control over the value to bump to, e.g. for CalVer.
Version.set_release method for finer control over release values without resetting subsequent indices to zero.
BREAKING CHANGE. The argument to Version.bump_release is now a keyword only argument, e.g. Version.bump_release(index=0).
The release parameter to Version now accepts any iterable.
Deprecation warnings about invalid escape sequences in _parse.py.
Version accepted pre=None and post_tag=None, which produces an ambiguous version number. This is because an implicit pre-release number combined with
Version accepted pre=None and post_tag=None, which produces an ambiguous version number. This is because an implicit pre-release number combined with an implicit post-release looks like a pre-release with a custom separator:
>>> Version(release=1, pre_tag='a', pre=None, post_tag=None, post=2)
<Version '1a-2'>
>>> Version(release=1, pre_tag='a', pre_sep2='-', pre=2)
<Version '1a-2'>
The first form now raises a ValueError.
Don’t allow post=None when post_tag=None. Implicit post releases cannot have implicit post release numbers.
First release.
First release.
One column per quarter.