Check version of a Python module

python, packaging, version, pypi, ci
pip install cv==1.0.0



PyPI Downloads Build Status Test Coverage Supported Python

Check version of a Python module.

Raises an error if the <module>.__version__:

  • already present on PyPI or custom warehouse deployment;
  • does not match PEP 440;
  • or does not match specified type: alpha/beta/rc/dev/release.

All of this comes in handy during CI.

And one more thing: No runtime dependencies!


Available from PyPI:

pip install cv

Module Example

With a <module> present on PyPI and <module>.py in current directory:

__version__ = '7.7.7'


Simply run:

cv <module>

If 7.7.7 version of <module> is on PyPI already you’ll get a VersionExists error:

__main__.VersionExists: Package "<module>" with version "7.7.7" already exists on PyPI.
Change the "<module>.__version__" to fix this error.

Package Example

Packages work in the same way as modules except __version__ is defined in <module>/


$ cv --help
usage: cv [-h] [-w WAREHOUSE] [--alpha] [--beta] [--rc] [--dev] [--release]

Check version of a Python package or module.

positional arguments:
  module                the package/module with "__version__" defined

optional arguments:
  -h, --help            show this help message and exit
  -w WAREHOUSE, --warehouse WAREHOUSE
                        package index to use, default is
  --alpha               check that version is an alpha, e.g. 1.0.0a1
  --beta                check that version is a beta, e.g. 1.0.0b2
  --rc                  check that version is a release candidate, e.g.
  --dev                 check that version is in development, e.g. 1.0.0.dev3
  --release             check that version is a release without modifiers,
                        e.g. 1.0.0
  --dry                 make no request to PyPI