pex 2.56.0

[github-actions[bot]]

---

2.56.0

This release adds support for scoping --index and --find-links repos to only be used to resolve
certain projects, environments or a combination of the two. For example, to use the piwheels index
but restrict its use to resolves targeting armv7l machines, you can now say:
--index piwheels=https://www.piwheels.org/simple --source piwheels=platform_machine == 'armv7l'.
See the --help output for --index and --find-links for more syntax details.

Additionally, --style universal locks have been made aware of top-level inputs that can split the
lock resolve and such resolves are pre-split and performed in parallel to allow locking for multiple
non-overlapping universes at once. Splits can be caused by some scoped repos setups as well locks
with multiple differing top-level requirements for the same project. For example, the following will
create a universal lock with two locked resolves, one locking cowsay 5.0 for Python 2 and one
locking cowsay 6.0 for Python 3:

pex3 lock create \
  --style universal \
  --indent 2 \
  -o lock.json
  "cowsay<6; python_version < '3'" \
  "cowsay==6; python_version >= '3'"

An important use case for this new set of features is creating a universal lock for PyTorch for
CUDA enabled Linux and Mac by adding the appropriate pytorch index appropriately scoped.
For example, this lock will contain two locked resolves, one for Mac sourced purely from PyPI and
one for CUDA 12.9 enabled Linux partially sourced from the PyTorch index for CUDA 12.9:

pex3 lock create \
    --style universal \
    --target-system linux \
    --target-system mac \
    --elide-unused-requires-dist \
    --interpreter-constraint "CPython==3.13.*" \
    --index pytorch=https://download.pytorch.org/whl/cu129 \
    --source "pytorch=torch; sys_platform != 'darwin'" \
    --source "pytorch=torchvision; sys_platform != 'darwin'" \
    --source "pytorch=nvidia-cublas-cu12; sys_platform != 'darwin'" \
    --source "pytorch=nvidia-cuda-cupti-cu12; sys_platform != 'darwin'" \
    --source "pytorch=nvidia-cuda-nvrtc-cu12; sys_platform != 'darwin'" \
    --source "pytorch=nvidia-cuda-runtime-cu12; sys_platform != 'darwin'" \
    --source "pytorch=nvidia-cudnn-cu11; sys_platform != 'darwin'" \
    --source "pytorch=nvidia-cudnn-cu12; sys_platform != 'darwin'" \
    --source "pytorch=nvidia-cufft-cu12; sys_platform != 'darwin'" \
    --source "pytorch=nvidia-cufile-cu12; sys_platform != 'darwin'" \
    --source "pytorch=nvidia-curand-cu12; sys_platform != 'darwin'" \
    --source "pytorch=nvidia-cusolver-cu12; sys_platform != 'darwin'" \
    --source "pytorch=nvidia-cusparse-cu12; sys_platform != 'darwin'" \
    --source "pytorch=nvidia-cusparselt-cu12; sys_platform != 'darwin'" \
    --source "pytorch=nvidia-nccl-cu12; sys_platform != 'darwin'" \
    --source "pytorch=nvidia-nvjitlink-cu12; sys_platform != 'darwin'" \
    --source "pytorch=nvidia-nvtx-cu12; sys_platform != 'darwin'" \
    --indent 2 \
    -o lock.json \
    torch \
    torchvision

• Support scopes for --index and --find-links. (Support scopes for --index and --find-links. #2903)

---

file	sha256	size
pex	223aab9fcfe448f54d45f1d166f201d7d62c821995a9cf80181c605b508229b7	4796756
pex-linux-aarch64	0d46dc11b6cae1bc238106982865d3b9827b35dcd33f528dfcc6e77a265214d4	33470704
pex-linux-armv7l	13120501e73ab1fce1681e8e244c90d4052b30c32dfd3fcba1f7c9d1180d2e9b	30304331
pex-linux-riscv64	22ff90c0080d3e6c031af66ebeeda6e982e37aec30a1ffa22831b88d5ea75e76	30498593
pex-linux-x86_64	0916bf57843139a018bfa22953227a0824b2f236b1d99aee1f0a5227acb479c3	39643854
pex-macos-aarch64	4b6f4258917e3f96ebad79f3b50f48d722205c9cc162c34a51821a55b3b97de9	22510420
pex-macos-x86_64	d31db216aaf96c2a58f62befe35fb47b41b51f28785dd9d7695b5a2d00c05a3d	23008174

---

This discussion was created from the release pex 2.56.0.