pex 2.64.1__py2.py3-none-any.whl → 2.69.0__py2.py3-none-any.whl

pex/bin/pex.py

@@ -759,7 +759,8 @@ def configure_clp_sources(parser):
         parser,
         project_help=(
             "Add the local project at the specified path to the generated .pex file along with "
-            "its transitive dependencies."
+            "its transitive dependencies. The path can be that of a project directory, a project"
+            "sdist or a pre-built project wheel."
         ),
     )
 

pex/build_backend/configuration.py

@@ -63,8 +63,8 @@ class Plugin(object):
 
         return cls(modify_sdist=modify_sdist, modify_wheel=modify_wheel)
 
-    _modify_sdist = attr.ib()  # type: Optional[Callable[[str], None]]
-    _modify_wheel = attr.ib()  # type: Optional[Callable[[str, str], None]]
+    _modify_sdist = attr.ib()  # type: Optional[Callable[[Text], None]]
+    _modify_wheel = attr.ib()  # type: Optional[Callable[[Text, Text], None]]
 
     @property
     def modifies_sdists(self):
@@ -72,7 +72,7 @@ class Plugin(object):
         return self._modify_sdist is not None
 
     def modify_sdist(self, sdist_dir):
-        # type: (str) -> Any
+        # type: (Text) -> Any
         if self._modify_sdist:
             return self._modify_sdist(sdist_dir)
         return None
@@ -84,8 +84,8 @@ class Plugin(object):
 
     def modify_wheel(
         self,
-        wheel_dir,  # type: str
-        dist_info_dir_relpath,  # type: str
+        wheel_dir,  # type: Text
+        dist_info_dir_relpath,  # type: Text
     ):
         # type: (...) -> Any
         if self._modify_wheel:

pex/build_backend/wrap.py

@@ -11,6 +11,7 @@ import io
 import os
 import tarfile
 
+from pex import sdist
 from pex.build_backend import BuildError
 from pex.build_backend.configuration import load_config
 from pex.build_backend.pylock import ScriptLocks
@@ -63,25 +64,7 @@ def build_sdist(
 
     sdist_path = os.path.join(sdist_directory, sdist_name)
     build_dir = _build_dir("sdist")
-
-    with tarfile.open(sdist_path) as tf:
-        tf.extractall(build_dir)
-
-    entries = os.listdir(build_dir)
-    if len(entries) != 1:
-        raise BuildError(
-            "Calling `{backend}.build_sdist` produced an sdist with unexpected contents.\n"
-            "Expected expected one top-level <project>-<version> directory but found {count}:\n"
-            "{entries}".format(
-                backend=_CONFIG.delegate_build_backend,
-                count=len(entries),
-                entries="\n".join(entries),
-            )
-        )
-
-    tarball_root_dir_name = entries[0]
-    tarball_root_dir = os.path.join(build_dir, tarball_root_dir_name)
-
+    tarball_root_dir = sdist.extract_tarball(sdist_path, dest_dir=build_dir)
     for plugin in plugins:
         plugin.modify_sdist(tarball_root_dir)
 

pex/cli/commands/lock.py

@@ -36,7 +36,7 @@ from pex.installed_wheel import InstalledWheel
 from pex.interpreter import PythonInterpreter
 from pex.orderedset import OrderedSet
 from pex.os import is_exe, safe_execv
-from pex.pep_376 import Record
+from pex.pep_376 import InstalledFile, Record
 from pex.pep_427 import InstallableType, reinstall_venv
 from pex.pep_440 import Version
 from pex.pep_503 import ProjectName
@@ -306,6 +306,7 @@ class SyncTarget(object):
                     for installed_file in Record.read(
                         lines=distribution.iter_metadata_lines("RECORD")
                     )
+                    if isinstance(installed_file, InstalledFile)
                 )
             elif distribution.metadata.type is MetadataType.EGG_INFO:
                 installed_files = distribution.metadata.files.metadata_file_rel_path(
@@ -688,7 +689,8 @@ class Lock(OutputMixin, JsonMixin, BuildTimeCommand):
             options_group,
             project_help=(
                 "Add the transitive dependencies of the local project at the specified path to "
-                "the lock but do not lock project itself."
+                "the lock but do not lock project itself. The path can be that of a project "
+                "directory, a project sdist or a pre-built project wheel."
             ),
         )
         dependency_configuration.register(options_group)

pex/cli/commands/run.py

@@ -10,12 +10,11 @@ import os.path
 import posixpath
 import shutil
 import sys
-import tarfile
 from argparse import _ActionsContainer
-from contextlib import closing
 
 from pex import dependency_configuration, interpreter
 from pex import resolver as pip_resolver
+from pex import sdist
 from pex.artifact_url import ArtifactURL, Fingerprint
 from pex.atomic_directory import atomic_directory
 from pex.build_system import pep_517
@@ -676,19 +675,19 @@ class Run(CacheAwareMixin, BuildTimeCommand):
                         return package, os.path.join(lock_dest_dir, lock_path)
         elif is_sdist(distribution.path):
             if is_tar_sdist(distribution.path):
-                with closing(tarfile.open(distribution.path)) as tf:
-                    tf.extractall(lock_dest_dir)
+                sdist_root = sdist.extract_tarball(distribution.path, dest_dir=lock_dest_dir)
             else:
                 with open_zip(distribution.path) as zf:
                     zf.extractall(lock_dest_dir)
