pex 2.59.5__py2.py3-none-any.whl → 2.60.1__py2.py3-none-any.whl

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.59.5)</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.60.1)</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.59.5)</div></a>
+      <a href="index.html"><div class="brand">Pex Docs (v2.60.1)</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.59.5/" 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.60.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">
     <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.59.5/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.60.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">
     <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=3d1e70f3"></script>
+</div><script src="_static/documentation_options.js?v=bfb83a69"></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/whatispex.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>What are .pex files? - Pex Docs (v2.59.5)</title>
+        <title>What are .pex files? - Pex Docs (v2.60.1)</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.59.5)</div></a>
+      <a href="index.html"><div class="brand">Pex Docs (v2.60.1)</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -322,12 +322,12 @@ build executable .pex files.  This is described more thoroughly in
           </div>
           <div class="right-details">
             <div class="icons">
-              <a class="muted-link " href="https://pypi.org/project/pex/2.59.5/" 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.60.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">
     <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.59.5/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.60.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">
     <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>
@@ -371,7 +371,7 @@ build executable .pex files.  This is described more thoroughly in
       
     </aside>
   </div>
-</div><script src="_static/documentation_options.js?v=3d1e70f3"></script>
+</div><script src="_static/documentation_options.js?v=bfb83a69"></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/entry_points_txt.py

@@ -0,0 +1,98 @@
+# Copyright 2025 Pex project contributors.
+# Licensed under the Apache License, Version 2.0 (see LICENSE).
+
+from __future__ import absolute_import, print_function
+
+import itertools
+import os
+from textwrap import dedent
+
+from pex import windows
+from pex.common import safe_open
+from pex.dist_metadata import CallableEntryPoint, EntryPoints
+from pex.exceptions import reportable_unexpected_error_msg
+from pex.executables import chmod_plus_x
+from pex.interpreter import PythonInterpreter
+from pex.os import WINDOWS
+from pex.typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from typing import Iterator, Optional, Text, Tuple
+
+
+def install_scripts(
+    dest_dir,  # type: str
+    entry_points,  # type: EntryPoints
+    interpreter=None,  # type: Optional[PythonInterpreter]
+    overwrite=True,  # type: bool
+):
+    # type: (...) -> Iterator[Tuple[Text, Text]]
+
+    if not entry_points:
+        return
+
+    if entry_points.source is None:
+        raise AssertionError(reportable_unexpected_error_msg())
+
+    script_src = entry_points.source
+    shebang = interpreter.shebang() if interpreter else "#!python"
+    for named_entry_point, gui in itertools.chain.from_iterable(
+        ((value, gui) for value in entry_points.get(key, {}).values())
+        for key, gui in (("console_scripts", False), ("gui_scripts", True))
+    ):
+        entry_point = named_entry_point.entry_point
+        if isinstance(entry_point, CallableEntryPoint):
+            script = dedent(
+                """\
+                {shebang}
+                # -*- coding: utf-8 -*-
+                import importlib
+                import sys
+
+                entry_point = importlib.import_module({modname!r})
+                for attr in {attrs!r}:
+                    entry_point = getattr(entry_point, attr)
+
+                if __name__ == "__main__":
+                    import os
+                    pex_root_fallback = os.environ.get("_PEX_ROOT_FALLBACK")
+                    if pex_root_fallback:
+                        import atexit
+                        import shutil
+
+                        atexit.register(shutil.rmtree, pex_root_fallback, True)
+
+                    sys.exit(entry_point())
+                """
+            ).format(shebang=shebang, modname=entry_point.module, attrs=entry_point.attrs)
+        else:
+            script = dedent(
+                """\
+                {shebang}
+                # -*- coding: utf-8 -*-
+                import runpy
+                import sys
+
+                if __name__ == "__main__":
+                    import os
+                    pex_root_fallback = os.environ.get("_PEX_ROOT_FALLBACK")
+                    if pex_root_fallback:
+                        import atexit
+                        import shutil
+
+                        atexit.register(shutil.rmtree, pex_root_fallback, True)
+
+                    runpy.run_module({modname!r}, run_name="__main__", alter_sys=True)
+                    sys.exit(0)
+                """
+            ).format(shebang=shebang, modname=entry_point.module)
+        script_abspath = os.path.join(dest_dir, named_entry_point.name)
+        if WINDOWS:
+            script_abspath = windows.create_script(
+                script_abspath, script, gui=gui, overwrite=overwrite
+            )
+        elif overwrite or not os.path.exists(script_abspath):
+            with safe_open(script_abspath, "w") as fp:
+                fp.write(script)
+            chmod_plus_x(fp.name)
+        yield script_src, script_abspath

pex/environment.py

@@ -26,6 +26,7 @@ from pex.third_party.packaging import specifiers
 from pex.third_party.packaging.tags import Tag
 from pex.tracer import TRACER
 from pex.typing import TYPE_CHECKING
