MT014: ConsistentVersioning

Overview

Checks that the version in pyproject.toml matches the __version__ variable in your package’s __init__.py.

Consistent versioning is critical for:

The check compares the version from two sources:

[project]
name = "my-package"
version = "1.2.3"

__version__ = "1.2.3"

The check looks for __init__.py in these locations:

Ensure both version definitions match exactly:

Update both files when releasing:

# pyproject.toml
[project]
version = "1.2.3"

# src/my_package/__init__.py
__version__ = "1.2.3"

Use dynamic versioning to read from __init__.py:

[project]
dynamic = ["version"]

[tool.setuptools.dynamic]
version = {attr = "my_package.__version__"}

Tools like bump2version, tbump, or python-semantic-release can update both locations automatically.

[tool.pycmdcheck]
skip = ["MT014"]

pycmdcheck --skip MT014