REGEXVAULTv2.0
Dev & Systems/SemVer
Verified Safe

Python Package Version (PEP 440) Regex for Python

/^(?:([0-9]+)!)?([0-9]+(?:\.[0-9]+)*)(?:[-_.]?(?:a|alpha|b|beta|c|rc|preview)[-_.]?([0-9]+))?(?:[-_.]?post[-_.]?([0-9]+))?(?:[-_.]?dev[-_.]?([0-9]+))?(?:\+([a-zA-Z0-9]+(?:[-_.][a-zA-Z0-9]+)*))?$/i

What this pattern does

This page provides a comprehensive, battle-tested regular expression for matching python package version (pep 440), ported and verified for Python. A rigorously tested regex reduces debugging time and protects your application from edge-case failures. The snippet below is ready to drop into your Python project — whether you're validating in a Django view, a FastAPI endpoint, or a standalone data processing script.

Python Implementation

Python
# Python Package Version (PEP 440)
# ReDoS-safe | RegexVault — Dev & Systems > SemVer

import re

python_package_version_pep_440_pattern = re.compile(r'^(?:([0-9]+)!)?([0-9]+(?:\.[0-9]+)*)(?:[-_.]?(?:a|alpha|b|beta|c|rc|preview)[-_.]?([0-9]+))?(?:[-_.]?post[-_.]?([0-9]+))?(?:[-_.]?dev[-_.]?([0-9]+))?(?:\+([a-zA-Z0-9]+(?:[-_.][a-zA-Z0-9]+)*))?$')

def validate_python_package_version_pep_440(value: str) -> bool:
    return bool(python_package_version_pep_440_pattern.fullmatch(value))

# Example
print(validate_python_package_version_pep_440("1.0"))  # True

Test Cases

Matches (Valid)
Rejects (Invalid)
1.01.0-alpha1 extra
1.0.0
1.0a1alpha
1.0b21.0.a.b.c.d.e.f.g.h
1.0rc1
1.0.post1
1.0.dev1
1!2.0
1.0+local

When to use this pattern

This pattern is drawn from the Dev & Systems > SemVer category and carries a ReDoS-safe certification. That matters for Python developers because particularly important in Python web servers where CPU-bound regex operations can stall concurrent request handling. RegexVault audits patterns against known backtracking attack vectors, ensuring you have the necessary context before using this regex in a high-stakes production environment.

Common Pitfalls

PEP 440 normalizes versions: 1.0a1 == 1.0alpha1. Always normalize before comparing. pip does this automatically.

Technical Notes

PEP 440 allows epoch (1!), pre-release suffixes (a/alpha/b/beta/rc), post-releases (.post1), dev releases (.dev1), and local version labels (+local). Use packaging.version.Version() in Python for canonical parsing.

Have a pattern that belongs in the vault?

Submit it for review — community-verified patterns get credited to your GitHub handle. Free submissions join the queue. Priority review available for $15.

Submit a Pattern