PYTHON-VERSIONS-CHECK(1)

NAME
python-versions-check - check Python versions for a package and its dependencies and users

SYNOPSIS
python-versions-check [-dhw] [-p pkgsrcdir] category/package

DESCRIPTION
python-versions-check is a script for pkgsrc developers that compares the Python versions supported by a package to the ones supported by its dependencies and the packages depending on it.

python-versions-check checks category/package or the package in its current working directory, if no argument is provided.

python-versions-check supports the following options:

-d  Debug mode - print each file name when its parsed.

-h  Show the usage.

-p pkgsrcdir
    Use pkgsrcdir as root of the pkgsrc tree. Defaults to the value of the environment variable PKGSRCDIR, and falls back to /usr/pkgsrc if that is not set.

-w  When looking for packages using the package, also check the wip/ subtree.

EXAMPLES
Example for the output if there is a problem:

    # python-versions-check.py math/py-numpy
    Supported Python versions for math/py-numpy: [39, 310, 311]
    Checking packages used by math/py-numpy:
    Checking packages using math/py-numpy:
    math/py-scipy: supports [38, 39, 310, 311], missing: [38]

This means that while math/py-numpy only supports Python version 3.9, 3.10, and 3.11, math/py-scipy also supports Python version 3.8. This will break e.g. bulk builds because the required py38-numpy package will not exist.

BUGS
python-versions-check does not handle any conditionals, so if some dependencies are only intended for some Python versions, python-versions-check will report false warnings.