-            entries = glob.glob(os.path.join(lock_dest_dir, "*"))
-            if len(entries) != 1:
-                return Error(
-                    "Expected {sdist} to have 1 entry, found {count}: {entries}".format(
-                        sdist=distribution.path, count=len(entries), entries=entries
+                entries = glob.glob(os.path.join(lock_dest_dir, "*"))
+                if len(entries) != 1:
+                    return Error(
+                        "Expected {sdist} to have 1 entry, found {count}: {entries}".format(
+                            sdist=distribution.path, count=len(entries), entries=entries
+                        )
                     )
-                )
-            sdist_root = entries[0]
+                sdist_root = entries[0]
+
             for lock_name in run_spec.locks:
                 lock_path = os.path.join(sdist_root, lock_name)
                 if os.path.exists(lock_path):

pex/cli/pex.py

@@ -3,6 +3,7 @@
 
 from __future__ import absolute_import
 
+import sys
 from argparse import ArgumentError, ArgumentTypeError
 
 from pex.cli import commands
@@ -12,7 +13,7 @@ from pex.result import catch
 from pex.typing import TYPE_CHECKING
 
 if TYPE_CHECKING:
-    from typing import Union
+    from typing import Optional, Union
 
 
 class Pex3(Main[BuildTimeCommand]):
@@ -23,14 +24,20 @@ class Pex3(Main[BuildTimeCommand]):
     """
 
 
-def main():
-    # type: () -> Union[int, str]
+def main(subcommand=None):
+    # type: (Optional[str]) -> Union[int, str]
 
     pex3 = Pex3(command_types=commands.all_commands())
     try:
-        with pex3.parsed_command() as command:
+        args = [subcommand] + sys.argv[1:] if subcommand else None
+        with pex3.parsed_command(args=args) as command:
             result = catch(command.run)
             result.maybe_display()
             return result.exit_code
     except (ArgumentError, ArgumentTypeError, GlobalConfigurationError) as e:
         return str(e)
+
+
+def run():
+    # type: () -> Union[int, str]
+    return main("run")

pex/dist_metadata.py

@@ -9,6 +9,7 @@ import functools
 import glob
 import importlib
 import itertools
+import json
 import os
 import sys
 import tarfile
@@ -22,7 +23,7 @@ from textwrap import dedent
 
 from pex import pex_warnings, specifier_sets
 from pex.common import open_zip, pluralize
-from pex.compatibility import PY2, to_unicode
+from pex.compatibility import PY2, string, to_unicode
 from pex.enum import Enum
 from pex.exceptions import reportable_unexpected_error_msg
 from pex.pep_440 import Version
@@ -780,7 +781,7 @@ class Constraint(object):
         )
 
     name = attr.ib(eq=False)  # type: str
-    specifier = attr.ib(factory=SpecifierSet)  # type: SpecifierSet
+    specifier = attr.ib(factory=SpecifierSet, order=False)  # type: SpecifierSet
     marker = attr.ib(default=None, eq=str)  # type: Optional[Marker]
 
     project_name = attr.ib(init=False, repr=False)  # type: ProjectName
@@ -1193,6 +1194,32 @@ class Distribution(object):
             source=os.path.join(self.metadata.files.metadata.location, entry_points_txt_relpath),
         )
 
+    def editable_install_url(self):
+        # type: () -> Optional[Text]
+
+        # For the spec, see: https://peps.python.org/pep-0660/#frontend-requirements
+        direct_url_json_bytes = self._read_metadata_file("direct_url.json")
+        if not direct_url_json_bytes:
+            return None
+
+        direct_url_json_data = json.loads(direct_url_json_bytes)
+        if not direct_url_json_data.get("dir_info", {}).get("editable", False):
+            return None
+
+        url = direct_url_json_data.get("url", None)
+        if url is None:
+            return None
+
+        if not isinstance(url, string):
+            raise InvalidMetadataError(
+                "The direct_url.json metadata for {dist} at {location} is invalid.\n"
+                "Expected `url` to be a string but found {value} of type {type}".format(
+                    dist=self, location=self.location, value=url, type=type(url)
+                )
+            )
+
+        return cast("Text", url)
+
     def __str__(self):
         # type: () -> str
         return "{project_name} {version}".format(

pex/docs/html/_pagefind/pagefind-entry.json

@@ -1 +1 @@
-{"version":"1.3.0","languages":{"en":{"hash":"en_49ec86cf86","wasm":"en","page_count":8}}}
+{"version":"1.3.0","languages":{"en":{"hash":"en_4ce1afa9e3","wasm":"en","page_count":8}}}

pex/docs/html/_static/documentation_options.js

@@ -1,5 +1,5 @@
 const DOCUMENTATION_OPTIONS = {
-    VERSION: '2.64.1',
+    VERSION: '2.69.0',
     LANGUAGE: 'en',
     COLLAPSE_INDEX: false,
     BUILDER: 'html',

pex/docs/html/api/vars.html

@@ -8,7 +8,7 @@
         <link rel="prefetch" href="../_static/pex-logo-dark.png" as="image">
 
     <link rel="shortcut icon" href="../_static/pex-icon.png"><!-- Generated with Sphinx 8.2.3 and Furo 2025.09.25 -->
-        <title>PEX runtime environment variables - Pex Docs (v2.64.1)</title>
+        <title>PEX runtime environment variables - Pex Docs (v2.69.0)</title>
       <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=d111a655" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=580074bf" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/furo-extensions.css?v=8dab3a3b" />
@@ -163,7 +163,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">Pex Docs (v2.64.1)</div></a>
+      <a href="../index.html"><div class="brand">Pex Docs (v2.69.0)</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -643,12 +643,12 @@
           </div>
           <div class="right-details">
             <div class="icons">
-              <a class="muted-link " href="https://pypi.org/project/pex/2.64.1/" aria-label="PyPI"><svg stroke="currentColor" fill="currentColor" stroke-width="0" viewBox="0 0 448 512" height="1em" width="1em" xmlns="http://www.w3.org/2000/svg">
+              <a class="muted-link " href="https://pypi.org/project/pex/2.69.0/" aria-label="PyPI"><svg stroke="currentColor" fill="currentColor" stroke-width="0" viewBox="0 0 448 512" height="1em" width="1em" xmlns="http://www.w3.org/2000/svg">
     <path d="M439.8 200.5c-7.7-30.9-22.3-54.2-53.4-54.2h-40.1v47.4c0 36.8-31.2 67.8-66.8 67.8H172.7c-29.2 0-53.4 25-53.4 54.3v101.8c0 29 25.2 46 53.4 54.3 33.8 9.9 66.3 11.7 106.8 0 26.9-7.8 53.4-23.5 53.4-54.3v-40.7H226.2v-13.6h160.2c31.1 0 42.6-21.7 53.4-54.2 11.2-33.5 10.7-65.7 0-108.6zM286.2 404c11.1 0 20.1 9.1 20.1 20.3 0 11.3-9 20.4-20.1 20.4-11 0-20.1-9.2-20.1-20.4.1-11.3 9.1-20.3 20.1-20.3zM167.8 248.1h106.8c29.7 0 53.4-24.5 53.4-54.3V91.9c0-29-24.4-50.7-53.4-55.6-35.8-5.9-74.7-5.6-106.8.1-45.2 8-53.4 24.7-53.4 55.6v40.7h106.9v13.6h-147c-31.1 0-58.3 18.7-66.8 54.2-9.8 40.7-10.2 66.1 0 108.6 7.6 31.6 25.7 54.2 56.8 54.2H101v-48.8c0-35.3 30.5-66.4 66.8-66.4zm-6.7-142.6c-11.1 0-20.1-9.1-20.1-20.3.1-11.3 9-20.4 20.1-20.4 11 0 20.1 9.2 20.1 20.4s-9 20.3-20.1 20.3z">
     </path>
 </svg>
 </a>
-              <a class="muted-link " href="https://github.com/pex-tool/pex/releases/download/v2.64.1/pex" aria-label="Download"><svg stroke="currentColor" fill="currentColor" stroke-width="0" viewBox="0 0 640 512" height="1em" width="1em" xmlns="http://www.w3.org/2000/svg">
+              <a class="muted-link " href="https://github.com/pex-tool/pex/releases/download/v2.69.0/pex" aria-label="Download"><svg stroke="currentColor" fill="currentColor" stroke-width="0" viewBox="0 0 640 512" height="1em" width="1em" xmlns="http://www.w3.org/2000/svg">
     <path d="M537.6 226.6c4.1-10.7 6.4-22.4 6.4-34.6 0-53-43-96-96-96-19.7 0-38.1 6-53.3 16.2C367 64.2 315.3 32 256 32c-88.4 0-160 71.6-160 160 0 2.7.1 5.4.2 8.1C40.2 219.8 0 273.2 0 336c0 79.5 64.5 144 144 144h368c70.7 0 128-57.3 128-128 0-61.9-44-113.6-102.4-125.4zm-132.9 88.7L299.3 420.7c-6.2 6.2-16.4 6.2-22.6 0L171.3 315.3c-10.1-10.1-2.9-27.3 11.3-27.3H248V176c0-8.8 7.2-16 16-16h48c8.8 0 16 7.2 16 16v112h65.4c14.2 0 21.4 17.2 11.3 27.3z">
     </path>
 </svg>
@@ -671,7 +671,7 @@
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=a39c154c"></script>
+</div><script src="../_static/documentation_options.js?v=525daa63"></script>
     <script src="../_static/doctools.js?v=9bcbadda"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/scripts/furo.js?v=46bd48cc"></script>

pex/docs/html/buildingpex.html

@@ -8,7 +8,7 @@
         <link rel="prefetch" href="_static/pex-logo-dark.png" as="image">
 
     <link rel="shortcut icon" href="_static/pex-icon.png"><!-- Generated with Sphinx 8.2.3 and Furo 2025.09.25 -->
-        <title>Building .pex files - Pex Docs (v2.64.1)</title>
+        <title>Building .pex files - Pex Docs (v2.69.0)</title>
       <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=d111a655" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo.css?v=580074bf" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo-extensions.css?v=8dab3a3b" />
@@ -163,7 +163,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="index.html"><div class="brand">Pex Docs (v2.64.1)</div></a>
+      <a href="index.html"><div class="brand">Pex Docs (v2.69.0)</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -681,12 +681,12 @@ scary like <code class="docutils literal notranslate"><span class="pre">sudo</sp
           </div>
           <div class="right-details">
             <div class="icons">
-              <a class="muted-link " href="https://pypi.org/project/pex/2.64.1/" aria-label="PyPI"><svg stroke="currentColor" fill="currentColor" stroke-width="0" viewBox="0 0 448 512" height="1em" width="1em" xmlns="http://www.w3.org/2000/svg">
+              <a class="muted-link " href="https://pypi.org/project/pex/2.69.0/" aria-label="PyPI"><svg stroke="currentColor" fill="currentColor" stroke-width="0" viewBox="0 0 448 512" height="1em" width="1em" xmlns="http://www.w3.org/2000/svg">
     <path d="M439.8 200.5c-7.7-30.9-22.3-54.2-53.4-54.2h-40.1v47.4c0 36.8-31.2 67.8-66.8 67.8H172.7c-29.2 0-53.4 25-53.4 54.3v101.8c0 29 25.2 46 53.4 54.3 33.8 9.9 66.3 11.7 106.8 0 26.9-7.8 53.4-23.5 53.4-54.3v-40.7H226.2v-13.6h160.2c31.1 0 42.6-21.7 53.4-54.2 11.2-33.5 10.7-65.7 0-108.6zM286.2 404c11.1 0 20.1 9.1 20.1 20.3 0 11.3-9 20.4-20.1 20.4-11 0-20.1-9.2-20.1-20.4.1-11.3 9.1-20.3 20.1-20.3zM167.8 248.1h106.8c29.7 0 53.4-24.5 53.4-54.3V91.9c0-29-24.4-50.7-53.4-55.6-35.8-5.9-74.7-5.6-106.8.1-45.2 8-53.4 24.7-53.4 55.6v40.7h106.9v13.6h-147c-31.1 0-58.3 18.7-66.8 54.2-9.8 40.7-10.2 66.1 0 108.6 7.6 31.6 25.7 54.2 56.8 54.2H101v-48.8c0-35.3 30.5-66.4 66.8-66.4zm-6.7-142.6c-11.1 0-20.1-9.1-20.1-20.3.1-11.3 9-20.4 20.1-20.4 11 0 20.1 9.2 20.1 20.4s-9 20.3-20.1 20.3z">
     </path>
 </svg>
 </a>
-              <a class="muted-link " href="https://github.com/pex-tool/pex/releases/download/v2.64.1/pex" aria-label="Download"><svg stroke="currentColor" fill="currentColor" stroke-width="0" viewBox="0 0 640 512" height="1em" width="1em" xmlns="http://www.w3.org/2000/svg">
+              <a class="muted-link " href="https://github.com/pex-tool/pex/releases/download/v2.69.0/pex" aria-label="Download"><svg stroke="currentColor" fill="currentColor" stroke-width="0" viewBox="0 0 640 512" height="1em" width="1em" xmlns="http://www.w3.org/2000/svg">
     <path d="M537.6 226.6c4.1-10.7 6.4-22.4 6.4-34.6 0-53-43-96-96-96-19.7 0-38.1 6-53.3 16.2C367 64.2 315.3 32 256 32c-88.4 0-160 71.6-160 160 0 2.7.1 5.4.2 8.1C40.2 219.8 0 273.2 0 336c0 79.5 64.5 144 144 144h368c70.7 0 128-57.3 128-128 0-61.9-44-113.6-102.4-125.4zm-132.9 88.7L299.3 420.7c-6.2 6.2-16.4 6.2-22.6 0L171.3 315.3c-10.1-10.1-2.9-27.3 11.3-27.3H248V176c0-8.8 7.2-16 16-16h48c8.8 0 16 7.2 16 16v112h65.4c14.2 0 21.4 17.2 11.3 27.3z">
     </path>
 </svg>
@@ -709,7 +709,7 @@ scary like <code class="docutils literal notranslate"><span class="pre">sudo</sp
       
     </aside>
   </div>
-</div><script src="_static/documentation_options.js?v=a39c154c"></script>
+</div><script src="_static/documentation_options.js?v=525daa63"></script>
     <script src="_static/doctools.js?v=9bcbadda"></script>
     <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="_static/scripts/furo.js?v=46bd48cc"></script>

pex/docs/html/genindex.html

@@ -6,7 +6,7 @@
         <link rel="prefetch" href="_static/pex-logo-light.png" as="image">
         <link rel="prefetch" href="_static/pex-logo-dark.png" as="image">
 
-    <link rel="shortcut icon" href="_static/pex-icon.png"><!-- Generated with Sphinx 8.2.3 and Furo 2025.09.25 --><title>Index - Pex Docs (v2.64.1)</title>
+    <link rel="shortcut icon" href="_static/pex-icon.png"><!-- Generated with Sphinx 8.2.3 and Furo 2025.09.25 --><title>Index - Pex Docs (v2.69.0)</title>
 <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=d111a655" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo.css?v=580074bf" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo-extensions.css?v=8dab3a3b" />
@@ -161,7 +161,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="index.html"><div class="brand">Pex Docs (v2.64.1)</div></a>
+      <a href="index.html"><div class="brand">Pex Docs (v2.69.0)</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -260,12 +260,12 @@
           </div>
           <div class="right-details">
             <div class="icons">
-              <a class="muted-link " href="https://pypi.org/project/pex/2.64.1/" aria-label="PyPI"><svg stroke="currentColor" fill="currentColor" stroke-width="0" viewBox="0 0 448 512" height="1em" width="1em" xmlns="http://www.w3.org/2000/svg">
+              <a class="muted-link " href="https://pypi.org/project/pex/2.69.0/" aria-label="PyPI"><svg stroke="currentColor" fill="currentColor" stroke-width="0" viewBox="0 0 448 512" height="1em" width="1em" xmlns="http://www.w3.org/2000/svg">
     <path d="M439.8 200.5c-7.7-30.9-22.3-54.2-53.4-54.2h-40.1v47.4c0 36.8-31.2 67.8-66.8 67.8H172.7c-29.2 0-53.4 25-53.4 54.3v101.8c0 29 25.2 46 53.4 54.3 33.8 9.9 66.3 11.7 106.8 0 26.9-7.8 53.4-23.5 53.4-54.3v-40.7H226.2v-13.6h160.2c31.1 0 42.6-21.7 53.4-54.2 11.2-33.5 10.7-65.7 0-108.6zM286.2 404c11.1 0 20.1 9.1 20.1 20.3 0 11.3-9 20.4-20.1 20.4-11 0-20.1-9.2-20.1-20.4.1-11.3 9.1-20.3 20.1-20.3zM167.8 248.1h106.8c29.7 0 53.4-24.5 53.4-54.3V91.9c0-29-24.4-50.7-53.4-55.6-35.8-5.9-74.7-5.6-106.8.1-45.2 8-53.4 24.7-53.4 55.6v40.7h106.9v13.6h-147c-31.1 0-58.3 18.7-66.8 54.2-9.8 40.7-10.2 66.1 0 108.6 7.6 31.6 25.7 54.2 56.8 54.2H101v-48.8c0-35.3 30.5-66.4 66.8-66.4zm-6.7-142.6c-11.1 0-20.1-9.1-20.1-20.3.1-11.3 9-20.4 20.1-20.4 11 0 20.1 9.2 20.1 20.4s-9 20.3-20.1 20.3z">
     </path>
 </svg>
 </a>
-              <a class="muted-link " href="https://github.com/pex-tool/pex/releases/download/v2.64.1/pex" aria-label="Download"><svg stroke="currentColor" fill="currentColor" stroke-width="0" viewBox="0 0 640 512" height="1em" width="1em" xmlns="http://www.w3.org/2000/svg">
+              <a class="muted-link " href="https://github.com/pex-tool/pex/releases/download/v2.69.0/pex" aria-label="Download"><svg stroke="currentColor" fill="currentColor" stroke-width="0" viewBox="0 0 640 512" height="1em" width="1em" xmlns="http://www.w3.org/2000/svg">
     <path d="M537.6 226.6c4.1-10.7 6.4-22.4 6.4-34.6 0-53-43-96-96-96-19.7 0-38.1 6-53.3 16.2C367 64.2 315.3 32 256 32c-88.4 0-160 71.6-160 160 0 2.7.1 5.4.2 8.1C40.2 219.8 0 273.2 0 336c0 79.5 64.5 144 144 144h368c70.7 0 128-57.3 128-128 0-61.9-44-113.6-102.4-125.4zm-132.9 88.7L299.3 420.7c-6.2 6.2-16.4 6.2-22.6 0L171.3 315.3c-10.1-10.1-2.9-27.3 11.3-27.3H248V176c0-8.8 7.2-16 16-16h48c8.8 0 16 7.2 16 16v112h65.4c14.2 0 21.4 17.2 11.3 27.3z">
     </path>
 </svg>
@@ -288,7 +288,7 @@
       
     </aside>
   </div>
-</div><script src="_static/documentation_options.js?v=a39c154c"></script>
+</div><script src="_static/documentation_options.js?v=525daa63"></script>
     <script src="_static/doctools.js?v=9bcbadda"></script>
     <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="_static/scripts/furo.js?v=46bd48cc"></script>

pex/docs/html/index.html

@@ -8,7 +8,7 @@
         <link rel="prefetch" href="_static/pex-logo-dark.png" as="image">
 
     <link rel="shortcut icon" href="_static/pex-icon.png"><!-- Generated with Sphinx 8.2.3 and Furo 2025.09.25 -->
-        <title>Pex Docs (v2.64.1)</title>
+        <title>Pex Docs (v2.69.0)</title>
       <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=d111a655" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo.css?v=580074bf" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo-extensions.css?v=8dab3a3b" />
@@ -163,7 +163,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="#"><div class="brand">Pex Docs (v2.64.1)</div></a>
+      <a href="#"><div class="brand">Pex Docs (v2.69.0)</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -341,12 +341,12 @@ To go straight to building pex files, see <a class="reference internal" href="bu
           </div>
           <div class="right-details">
             <div class="icons">
-              <a class="muted-link " href="https://pypi.org/project/pex/2.64.1/" aria-label="PyPI"><svg stroke="currentColor" fill="currentColor" stroke-width="0" viewBox="0 0 448 512" height="1em" width="1em" xmlns="http://www.w3.org/2000/svg">
+              <a class="muted-link " href="https://pypi.org/project/pex/2.69.0/" aria-label="PyPI"><svg stroke="currentColor" fill="currentColor" stroke-width="0" viewBox="0 0 448 512" height="1em" width="1em" xmlns="http://www.w3.org/2000/svg">
     <path d="M439.8 200.5c-7.7-30.9-22.3-54.2-53.4-54.2h-40.1v47.4c0 36.8-31.2 67.8-66.8 67.8H172.7c-29.2 0-53.4 25-53.4 54.3v101.8c0 29 25.2 46 53.4 54.3 33.8 9.9 66.3 11.7 106.8 0 26.9-7.8 53.4-23.5 53.4-54.3v-40.7H226.2v-13.6h160.2c31.1 0 42.6-21.7 53.4-54.2 11.2-33.5 10.7-65.7 0-108.6zM286.2 404c11.1 0 20.1 9.1 20.1 20.3 0 11.3-9 20.4-20.1 20.4-11 0-20.1-9.2-20.1-20.4.1-11.3 9.1-20.3 20.1-20.3zM167.8 248.1h106.8c29.7 0 53.4-24.5 53.4-54.3V91.9c0-29-24.4-50.7-53.4-55.6-35.8-5.9-74.7-5.6-106.8.1-45.2 8-53.4 24.7-53.4 55.6v40.7h106.9v13.6h-147c-31.1 0-58.3 18.7-66.8 54.2-9.8 40.7-10.2 66.1 0 108.6 7.6 31.6 25.7 54.2 56.8 54.2H101v-48.8c0-35.3 30.5-66.4 66.8-66.4zm-6.7-142.6c-11.1 0-20.1-9.1-20.1-20.3.1-11.3 9-20.4 20.1-20.4 11 0 20.1 9.2 20.1 20.4s-9 20.3-20.1 20.3z">
     </path>
 </svg>
 </a>
-              <a class="muted-link " href="https://github.com/pex-tool/pex/releases/download/v2.64.1/pex" aria-label="Download"><svg stroke="currentColor" fill="currentColor" stroke-width="0" viewBox="0 0 640 512" height="1em" width="1em" xmlns="http://www.w3.org/2000/svg">
+              <a class="muted-link " href="https://github.com/pex-tool/pex/releases/download/v2.69.0/pex" aria-label="Download"><svg stroke="currentColor" fill="currentColor" stroke-width="0" viewBox="0 0 640 512" height="1em" width="1em" xmlns="http://www.w3.org/2000/svg">
     <path d="M537.6 226.6c4.1-10.7 6.4-22.4 6.4-34.6 0-53-43-96-96-96-19.7 0-38.1 6-53.3 16.2C367 64.2 315.3 32 256 32c-88.4 0-160 71.6-160 160 0 2.7.1 5.4.2 8.1C40.2 219.8 0 273.2 0 336c0 79.5 64.5 144 144 144h368c70.7 0 128-57.3 128-128 0-61.9-44-113.6-102.4-125.4zm-132.9 88.7L299.3 420.7c-6.2 6.2-16.4 6.2-22.6 0L171.3 315.3c-10.1-10.1-2.9-27.3 11.3-27.3H248V176c0-8.8 7.2-16 16-16h48c8.8 0 16 7.2 16 16v112h65.4c14.2 0 21.4 17.2 11.3 27.3z">
     </path>
 </svg>
@@ -389,7 +389,7 @@ To go straight to building pex files, see <a class="reference internal" href="bu
       
     </aside>
   </div>
-</div><script src="_static/documentation_options.js?v=a39c154c"></script>
+</div><script src="_static/documentation_options.js?v=525daa63"></script>
     <script src="_static/doctools.js?v=9bcbadda"></script>
     <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="_static/scripts/furo.js?v=46bd48cc"></script>

pex/docs/html/recipes.html

@@ -8,7 +8,7 @@
         <link rel="prefetch" href="_static/pex-logo-dark.png" as="image">
 
     <link rel="shortcut icon" href="_static/pex-icon.png"><!-- Generated with Sphinx 8.2.3 and Furo 2025.09.25 -->
-        <title>PEX Recipes and Notes - Pex Docs (v2.64.1)</title>
+        <title>PEX Recipes and Notes - Pex Docs (v2.69.0)</title>
       <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=d111a655" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo.css?v=580074bf" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo-extensions.css?v=8dab3a3b" />
@@ -163,7 +163,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="index.html"><div class="brand">Pex Docs (v2.64.1)</div></a>
+      <a href="index.html"><div class="brand">Pex Docs (v2.69.0)</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -430,12 +430,12 @@ $<span class="w"> </span><span class="nb">export</span><span class="w"> </span><
           </div>
           <div class="right-details">
             <div class="icons">
-              <a class="muted-link " href="https://pypi.org/project/pex/2.64.1/" aria-label="PyPI"><svg stroke="currentColor" fill="currentColor" stroke-width="0" viewBox="0 0 448 512" height="1em" width="1em" xmlns="http://www.w3.org/2000/svg">
+              <a class="muted-link " href="https://pypi.org/project/pex/2.69.0/" aria-label="PyPI"><svg stroke="currentColor" fill="currentColor" stroke-width="0" viewBox="0 0 448 512" height="1em" width="1em" xmlns="http://www.w3.org/2000/svg">
     <path d="M439.8 200.5c-7.7-30.9-22.3-54.2-53.4-54.2h-40.1v47.4c0 36.8-31.2 67.8-66.8 67.8H172.7c-29.2 0-53.4 25-53.4 54.3v101.8c0 29 25.2 46 53.4 54.3 33.8 9.9 66.3 11.7 106.8 0 26.9-7.8 53.4-23.5 53.4-54.3v-40.7H226.2v-13.6h160.2c31.1 0 42.6-21.7 53.4-54.2 11.2-33.5 10.7-65.7 0-108.6zM286.2 404c11.1 0 20.1 9.1 20.1 20.3 0 11.3-9 20.4-20.1 20.4-11 0-20.1-9.2-20.1-20.4.1-11.3 9.1-20.3 20.1-20.3zM167.8 248.1h106.8c29.7 0 53.4-24.5 53.4-54.3V91.9c0-29-24.4-50.7-53.4-55.6-35.8-5.9-74.7-5.6-106.8.1-45.2 8-53.4 24.7-53.4 55.6v40.7h106.9v13.6h-147c-31.1 0-58.3 18.7-66.8 54.2-9.8 40.7-10.2 66.1 0 108.6 7.6 31.6 25.7 54.2 56.8 54.2H101v-48.8c0-35.3 30.5-66.4 66.8-66.4zm-6.7-142.6c-11.1 0-20.1-9.1-20.1-20.3.1-11.3 9-20.4 20.1-20.4 11 0 20.1 9.2 20.1 20.4s-9 20.3-20.1 20.3z">
     </path>
 </svg>
 </a>
-              <a class="muted-link " href="https://github.com/pex-tool/pex/releases/download/v2.64.1/pex" aria-label="Download"><svg stroke="currentColor" fill="currentColor" stroke-width="0" viewBox="0 0 640 512" height="1em" width="1em" xmlns="http://www.w3.org/2000/svg">
+              <a class="muted-link " href="https://github.com/pex-tool/pex/releases/download/v2.69.0/pex" aria-label="Download"><svg stroke="currentColor" fill="currentColor" stroke-width="0" viewBox="0 0 640 512" height="1em" width="1em" xmlns="http://www.w3.org/2000/svg">
     <path d="M537.6 226.6c4.1-10.7 6.4-22.4 6.4-34.6 0-53-43-96-96-96-19.7 0-38.1 6-53.3 16.2C367 64.2 315.3 32 256 32c-88.4 0-160 71.6-160 160 0 2.7.1 5.4.2 8.1C40.2 219.8 0 273.2 0 336c0 79.5 64.5 144 144 144h368c70.7 0 128-57.3 128-128 0-61.9-44-113.6-102.4-125.4zm-132.9 88.7L299.3 420.7c-6.2 6.2-16.4 6.2-22.6 0L171.3 315.3c-10.1-10.1-2.9-27.3 11.3-27.3H248V176c0-8.8 7.2-16 16-16h48c8.8 0 16 7.2 16 16v112h65.4c14.2 0 21.4 17.2 11.3 27.3z">
     </path>
 </svg>
@@ -482,7 +482,7 @@ $<span class="w"> </span><span class="nb">export</span><span class="w"> </span><
       
     </aside>
   </div>
-</div><script src="_static/documentation_options.js?v=a39c154c"></script>
+</div><script src="_static/documentation_options.js?v=525daa63"></script>
     <script src="_static/doctools.js?v=9bcbadda"></script>
     <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="_static/scripts/furo.js?v=46bd48cc"></script>

pex/docs/html/scie.html

@@ -8,7 +8,7 @@
         <link rel="prefetch" href="_static/pex-logo-dark.png" as="image">
 
     <link rel="shortcut icon" href="_static/pex-icon.png"><!-- Generated with Sphinx 8.2.3 and Furo 2025.09.25 -->
-        <title>PEX with included Python interpreter - Pex Docs (v2.64.1)</title>
+        <title>PEX with included Python interpreter - Pex Docs (v2.69.0)</title>
       <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=d111a655" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo.css?v=580074bf" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo-extensions.css?v=8dab3a3b" />
@@ -163,7 +163,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="index.html"><div class="brand">Pex Docs (v2.64.1)</div></a>
+      <a href="index.html"><div class="brand">Pex Docs (v2.69.0)</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -623,12 +623,12 @@ uuid
           </div>
           <div class="right-details">
             <div class="icons">
-              <a class="muted-link " href="https://pypi.org/project/pex/2.64.1/" aria-label="PyPI"><svg stroke="currentColor" fill="currentColor" stroke-width="0" viewBox="0 0 448 512" height="1em" width="1em" xmlns="http://www.w3.org/2000/svg">
+              <a class="muted-link " href="https://pypi.org/project/pex/2.69.0/" aria-label="PyPI"><svg stroke="currentColor" fill="currentColor" stroke-width="0" viewBox="0 0 448 512" height="1em" width="1em" xmlns="http://www.w3.org/2000/svg">
     <path d="M439.8 200.5c-7.7-30.9-22.3-54.2-53.4-54.2h-40.1v47.4c0 36.8-31.2 67.8-66.8 67.8H172.7c-29.2 0-53.4 25-53.4 54.3v101.8c0 29 25.2 46 53.4 54.3 33.8 9.9 66.3 11.7 106.8 0 26.9-7.8 53.4-23.5 53.4-54.3v-40.7H226.2v-13.6h160.2c31.1 0 42.6-21.7 53.4-54.2 11.2-33.5 10.7-65.7 0-108.6zM286.2 404c11.1 0 20.1 9.1 20.1 20.3 0 11.3-9 20.4-20.1 20.4-11 0-20.1-9.2-20.1-20.4.1-11.3 9.1-20.3 20.1-20.3zM167.8 248.1h106.8c29.7 0 53.4-24.5 53.4-54.3V91.9c0-29-24.4-50.7-53.4-55.6-35.8-5.9-74.7-5.6-106.8.1-45.2 8-53.4 24.7-53.4 55.6v40.7h106.9v13.6h-147c-31.1 0-58.3 18.7-66.8 54.2-9.8 40.7-10.2 66.1 0 108.6 7.6 31.6 25.7 54.2 56.8 54.2H101v-48.8c0-35.3 30.5-66.4 66.8-66.4zm-6.7-142.6c-11.1 0-20.1-9.1-20.1-20.3.1-11.3 9-20.4 20.1-20.4 11 0 20.1 9.2 20.1 20.4s-9 20.3-20.1 20.3z">
     </path>
 </svg>
 </a>
-              <a class="muted-link " href="https://github.com/pex-tool/pex/releases/download/v2.64.1/pex" aria-label="Download"><svg stroke="currentColor" fill="currentColor" stroke-width="0" viewBox="0 0 640 512" height="1em" width="1em" xmlns="http://www.w3.org/2000/svg">
+              <a class="muted-link " href="https://github.com/pex-tool/pex/releases/download/v2.69.0/pex" aria-label="Download"><svg stroke="currentColor" fill="currentColor" stroke-width="0" viewBox="0 0 640 512" height="1em" width="1em" xmlns="http://www.w3.org/2000/svg">
     <path d="M537.6 226.6c4.1-10.7 6.4-22.4 6.4-34.6 0-53-43-96-96-96-19.7 0-38.1 6-53.3 16.2C367 64.2 315.3 32 256 32c-88.4 0-160 71.6-160 160 0 2.7.1 5.4.2 8.1C40.2 219.8 0 273.2 0 336c0 79.5 64.5 144 144 144h368c70.7 0 128-57.3 128-128 0-61.9-44-113.6-102.4-125.4zm-132.9 88.7L299.3 420.7c-6.2 6.2-16.4 6.2-22.6 0L171.3 315.3c-10.1-10.1-2.9-27.3 11.3-27.3H248V176c0-8.8 7.2-16 16-16h48c8.8 0 16 7.2 16 16v112h65.4c14.2 0 21.4 17.2 11.3 27.3z">
     </path>
 </svg>
@@ -672,7 +672,7 @@ uuid
       
     </aside>
   </div>
-</div><script src="_static/documentation_options.js?v=a39c154c"></script>
+</div><script src="_static/documentation_options.js?v=525daa63"></script>
     <script src="_static/doctools.js?v=9bcbadda"></script>
     <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="_static/scripts/furo.js?v=46bd48cc"></script>

pex/docs/html/search.html

@@ -6,7 +6,7 @@
         <link rel="prefetch" href="_static/pex-logo-light.png" as="image">
         <link rel="prefetch" href="_static/pex-logo-dark.png" as="image">
 
-    <link rel="shortcut icon" href="_static/pex-icon.png"><!-- Generated with Sphinx 8.2.3 and Furo 2025.09.25 --><title>Search - Pex Docs (v2.64.1)</title><link rel="stylesheet" type="text/css" href="_static/pygments.css?v=d111a655" />
+    <link rel="shortcut icon" href="_static/pex-icon.png"><!-- Generated with Sphinx 8.2.3 and Furo 2025.09.25 --><title>Search - Pex Docs (v2.69.0)</title><link rel="stylesheet" type="text/css" href="_static/pygments.css?v=d111a655" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo.css?v=580074bf" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo-extensions.css?v=8dab3a3b" />
     
@@ -176,7 +176,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="index.html"><div class="brand">Pex Docs (v2.64.1)</div></a>
+      <a href="index.html"><div class="brand">Pex Docs (v2.69.0)</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -273,12 +273,12 @@
           </div>
           <div class="right-details">
             <div class="icons">
-              <a class="muted-link " href="https://pypi.org/project/pex/2.64.1/" aria-label="PyPI"><svg stroke="currentColor" fill="currentColor" stroke-width="0" viewBox="0 0 448 512" height="1em" width="1em" xmlns="http://www.w3.org/2000/svg">
+              <a class="muted-link " href="https://pypi.org/project/pex/2.69.0/" aria-label="PyPI"><svg stroke="currentColor" fill="currentColor" stroke-width="0" viewBox="0 0 448 512" height="1em" width="1em" xmlns="http://www.w3.org/2000/svg">
     <path d="M439.8 200.5c-7.7-30.9-22.3-54.2-53.4-54.2h-40.1v47.4c0 36.8-31.2 67.8-66.8 67.8H172.7c-29.2 0-53.4 25-53.4 54.3v101.8c0 29 25.2 46 53.4 54.3 33.8 9.9 66.3 11.7 106.8 0 26.9-7.8 53.4-23.5 53.4-54.3v-40.7H226.2v-13.6h160.2c31.1 0 42.6-21.7 53.4-54.2 11.2-33.5 10.7-65.7 0-108.6zM286.2 404c11.1 0 20.1 9.1 20.1 20.3 0 11.3-9 20.4-20.1 20.4-11 0-20.1-9.2-20.1-20.4.1-11.3 9.1-20.3 20.1-20.3zM167.8 248.1h106.8c29.7 0 53.4-24.5 53.4-54.3V91.9c0-29-24.4-50.7-53.4-55.6-35.8-5.9-74.7-5.6-106.8.1-45.2 8-53.4 24.7-53.4 55.6v40.7h106.9v13.6h-147c-31.1 0-58.3 18.7-66.8 54.2-9.8 40.7-10.2 66.1 0 108.6 7.6 31.6 25.7 54.2 56.8 54.2H101v-48.8c0-35.3 30.5-66.4 66.8-66.4zm-6.7-142.6c-11.1 0-20.1-9.1-20.1-20.3.1-11.3 9-20.4 20.1-20.4 11 0 20.1 9.2 20.1 20.4s-9 20.3-20.1 20.3z">
     </path>
 </svg>
 </a>
-              <a class="muted-link " href="https://github.com/pex-tool/pex/releases/download/v2.64.1/pex" aria-label="Download"><svg stroke="currentColor" fill="currentColor" stroke-width="0" viewBox="0 0 640 512" height="1em" width="1em" xmlns="http://www.w3.org/2000/svg">
+              <a class="muted-link " href="https://github.com/pex-tool/pex/releases/download/v2.69.0/pex" aria-label="Download"><svg stroke="currentColor" fill="currentColor" stroke-width="0" viewBox="0 0 640 512" height="1em" width="1em" xmlns="http://www.w3.org/2000/svg">
     <path d="M537.6 226.6c4.1-10.7 6.4-22.4 6.4-34.6 0-53-43-96-96-96-19.7 0-38.1 6-53.3 16.2C367 64.2 315.3 32 256 32c-88.4 0-160 71.6-160 160 0 2.7.1 5.4.2 8.1C40.2 219.8 0 273.2 0 336c0 79.5 64.5 144 144 144h368c70.7 0 128-57.3 128-128 0-61.9-44-113.6-102.4-125.4zm-132.9 88.7L299.3 420.7c-6.2 6.2-16.4 6.2-22.6 0L171.3 315.3c-10.1-10.1-2.9-27.3 11.3-27.3H248V176c0-8.8 7.2-16 16-16h48c8.8 0 16 7.2 16 16v112h65.4c14.2 0 21.4 17.2 11.3 27.3z">
     </path>
 </svg>
@@ -301,7 +301,7 @@
       
     </aside>
   </div>
-</div><script src="_static/documentation_options.js?v=a39c154c"></script>
+</div><script src="_static/documentation_options.js?v=525daa63"></script>
     <script src="_static/doctools.js?v=9bcbadda"></script>
     <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="_static/scripts/furo.js?v=46bd48cc"></script>