---
id: parver
version: "1.0.1.post0"
license: MIT
license_treatment: permissive
maintenance: active
---

# parver — Parse and manipulate version numbers.

License: permissive · Maintenance: active · Downloads: 7.8M/mo

## What it is and what it does

parver is a lightweight library for working with PEP 440 version numbers in Python. It provides a Version class that can parse version strings in various formats (including non-normalized forms like 'v1.2.alpha-3'), expose version components as attributes, and perform common operations like bumping development versions or normalizing to canonical form.

The package has no external dependencies and targets modern Python versions, making it straightforward to integrate into build tools, version management scripts, or any system that needs to reason about version numbers programmatically. It handles the complexity of PEP 440's grammar so you don't have to.

Use it for:

- Bump development or release versions in build automation and CI/CD pipelines.
- Parse and validate version strings from package metadata or Git tags.
- Check whether a version is a pre-release, alpha, beta, or release candidate.
- Normalize non-standard version strings to PEP 440 canonical form for comparison.
- Extract version components for conditional logic in version-aware tools.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

parver parses and manipulates PEP 440 version numbers, allowing you to inspect version components, check pre-release status, and perform version bumping operations.

Yes. parver is a stable, actively maintained library with zero dependencies, a permissive MIT license, and no known vulnerabilities. Install it if you need to parse or manipulate PEP 440 versions; the low friction and focused scope make it a straightforward choice for version-handling tasks.

## Install

pip install parver
uv add parver
poetry add parver

## Installing parver

Before you install: Low install friction with no runtime dependencies. The package is actively maintained with a recent release and supports current Python versions.

License in practice: MIT license permits unrestricted use, modification, and distribution in both open-source and proprietary projects.

Quickstart:

pip install parver

from parver import Version
v = Version.parse('1.3')
v.bump_dev()

v2 = Version.parse('v1.2.alpha-3')
print(v2.is_alpha)
print(v2.normalize())

Requires Python 3.10 or later.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 7.8M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pep 440 version parsing, version number manipulation, python version bumping, parse version strings, version normalization, version-management, pep440

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