pep440check

A utility to check if version strings in pyproject.toml's project.version are PEP 440 compliant and suggest normalized forms if they are not. Optionally, it can rewrite the file with the normalized version.

Basic usage

pep440check [-h] [-w] [-V] [path]

• path: path to pyproject.toml (defaults to current directory's pyproject.toml if omitted)
• -w, --write: write normalized version back to file
• -h, --help: show help message and exit
• -V, --version: show program's version number and exit

Exit codes

• 0: Version is already PEP 440 compliant (displays "OK")
• 1: Version needs normalization or error occurred

Output examples

When version is already normalized:

$ pep440check
Target: /path/to/pyproject.toml
OK: 0.0.1a1

When version needs normalization:

$ pep440check
Target: /path/to/pyproject.toml
Original version: 1.0.0-rc1
Suggested normalized version: 1.0.0rc1

Writing normalized version:

$ pep440check -w
Target: /path/to/pyproject.toml
Normalized version: 1.0.0-rc1 -> 1.0.0rc1

Installation and Usage

uv add pep440check --dev
uv run pep440check [args]

or

uvx pep440check [args]

or

uv tool install pep440check
pep440check [args]

Development

git clone https://github.com/heiwa4126/pep440check.git
cd pep440check
uv sync

Run tests:

uv run poe test

Run linter and formatter:

uv run poe check

Type checking:

uv run poe mypy

Build package:

uv run poe build