+from pex.whl import repacked_whl
 
 if TYPE_CHECKING:
     from typing import (
@@ -305,12 +306,7 @@ class PEXEnvironment(object):
 
     def iter_distributions(self, result_type_wheel_file=False):
         # type: (bool) -> Iterator[FingerprintedDistribution]
-        if result_type_wheel_file:
-            if not self._pex_info.deps_are_wheel_files:
-                raise ResolveError(
-                    "Cannot resolve .whl files from PEX at {pex}; its dependencies are in the "
-                    "form of pre-installed wheel chroots.".format(pex=self.source_pex)
-                )
+        if result_type_wheel_file and self._pex_info.deps_are_wheel_files:
             with TRACER.timed(
                 "Searching dependency cache: {cache}".format(
                     cache=os.path.join(self.source_pex, self._pex_info.internal_cache)
@@ -334,10 +330,17 @@ class PEXEnvironment(object):
             ):
                 for distribution_name, fingerprint in self._pex_info.distributions.items():
                     dist_path = os.path.join(internal_cache, distribution_name)
-                    yield FingerprintedDistribution(
-                        distribution=Distribution.load(dist_path),
-                        fingerprint=fingerprint,
-                    )
+                    if result_type_wheel_file:
+                        yield repacked_whl(
+                            installed_wheel=dist_path,
+                            distribution_name=distribution_name,
+                            fingerprint=fingerprint,
+                            use_system_time=True,
+                        )
+                    else:
+                        yield FingerprintedDistribution(
+                            distribution=Distribution.load(dist_path), fingerprint=fingerprint
+                        )
 
     def _update_candidate_distributions(self, distribution_iter):
         # type: (Iterable[FingerprintedDistribution]) -> None

pex/finders.py

@@ -15,7 +15,7 @@ from pex.dist_metadata import (
     NamedEntryPoint,
 )
 from pex.executables import is_python_script
-from pex.pep_376 import InstalledWheel
+from pex.installed_wheel import InstalledWheel
 from pex.pep_503 import ProjectName
 from pex.sysconfig import SCRIPT_DIR, script_name
 from pex.typing import TYPE_CHECKING, cast

pex/installed_wheel.py

@@ -0,0 +1,127 @@
+# Copyright 2025 Pex project contributors.
+# Licensed under the Apache License, Version 2.0 (see LICENSE).
+
+from __future__ import absolute_import
+
+import hashlib
+import json
+import os
+
+from pex.typing import TYPE_CHECKING, cast
+from pex.util import CacheHelper
+from pex.wheel import WHEEL, Wheel, WheelMetadataLoadError
+
+if TYPE_CHECKING:
+    from typing import Optional, Text
+
+    import attr  # vendor:skip
+else:
+    import pex.third_party.attr as attr
+
+
+@attr.s(frozen=True)
+class InstalledWheel(object):
+    class LoadError(Exception):
+        """Indicates an installed wheel was not loadable at a particular path."""
+
+    _LAYOUT_JSON_FILENAME = ".layout.json"
+
+    @classmethod
+    def layout_file(cls, prefix_dir):
+        # type: (str) -> str
+        return os.path.join(prefix_dir, cls._LAYOUT_JSON_FILENAME)
+
+    @classmethod
+    def save(
+        cls,
+        prefix_dir,  # type: str
+        stash_dir,  # type: str
+        record_relpath,  # type: Text
+        root_is_purelib,  # type: bool
+    ):
+        # type: (...) -> InstalledWheel
+
+        # We currently need the installed wheel chroot hash for PEX-INFO / boot purposes. It is
+        # expensive to calculate; so we do it here 1 time when saving the installed wheel.
+        fingerprint = CacheHelper.dir_hash(prefix_dir, hasher=hashlib.sha256)
+
+        layout = {
+            "stash_dir": stash_dir,
+            "record_relpath": record_relpath,
+            "fingerprint": fingerprint,
+            "root_is_purelib": root_is_purelib,
+        }
+        with open(cls.layout_file(prefix_dir), "w") as fp:
+            json.dump(layout, fp, sort_keys=True, separators=(",", ":"))
+        return cls(
+            prefix_dir=prefix_dir,
+            stash_dir=stash_dir,
+            record_relpath=record_relpath,
+            fingerprint=fingerprint,
+            root_is_purelib=root_is_purelib,
+        )
+
+    @classmethod
+    def load(cls, prefix_dir):
+        # type: (str) -> InstalledWheel
+        layout_file = cls.layout_file(prefix_dir)
+        try:
+            with open(layout_file) as fp:
+                layout = json.load(fp)
+        except (IOError, OSError) as e:
+            raise cls.LoadError(
+                "Failed to load an installed wheel layout from {layout_file}: {err}".format(
+                    layout_file=layout_file, err=e
+                )
+            )
+        if not isinstance(layout, dict):
+            raise cls.LoadError(
+                "The installed wheel layout file at {layout_file} must contain a single top-level "
+                "object, found: {value}.".format(layout_file=layout_file, value=layout)
+            )
+        stash_dir = layout.get("stash_dir")
+        record_relpath = layout.get("record_relpath")
+        if not stash_dir or not record_relpath:
+            raise cls.LoadError(
+                "The installed wheel layout file at {layout_file} must contain an object with both "
+                "`stash_dir` and `record_relpath` attributes, found: {value}".format(
+                    layout_file=layout_file, value=layout
+                )
+            )
+
+        fingerprint = layout.get("fingerprint")
+
+        # N.B.: Caching root_is_purelib was not part of the original InstalledWheel layout data; so
+        # we materialize the property if needed to support older installed wheel chroots.
+        root_is_purelib = layout.get("root_is_purelib")
+        if root_is_purelib is None:
+            try:
+                wheel = WHEEL.load(prefix_dir)
+            except WheelMetadataLoadError as e:
+                raise cls.LoadError(
+                    "Failed to determine if installed wheel at {location} is platform-specific: "
+                    "{err}".format(location=prefix_dir, err=e)
+                )
+            root_is_purelib = wheel.root_is_purelib
+
+        return cls(
+            prefix_dir=prefix_dir,
+            stash_dir=cast(str, stash_dir),
+            record_relpath=cast(str, record_relpath),
+            fingerprint=cast("Optional[str]", fingerprint),
+            root_is_purelib=root_is_purelib,
+        )
+
+    prefix_dir = attr.ib()  # type: str
+    stash_dir = attr.ib()  # type: str
+    record_relpath = attr.ib()  # type: Text
+    fingerprint = attr.ib()  # type: Optional[str]
+    root_is_purelib = attr.ib()  # type: bool
+
+    def wheel_file_name(self):
+        # type: () -> str
+        return Wheel.load(self.prefix_dir).wheel_file_name
+
+    def stashed_path(self, *components):
+        # type: (*str) -> str
+        return os.path.join(self.prefix_dir, self.stash_dir, *components)

pex/interpreter.py

@@ -483,7 +483,7 @@ class PythonIdentity(object):
             env_markers=self._env_markers.as_dict(),
             configured_macosx_deployment_target=self._configured_macosx_deployment_target,
         )
-        return json.dumps(values, sort_keys=True)
+        return json.dumps(values, sort_keys=True, separators=(",", ":"))
 
     @property
     def binary(self):
@@ -1525,13 +1525,19 @@ class PythonInterpreter(object):
             self._supported_platforms = frozenset(self._identity.iter_supported_platforms())
         return self._supported_platforms
 
-    def shebang(self, args=None):
-        # type: (Optional[Text]) -> Text
+    def shebang(
+        self,
+        args=None,  # type: Optional[Text]
+        encoding_line="",  # type: str
+    ):
+        # type: (...) -> Text
         """Return the contents of an appropriate shebang for this interpreter and args.
 
         The shebang will include the leading `#!` but will not include a trailing new line character.
         """
-        return create_shebang(self._binary, python_args=args)
+        return create_shebang(
+            adjust_to_final_path(self._binary), python_args=args, encoding_line=encoding_line
+        )
 
     def create_isolated_cmd(
         self,
@@ -1637,6 +1643,7 @@ def create_shebang(
     python_exe,  # type: Text
     python_args=None,  # type: Optional[Text]
     max_shebang_length=MAX_SHEBANG_LENGTH,  # type: int
+    encoding_line="",  # type: str
 ):
     # type: (...) -> Text
     """Return the contents of an appropriate shebang for the given Python interpreter and args.
@@ -1662,6 +1669,7 @@ def create_shebang(
         dedent(
             """\
             #!/bin/sh
+            {encoding_line}
             # N.B.: This python script executes via a /bin/sh re-exec as a hack to work around a
             # potential maximum shebang length of {max_shebang_length} bytes on this system which
             # the python interpreter `exec`ed below would violate.
@@ -1669,6 +1677,10 @@ def create_shebang(
             '''
             """
         )
-        .format(max_shebang_length=max_shebang_length, python=python)
+        .format(
+            encoding_line=encoding_line.rstrip(),
+            max_shebang_length=max_shebang_length,
+            python=python,
+        )
         .strip()
     )

pex/interpreter_constraints.py

@@ -375,10 +375,10 @@ COMPATIBLE_PYTHON_VERSIONS = (
     PythonVersion(Lifecycle.EOL, 3, 6, 15),
     PythonVersion(Lifecycle.EOL, 3, 7, 17),
     PythonVersion(Lifecycle.EOL, 3, 8, 20),
-    PythonVersion(Lifecycle.STABLE, 3, 9, 23),
-    PythonVersion(Lifecycle.STABLE, 3, 10, 18),
-    PythonVersion(Lifecycle.STABLE, 3, 11, 13),
-    PythonVersion(Lifecycle.STABLE, 3, 12, 11),
+    PythonVersion(Lifecycle.STABLE, 3, 9, 24),
+    PythonVersion(Lifecycle.STABLE, 3, 10, 19),
+    PythonVersion(Lifecycle.STABLE, 3, 11, 14),
+    PythonVersion(Lifecycle.STABLE, 3, 12, 12),
     PythonVersion(Lifecycle.STABLE, 3, 13, 8),
     PythonVersion(Lifecycle.STABLE, 3, 14, 0),
     PythonVersion(Lifecycle.DEV, 3, 15, 0),