Skip to main content
Version: 2.25 (dev)

py-constraints

pants py-constraints [args]

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

Backend: pants.backend.python.mixed_interpreter_constraints

Config section: [py-constraints]

Basic options​

output_file​

--py-constraints-output-file=<path>
PANTS_PY_CONSTRAINTS_OUTPUT_FILE
pants.toml
[py-constraints]
output_file = <path>
default: None

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

summary​

--[no-]py-constraints-summary
PANTS_PY_CONSTRAINTS_SUMMARY
pants.toml
[py-constraints]
summary = <bool>
default: False

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

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

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​

None

Deprecated options​

None