./pants py-constraints [args]

Determine what Python interpreter constraints are used by files/targets.

Config section: [py-constraints]

Basic options


default: None

Output the goal's stdout to this file. If unspecified, outputs to stdout.


default: False

Output a CSV summary of interpreter constraints for your whole repository. The headers are Target, Constraints, Transitive Constraints, # Dependencies, and # Dependees.

This information can be useful when prioritizing a migration from one Python version to another (e.g. to Python 3). Use # Dependencies and # Dependees to help prioritize which targets are easiest to port (low # dependencies) and highest impact to port (high # dependees).

Use a tool like Pandas or Excel to process the CSV. Use the option --py-constraints-output-file=summary.csv to write directly to a file.

Advanced options


Deprecated options


Related subsystems

download-pex-bin, grpc-python-plugin, mypy-protobuf, pex, protoc, py-constraints, python-infer, python-native-code, python-protobuf, python-repos, python-setup, shell-setup, shellcheck, source, subprocess-environment

Did this page help you?