pex 2.57.0__py2.py3-none-any.whl → 2.58.1__py2.py3-none-any.whl

pex/auth.py

@@ -64,7 +64,7 @@ class Machine(object):
 class PasswordEntry(object):
     @classmethod
     def maybe_extract_from_url(cls, url):
-        # type: (str) -> Optional[PasswordEntry]
+        # type: (Text) -> Optional[PasswordEntry]
         url_info = urlparse.urlparse(url)
         if not url_info.username or not url_info.password:
             return None

pex/build_system/pep_517.py

@@ -11,7 +11,7 @@ from textwrap import dedent
 from pex import third_party
 from pex.build_system import DEFAULT_BUILD_BACKEND
 from pex.build_system.pep_518 import BuildSystem, load_build_system
-from pex.common import safe_mkdtemp
+from pex.common import safe_mkdir, safe_mkdtemp
 from pex.dist_metadata import DistMetadata, Distribution, MetadataType
 from pex.jobs import Job, SpawnedJob
 from pex.pip.version import PipVersion, PipVersionValue
@@ -227,6 +227,9 @@ def build_sdist(
                 "{stderr}".format(project_directory=project_directory, err=e, stderr=e.stderr)
             )
 
+    # N.B.: Although it's not clear the spec mandates this, ensure the dist dir exists before
+    # handing it to the back end. See: https://github.com/pex-tool/pex/issues/2913 for motivation.
+    safe_mkdir(dist_dir)
     spawned_job_or_error = _invoke_build_hook(
         project_directory,
         target,

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

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

pex/docs/html/_static/documentation_options.js

@@ -1,5 +1,5 @@
 const DOCUMENTATION_OPTIONS = {
-    VERSION: '2.57.0',
+    VERSION: '2.58.1',
     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.07.19 -->
-        <title>PEX runtime environment variables - Pex Docs (v2.57.0)</title>
+        <title>PEX runtime environment variables - Pex Docs (v2.58.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=25af2a20" />
     <link rel="stylesheet" type="text/css" href="../_static/styles/furo-extensions.css?v=8dab3a3b" />
@@ -168,7 +168,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="../index.html"><div class="brand">Pex Docs (v2.57.0)</div></a>
+      <a href="../index.html"><div class="brand">Pex Docs (v2.58.1)</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -652,12 +652,12 @@
           </div>
           <div class="right-details">
             <div class="icons">
-              <a class="muted-link " href="https://pypi.org/project/pex/2.57.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">
+              <a class="muted-link " href="https://pypi.org/project/pex/2.58.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.57.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">
+              <a class="muted-link " href="https://github.com/pex-tool/pex/releases/download/v2.58.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>
@@ -680,7 +680,7 @@
       
     </aside>
   </div>
-</div><script src="../_static/documentation_options.js?v=a2d10b90"></script>
+</div><script src="../_static/documentation_options.js?v=b0ba200d"></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.07.19 -->
-        <title>Building .pex files - Pex Docs (v2.57.0)</title>
+        <title>Building .pex files - Pex Docs (v2.58.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=25af2a20" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo-extensions.css?v=8dab3a3b" />
@@ -168,7 +168,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="index.html"><div class="brand">Pex Docs (v2.57.0)</div></a>
+      <a href="index.html"><div class="brand">Pex Docs (v2.58.1)</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -690,12 +690,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.57.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">
+              <a class="muted-link " href="https://pypi.org/project/pex/2.58.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.57.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">
+              <a class="muted-link " href="https://github.com/pex-tool/pex/releases/download/v2.58.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>
@@ -718,7 +718,7 @@ scary like <code class="docutils literal notranslate"><span class="pre">sudo</sp
       
     </aside>
   </div>
-</div><script src="_static/documentation_options.js?v=a2d10b90"></script>
+</div><script src="_static/documentation_options.js?v=b0ba200d"></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.07.19 --><title>Index - Pex Docs (v2.57.0)</title>
+    <link rel="shortcut icon" href="_static/pex-icon.png"/><!-- Generated with Sphinx 8.2.3 and Furo 2025.07.19 --><title>Index - Pex Docs (v2.58.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=25af2a20" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo-extensions.css?v=8dab3a3b" />
@@ -166,7 +166,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="index.html"><div class="brand">Pex Docs (v2.57.0)</div></a>
+      <a href="index.html"><div class="brand">Pex Docs (v2.58.1)</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -269,12 +269,12 @@
           </div>
           <div class="right-details">
             <div class="icons">
-              <a class="muted-link " href="https://pypi.org/project/pex/2.57.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">
+              <a class="muted-link " href="https://pypi.org/project/pex/2.58.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.57.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">
+              <a class="muted-link " href="https://github.com/pex-tool/pex/releases/download/v2.58.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>
@@ -297,7 +297,7 @@
       
     </aside>
   </div>
-</div><script src="_static/documentation_options.js?v=a2d10b90"></script>
+</div><script src="_static/documentation_options.js?v=b0ba200d"></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.07.19 -->
-        <title>Pex Docs (v2.57.0)</title>
+        <title>Pex Docs (v2.58.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=25af2a20" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo-extensions.css?v=8dab3a3b" />
@@ -168,7 +168,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="#"><div class="brand">Pex Docs (v2.57.0)</div></a>
+      <a href="#"><div class="brand">Pex Docs (v2.58.1)</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -350,12 +350,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.57.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">
+              <a class="muted-link " href="https://pypi.org/project/pex/2.58.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.57.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">
+              <a class="muted-link " href="https://github.com/pex-tool/pex/releases/download/v2.58.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>
@@ -398,7 +398,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=a2d10b90"></script>
+</div><script src="_static/documentation_options.js?v=b0ba200d"></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.07.19 -->
-        <title>PEX Recipes and Notes - Pex Docs (v2.57.0)</title>
+        <title>PEX Recipes and Notes - Pex Docs (v2.58.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=25af2a20" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo-extensions.css?v=8dab3a3b" />
@@ -168,7 +168,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="index.html"><div class="brand">Pex Docs (v2.57.0)</div></a>
+      <a href="index.html"><div class="brand">Pex Docs (v2.58.1)</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -439,12 +439,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.57.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">
+              <a class="muted-link " href="https://pypi.org/project/pex/2.58.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.57.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">
+              <a class="muted-link " href="https://github.com/pex-tool/pex/releases/download/v2.58.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>
@@ -491,7 +491,7 @@ $<span class="w"> </span><span class="nb">export</span><span class="w"> </span><
       
     </aside>
   </div>
-</div><script src="_static/documentation_options.js?v=a2d10b90"></script>
+</div><script src="_static/documentation_options.js?v=b0ba200d"></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.07.19 -->
-        <title>PEX with included Python interpreter - Pex Docs (v2.57.0)</title>
+        <title>PEX with included Python interpreter - Pex Docs (v2.58.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=25af2a20" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo-extensions.css?v=8dab3a3b" />
@@ -168,7 +168,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="index.html"><div class="brand">Pex Docs (v2.57.0)</div></a>
+      <a href="index.html"><div class="brand">Pex Docs (v2.58.1)</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -632,12 +632,12 @@ uuid
           </div>
           <div class="right-details">
             <div class="icons">
-              <a class="muted-link " href="https://pypi.org/project/pex/2.57.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">
+              <a class="muted-link " href="https://pypi.org/project/pex/2.58.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.57.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">
+              <a class="muted-link " href="https://github.com/pex-tool/pex/releases/download/v2.58.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>
@@ -681,7 +681,7 @@ uuid
       
     </aside>
   </div>
-</div><script src="_static/documentation_options.js?v=a2d10b90"></script>
+</div><script src="_static/documentation_options.js?v=b0ba200d"></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.07.19 --><title>Search - Pex Docs (v2.57.0)</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.07.19 --><title>Search - Pex Docs (v2.58.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=25af2a20" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo-extensions.css?v=8dab3a3b" />
     
@@ -181,7 +181,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="index.html"><div class="brand">Pex Docs (v2.57.0)</div></a>
+      <a href="index.html"><div class="brand">Pex Docs (v2.58.1)</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -282,12 +282,12 @@
           </div>
           <div class="right-details">
             <div class="icons">
-              <a class="muted-link " href="https://pypi.org/project/pex/2.57.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">
+              <a class="muted-link " href="https://pypi.org/project/pex/2.58.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.57.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">
+              <a class="muted-link " href="https://github.com/pex-tool/pex/releases/download/v2.58.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>
@@ -310,7 +310,7 @@
       
     </aside>
   </div>
-</div><script src="_static/documentation_options.js?v=a2d10b90"></script>
+</div><script src="_static/documentation_options.js?v=b0ba200d"></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.07.19 -->
-        <title>What are .pex files? - Pex Docs (v2.57.0)</title>
+        <title>What are .pex files? - Pex Docs (v2.58.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=25af2a20" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo-extensions.css?v=8dab3a3b" />
@@ -168,7 +168,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="index.html"><div class="brand">Pex Docs (v2.57.0)</div></a>
+      <a href="index.html"><div class="brand">Pex Docs (v2.58.1)</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -331,12 +331,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.57.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">
+              <a class="muted-link " href="https://pypi.org/project/pex/2.58.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.57.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">
+              <a class="muted-link " href="https://github.com/pex-tool/pex/releases/download/v2.58.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>
@@ -380,7 +380,7 @@ build executable .pex files.  This is described more thoroughly in
       
     </aside>
   </div>
-</div><script src="_static/documentation_options.js?v=a2d10b90"></script>
+</div><script src="_static/documentation_options.js?v=b0ba200d"></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/pip/tool.py

@@ -21,6 +21,7 @@ from pex.common import safe_mkdir, safe_mkdtemp
 from pex.compatibility import get_stderr_bytes_buffer, shlex_quote, urlparse
 from pex.dependency_configuration import DependencyConfiguration
 from pex.dist_metadata import Requirement
+from pex.fetcher import URLFetcher
 from pex.interpreter import PythonInterpreter
 from pex.jobs import Job
 from pex.network_configuration import NetworkConfiguration
@@ -53,6 +54,7 @@ if TYPE_CHECKING:
         Match,
         Optional,
         Sequence,
+        Text,
         Tuple,
         Union,
     )
@@ -64,8 +66,8 @@ else:
 
 @attr.s(frozen=True)
 class PipArgs(object):
-    indexes = attr.ib(default=None)  # type: Optional[Sequence[str]]
-    find_links = attr.ib(default=None)  # type: Optional[Iterable[str]]
+    indexes = attr.ib(default=None)  # type: Optional[Sequence[Text]]
+    find_links = attr.ib(default=None)  # type: Optional[Iterable[Text]]
     network_configuration = attr.ib(default=None)  # type: Optional[NetworkConfiguration]
 
     def iter(self, version):
@@ -217,9 +219,17 @@ class PackageIndexConfiguration(object):
         self,
         pip_version,  # type: PipVersionValue
         target,  # type:  Union[UniversalTarget, MarkerEnvironment]
+        requirement_files=None,  # type: Optional[Iterable[str]]
     ):
         # type: (...) -> Optional[DownloadObserver]
-        return package_repositories.patch(self.repos_configuration, pip_version, target)
+        return package_repositories.patch(
+            repos_configuration=self.repos_configuration.with_contained_repos(
+                requirement_files,
+                fetcher=URLFetcher(network_configuration=self.network_configuration),
+            ),
+            pip_version=pip_version,
+            target=target,
+        )
 
 
 if TYPE_CHECKING:
@@ -640,7 +650,9 @@ class Pip(object):
             ),
             (
                 package_index_configuration.patch(
-                    pip_version=self.version, target=universal_target or target.marker_environment
+                    pip_version=self.version,
+                    target=universal_target or target.marker_environment,
+                    requirement_files=requirement_files,
                 )
                 if package_index_configuration
                 else None

pex/requirements.py

@@ -5,6 +5,9 @@ from __future__ import absolute_import
 
 import os
 import re
+import shlex
+import sys
+from argparse import ArgumentParser
 from contextlib import contextmanager
 
 from pex import attrs, dist_metadata, pex_warnings
@@ -17,6 +20,7 @@ from pex.dist_metadata import (
     RequirementParseError,
 )
 from pex.fetcher import URLFetcher
+from pex.orderedset import OrderedSet
 from pex.pep_503 import ProjectName
 from pex.third_party.packaging.markers import Marker
 from pex.third_party.packaging.specifiers import SpecifierSet
@@ -139,7 +143,7 @@ class Source(object):
 
 
 @attr.s(frozen=True)
-class _ParsedRequirement(object):
+class _ParsedItem(object):
     line = attr.ib()  # type: LogicalLine
 
     def __str__(self):
@@ -148,7 +152,22 @@ class _ParsedRequirement(object):
 
 
 @attr.s(frozen=True)
-class PyPIRequirement(_ParsedRequirement):
+class _Repo(_ParsedItem):
+    location = attr.ib()  # Text
+
+
+@attr.s(frozen=True)
+class FindLinks(_Repo):
+    pass
+
+
+@attr.s(frozen=True)
+class Index(_Repo):
+    pass
+
+
+@attr.s(frozen=True)
+class PyPIRequirement(_ParsedItem):
     """A requirement realized through a package index or find links repository."""
 
     requirement = attr.ib()  # type: Requirement
@@ -169,7 +188,7 @@ class PyPIRequirement(_ParsedRequirement):
 
 
 @attr.s(frozen=True)
-class URLRequirement(_ParsedRequirement):
+class URLRequirement(_ParsedItem):
     """A requirement realized through a distribution archive at a fixed URL."""
 
     url = attr.ib()  # type: ArtifactURL
@@ -202,7 +221,7 @@ class URLRequirement(_ParsedRequirement):
 
 
 @attr.s(frozen=True)
-class VCSRequirement(_ParsedRequirement):
+class VCSRequirement(_ParsedItem):
     """A requirement realized by building a distribution from sources retrieved from a VCS."""
 
     vcs = attr.ib()  # type: VCS.Value
@@ -269,7 +288,7 @@ def parse_requirement_from_dist(
 
 
 @attr.s(frozen=True)
-class LocalProjectRequirement(_ParsedRequirement):
+class LocalProjectRequirement(_ParsedItem):
     """A requirement realized by building a distribution from local sources."""
 
     path = attr.ib()  # type: str
@@ -306,7 +325,7 @@ if TYPE_CHECKING:
 
 
 @attr.s(frozen=True)
-class Constraint(_ParsedRequirement):
+class Constraint(_ParsedItem):
     requirement = attr.ib()  # type: Requirement
 
     @property
@@ -630,11 +649,59 @@ def _get_parameter(line):
     return split_line[1]
 
 
+_REPOS_PARSER = None  # type: Optional[ArgumentParser]
+
+
+def _parse_repos(line):
+    # type: (LogicalLine) -> Iterator[Union[FindLinks, Index]]
+
+    try:
+        # The arg-type type ignore is due to Python 2.7 shlex.split not being able to parse unicode
+        # strings; but we handle that with a useful error message.
+        args = shlex.split(line.processed_text)  # type: ignore[arg-type]
+    except UnicodeEncodeError as e:
+        raise ParseError(
+            line,
+            "Options line has unicode characters which are not supported under Python {version}: "
+            "{err}".format(version=".".join(map(str, sys.version[:2])), err=e),
+        )
+
+    global _REPOS_PARSER
+    if _REPOS_PARSER is not None:
+        parser = _REPOS_PARSER
+    else:
+        parser = ArgumentParser()
+        # See:
+        # + https://pip.pypa.io/en/stable/reference/requirements-file-format/#global-options
+        # + https://pip.pypa.io/en/stable/cli/pip_install/#cmdoption-f
+        # + https://pip.pypa.io/en/stable/cli/pip_install/#cmdoption-i
+        # + https://pip.pypa.io/en/stable/cli/pip_install/#cmdoption-extra-index-url
+        parser.add_argument("-f", "--find-links", dest="find_links", action="append", default=[])
+        parser.add_argument("-i", "--index-url", dest="index_url")
+        parser.add_argument(
+            "--extra-index-url", dest="extra_index_urls", action="append", default=[]
+        )
+        _REPOS_PARSER = parser
+
+    options, _ = parser.parse_known_args(args)
+
+    for find_links in OrderedSet(options.find_links):  # type: OrderedSet[str]
+        yield FindLinks(line, location=find_links)
+
+    index_locations = OrderedSet()  # type: OrderedSet[str]
+    if options.index_url:
+        index_locations.add(options.index_url)
+    index_locations.update(options.extra_index_urls)
+
+    for index in index_locations:
+        yield Index(line, location=index)
+
+
 def parse_requirements(
     source,  # type: Source
     fetcher=None,  # type: Optional[URLFetcher]
 ):
-    # type: (...) -> Iterator[Union[ParsedRequirement, Constraint]]
+    # type: (...) -> Iterator[Union[ParsedRequirement, Constraint, FindLinks, Index]]
 
     # For the format specification, see:
     #   https://pip.pypa.io/en/stable/reference/pip_install/#requirements-file-format
@@ -686,11 +753,17 @@ def parse_requirements(
                         yield requirement
                 continue
 
-            # Skip empty lines, comment lines and all Pip global options.
-            if not processed_text or (
-                processed_text.startswith("-")
-                and not re.match(r"^(?:-e|--editable)\s.*", processed_text)
+            # Skip empty lines and comment lines.
+            if not processed_text:
+                continue
+
+            if processed_text.startswith("-") and not re.match(
+                # N.B.: We deal with editable when parsing requirement lines below.
+                r"^(?:-e|--editable)\s.*",
+                processed_text,
             ):
+                for repo in _parse_repos(logical_line):
+                    yield repo
                 continue
 
             # Only requirement lines remain.
@@ -721,7 +794,7 @@ def parse_requirement_file(
     is_constraints=False,  # type: bool
     fetcher=None,  # type: Optional[URLFetcher]
 ):
-    # type: (...) -> Iterator[Union[ParsedRequirement, Constraint]]
+    # type: (...) -> Iterator[Union[ParsedRequirement, Constraint, FindLinks, Index]]
     def open_source():
         url = urlparse.urlparse(location)
         if url.scheme and url.netloc:

pex/resolve/package_repository.py

@@ -6,12 +6,23 @@ from __future__ import absolute_import
 import itertools
 import os
 import re
+from collections import OrderedDict, defaultdict
 
 from pex.auth import PasswordEntry
 from pex.compatibility import string
 from pex.dist_metadata import Requirement, RequirementParseError
 from pex.exceptions import production_assert, reportable_unexpected_error_msg
+from pex.fetcher import URLFetcher
+from pex.orderedset import OrderedSet
 from pex.pep_503 import ProjectName
+from pex.requirements import (
+    FindLinks,
+    Index,
+    PyPIRequirement,
+    URLRequirement,
+    VCSRequirement,
+    parse_requirement_file,
+)
 from pex.resolve.target_system import MarkerEnv
 from pex.third_party.packaging.markers import InvalidMarker, Marker
 from pex.typing import TYPE_CHECKING, cast
@@ -19,7 +30,7 @@ from pex.typing import TYPE_CHECKING, cast
 if TYPE_CHECKING:
     # N.B.: The `re.Pattern` type is not available in all Python versions Pex supports.
     from re import Pattern  # type: ignore[attr-defined]
-    from typing import Any, Dict, Iterable, List, Optional, Tuple, Union
+    from typing import Any, DefaultDict, Dict, Iterable, List, Mapping, Optional, Text, Tuple, Union
 
     import attr  # vendor:skip
 
@@ -183,7 +194,7 @@ class Repo(object):
             location=data["location"], scopes=tuple(Scope.parse(scope) for scope in data["scopes"])
         )
 
-    location = attr.ib()  # type: str
+    location = attr.ib()  # type: Text
     scopes = attr.ib(default=())  # type: Tuple[Scope, ...]
 
     def as_dict(self):
@@ -240,8 +251,8 @@ class PackageRepositories(object):
     _target_env = attr.ib()  # type: Union[Dict[str, str], MarkerEnv]
     _scoped_indexes = attr.ib(default=())  # type: Tuple[Repo, ...]
     _scoped_find_links = attr.ib(default=())  # type: Tuple[Repo, ...]
-    global_indexes = attr.ib(default=(Repo(PYPI),))  # type: Tuple[str, ...]
-    global_find_links = attr.ib(default=())  # type: Tuple[str, ...]
+    global_indexes = attr.ib(default=(Repo(PYPI),))  # type: Tuple[Text, ...]
+    global_find_links = attr.ib(default=())  # type: Tuple[Text, ...]
 
     @property
     def has_scoped_repositories(self):
@@ -266,7 +277,7 @@ class PackageRepositories(object):
         scoped_repos,  # type: Iterable[Repo]
         project_name,  # type: ProjectName
     ):
-        # type: (...) -> List[str]
+        # type: (...) -> List[Text]
         return [
             repo.location
             for repo in scoped_repos
@@ -274,11 +285,11 @@ class PackageRepositories(object):
         ]
 
     def in_scope_indexes(self, project_name):
-        # type: (ProjectName) -> List[str]
+        # type: (ProjectName) -> List[Text]
         return self._in_scope_repos(scoped_repos=self._scoped_indexes, project_name=project_name)
 
     def in_scope_find_links(self, project_name):
-        # type: (ProjectName) -> List[str]
+        # type: (ProjectName) -> List[Text]
         return self._in_scope_repos(scoped_repos=self._scoped_find_links, project_name=project_name)
 
 
@@ -289,6 +300,7 @@ class ReposConfiguration(object):
         cls,
         indexes=(),  # type: Iterable[Repo]
         find_links=(),  # type: Iterable[Repo]
+        derive_scopes_from_requirements_files=False,  # type: bool
     ):
         # type: (...) -> ReposConfiguration
         password_entries = []
@@ -301,20 +313,78 @@ class ReposConfiguration(object):
             index_repos=tuple(indexes),
             find_links_repos=tuple(find_links),
             password_entries=tuple(password_entries),
+            derive_scopes_from_requirements_files=derive_scopes_from_requirements_files,
         )
 
     index_repos = attr.ib(default=(Repo(PYPI),))  # type: Tuple[Repo, ...]
     find_links_repos = attr.ib(default=())  # type: Tuple[Repo, ...]
     password_entries = attr.ib(default=())  # type: Tuple[PasswordEntry, ...]
+    derive_scopes_from_requirements_files = attr.ib(default=False)  # type: bool
+
+    def with_contained_repos(
+        self,
+        requirement_files=None,  # type: Optional[Iterable[Text]]
+        fetcher=None,  # type: Optional[URLFetcher]
+    ):
+        # type: (...) -> ReposConfiguration
+
+        if not requirement_files:
+            return self
+
+        indexes_by_source = OrderedDict()  # type: OrderedDict[Text, OrderedSet[Text]]
+        find_links_by_source = OrderedDict()  # type: OrderedDict[Text, OrderedSet[Text]]
+        scopes_by_source = defaultdict(OrderedSet)  # type: DefaultDict[Text, OrderedSet[Scope]]
+        for item in itertools.chain.from_iterable(
+            parse_requirement_file(requirement_file, fetcher=fetcher)
+            for requirement_file in requirement_files
+        ):
+            if self.derive_scopes_from_requirements_files and isinstance(
+                item, (PyPIRequirement, URLRequirement, VCSRequirement)
+            ):
+                scopes_by_source[item.line.source].add(
+                    Scope(project=item.requirement.project_name, marker=item.requirement.marker)
+                )
+            elif isinstance(item, FindLinks):
+                find_links_by_source.setdefault(item.line.source, OrderedSet()).add(item.location)
+            elif isinstance(item, Index):
+                indexes_by_source.setdefault(item.line.source, OrderedSet()).add(item.location)
+
+        if not indexes_by_source and not find_links_by_source:
+            return self
+
+        def merge_scopes(
+            repos,  # type: Iterable[Repo]
+            locations_by_source,  # type: Mapping[Text, Iterable[Text]]
+        ):
+            scopes_by_location = OrderedDict(
+                (repo.location, OrderedSet(repo.scopes)) for repo in repos
+            )
+            for source, locations in locations_by_source.items():
+                for location in locations:
+                    scopes_by_location.setdefault(location, OrderedSet()).update(
+                        scopes_by_source[source]
+                    )
+            return tuple(
+                Repo(location=location, scopes=tuple(scopes))
+                for location, scopes in scopes_by_location.items()
+            )
+
+        return attr.evolve(
+            self,
+            index_repos=merge_scopes(repos=self.index_repos, locations_by_source=indexes_by_source),
+            find_links_repos=merge_scopes(
+                repos=self.find_links_repos, locations_by_source=find_links_by_source
+            ),
+        )
 
     @property
     def indexes(self):
-        # type: () -> Tuple[str, ...]
+        # type: () -> Tuple[Text, ...]
         return tuple(repo.location for repo in self.index_repos if not repo.scopes)
 
     @property
     def find_links(self):
-        # type: () -> Tuple[str, ...]
+        # type: () -> Tuple[Text, ...]
         return tuple(repo.location for repo in self.find_links_repos if not repo.scopes)
 
     def scoped(self, target_env):

pex/resolve/requirement_configuration.py

@@ -5,7 +5,15 @@ from __future__ import absolute_import
 
 from pex.fetcher import URLFetcher
 from pex.network_configuration import NetworkConfiguration
-from pex.requirements import Constraint, parse_requirement_file, parse_requirement_strings
+from pex.requirements import (
+    Constraint,
+    LocalProjectRequirement,
+    PyPIRequirement,
+    URLRequirement,
+    VCSRequirement,
+    parse_requirement_file,
+    parse_requirement_strings,
+)
 from pex.typing import TYPE_CHECKING
 
 if TYPE_CHECKING:
@@ -37,7 +45,10 @@ class RequirementConfiguration(object):
                     for requirement_or_constraint in parse_requirement_file(
                         requirement_file, is_constraints=False, fetcher=fetcher
                     )
-                    if not isinstance(requirement_or_constraint, Constraint)
+                    if isinstance(
+                        requirement_or_constraint,
+                        (PyPIRequirement, URLRequirement, VCSRequirement, LocalProjectRequirement),
+                    )
                 )
         return parsed_requirements
 

pex/resolve/resolver_options.py

@@ -574,6 +574,17 @@ def register_repos_options(parser):
             "in a scope, you can use a regex instead."
         ),
     )
+    parser.add_argument(
+        "--derive-sources-from-requirements-files",
+        dest="derive_scopes_from_requirements_files",
+        action=HandleBoolAction,
+        default=False,
+        help=(
+            "If any requirements files are specified that contain `-f` / `--find-links`, `-i` / "
+            "`--index-url`, or `--extra-index-url` options, automatically map these repos as the "
+            "`--source` for the requirements (if any) declared in that same requirements file."
+        ),
+    )
 
 
 def register_network_options(parser):
@@ -871,6 +882,7 @@ def create_repos_configuration(options):
         return ReposConfiguration.create(
             indexes=tuple(indexes),
             find_links=tuple(Repo(find_links_repo) for find_links_repo in options.find_links),
+            derive_scopes_from_requirements_files=options.derive_scopes_from_requirements_files,
         )
 
     parsed_indexes = _parse_package_repositories("index", scopes_by_name, options.indexes)
@@ -890,7 +902,9 @@ def create_repos_configuration(options):
 
     indexes.update(parsed_indexes.values())
     return ReposConfiguration.create(
-        indexes=tuple(indexes), find_links=tuple(parsed_find_links.values())
+        indexes=tuple(indexes),
+        find_links=tuple(parsed_find_links.values()),
+        derive_scopes_from_requirements_files=options.derive_scopes_from_requirements_files,
     )
 
 

pex/version.py

@@ -1,4 +1,4 @@
 # Copyright 2015 Pex project contributors.
 # Licensed under the Apache License, Version 2.0 (see LICENSE).
 
-__version__ = "2.57.0"
+__version__ = "2.58.1"

{pex-2.57.0.dist-info → pex-2.58.1.dist-info}/METADATA

@@ -1,15 +1,15 @@
 Metadata-Version: 2.4
 Name: pex
-Version: 2.57.0
+Version: 2.58.1
 Summary: The PEX packaging toolchain.
 Home-page: https://github.com/pex-tool/pex
-Download-URL: https://github.com/pex-tool/pex/releases/download/v2.57.0/pex
+Download-URL: https://github.com/pex-tool/pex/releases/download/v2.58.1/pex
 Author: The PEX developers
 Author-email: developers@pex-tool.org
 License-Expression: Apache-2.0
-Project-URL: Changelog, https://github.com/pex-tool/pex/blob/v2.57.0/CHANGES.md
+Project-URL: Changelog, https://github.com/pex-tool/pex/blob/v2.58.1/CHANGES.md
 Project-URL: Documentation, https://docs.pex-tool.org/
-Project-URL: Source, https://github.com/pex-tool/pex/tree/v2.57.0
+Project-URL: Source, https://github.com/pex-tool/pex/tree/v2.58.1
 Keywords: package,executable,virtualenv,lock,freeze
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers

{pex-2.57.0.dist-info → pex-2.58.1.dist-info}/RECORD

@@ -5,7 +5,7 @@ pex/artifact_url.py,sha256=U9hRE-N80hYTGBR88kh_0R9aNLkUUXqSdufBvSFTf8s,8029
 pex/atexit.py,sha256=pZIFdG1gEW_zWz9Vov61SnsB2TH0knSAF2EXDrT_tIA,1821
 pex/atomic_directory.py,sha256=9JxKfgp16vTMnXGinivU1NotIDWR1E94jKmw0VTEFKY,12771
 pex/attrs.py,sha256=MGqTSvDukv93di0GCP3B13-ByX7HsPg42VZzGU2eKow,459
-pex/auth.py,sha256=-jMagXQceBOghrUnS5Jjppm8XVgCrD8b92UqTVZlc8Q,5874
+pex/auth.py,sha256=USbYTSbEuq4jpH3v9BZ7XypW11ASiwXDWn7UzDVoMoo,5875
 pex/bootstrap.py,sha256=XCmK2X5vdjJye4s6OUbE4nxWgZSM5_xT-Se1bMHKwoE,5462
 pex/cli_util.py,sha256=F67UHGT5xBGFQBy2D-mxxMBCJ2V_gDtekjWni9u_J84,1192
 pex/common.py,sha256=TukYFf-td_Gi0CRzWwiV8KICEDa1LybN03bi8aESBXw,32159
@@ -53,7 +53,7 @@ pex/platforms.py,sha256=_8FAoXWTjCFOUmM02nFtduwp2NCIWC6QmBAs3CE6H5w,8319
 pex/pth.py,sha256=YGiWmW99vPvPm5-iU_Kbvbu1NTtJyyTp32ilHyAJ_VQ,3402
 pex/pyenv.py,sha256=O5_Ec26J8GQpa5Xt_TtSB0A9rV62vYgciIwBlW4aiZ8,9276
 pex/rank.py,sha256=dNFi6Y7bBe8gwcKSon81EOs9Jw4uhUzoHgRnIDYV8lU,3901
-pex/requirements.py,sha256=UzehXDrnpQfnIBc7SoyS2LEYgMERB9eyzd3gpfRQDcg,26640
+pex/requirements.py,sha256=NpseoFVrUfTDSd0JAoOnVstbvYC140ecDgiHeb39b3s,29007
 pex/resolver.py,sha256=rCHyQXTksLU5oYkhONS8lP3_hunOQuP7UQnm1UkpClI,68806
 pex/result.py,sha256=VTE_n-IffLf-FD4ENNbRvq_ebahh-IDYAna1y5Iw1WI,3090
 pex/sh_boot.py,sha256=IBpqPHnfYlImx8SMMYeeXD7BEmqnlFVAxmArieNMtU0,11217
@@ -67,7 +67,7 @@ pex/tracer.py,sha256=nob_hNooCYWZev7_ABhAVyO4HBZ8Q_OajQUvNnr82Rc,4481
 pex/typing.py,sha256=J1JTB1V48zIWmhWRHEMDHWMaFPMzsEonWJ9s57Ev43Q,3050
 pex/util.py,sha256=TxTxpdDmrDTLVXt9e2XuRq9c3N6jRYNCce87QBFkCVo,5491
 pex/variables.py,sha256=h3-JeMzXfRzEsWqTYsoU-6vt5W4Kr0VvbfSDAYtuZOU,34728
-pex/version.py,sha256=MElCMhkPID3b4O_JSAJOsFvHemaJvmkL5Pzu0-P0sHQ,131
+pex/version.py,sha256=3mSxWXjMWE_n5e-iPcxpzBNLcMS-0xv7ZU-9z_on1UQ,131
 pex/wheel.py,sha256=lSVHtgWKcAhnTBL9q4oUQ5a4clLo0hSMCk18eaJZQpM,5531
 pex/ziputils.py,sha256=thUrto9vEdG9mFCIJ59Js3d1y6bSfFdl7pb1lSb7KAQ,9620
 pex/bin/__init__.py,sha256=Kb2dGrZYVtb0cd9ngKHuLShndNU1GSWdeDzN-u_L6Io,107
@@ -77,7 +77,7 @@ pex/build_backend/configuration.py,sha256=s95XQMc2P23GWrS8z8O6pyfUDYNlFlBkuegqTE
 pex/build_backend/pylock.py,sha256=xY9OO6pNPneqEQAxDTwHH5XNbU_aoM6MACuPOiT7jo0,8318
 pex/build_backend/wrap.py,sha256=DH1jJWQ9g2FGdLEvLLMny9koYEP0_9O_138SMVTB6YM,5504
 pex/build_system/__init__.py,sha256=JYbpW71Z5Jkft7b5VSMg2VQJUNWzRDXji-2DFyXUvmQ,564
-pex/build_system/pep_517.py,sha256=AxIR7Vo4HGimdAX2FbGg6t3X_P8JZIkfX7yh6u2nfbo,10228
+pex/build_system/pep_517.py,sha256=ZGeDso2Pmv2JjB0dMBUcXHlCMhram7QhJneYskXtH4U,10458
 pex/build_system/pep_518.py,sha256=LMgvpHqcifQAHe6jgGBEGgPolMIk7BBcKBunN5u7jr4,8355
 pex/cache/__init__.py,sha256=yOeHhVmwd_TbkV62FglXwYaf6Hn2SpBbS9fGfHBRjx0,107
 pex/cache/access.py,sha256=_2Iq6NC0o-0IIjgljiOq1ajugiMUL7-V9NdrSXkkJWw,3847
@@ -110,33 +110,33 @@ pex/distutils/commands/__init__.py,sha256=uASB5OU996Jax-h3kMmeZjG5Jdy9BYDR6A1swk
 pex/distutils/commands/bdist_pex.py,sha256=SLwBj0ALpArhKQT94X0niKWfyLaySjOZuZrGXG332K0,5117
 pex/docs/__init__.py,sha256=u9hPOij1fpo1yPBLTQTdSCnSIUuRCSXHomCkEAaCciA,439
 pex/docs/command.py,sha256=uQyD8bO_DBNIlkPd6F7SFZbZUVh1Xn6gT8OmVxP4qxk,3046
-pex/docs/html/buildingpex.html,sha256=65ccAdI0dVcMFRj1B9HAxuhdex_ek5ExuITUi73mODY,57743
-pex/docs/html/genindex.html,sha256=JVlkJmiT8qLpiQEwWIxnpXIcnmIvYLVB01VLxTJSdB4,17530
-pex/docs/html/index.html,sha256=EatxW4zzsYSU9Sm7FwGPqdA-FRQxblQ_74wNmeiisCw,25362
-pex/docs/html/recipes.html,sha256=SMVC9jqSL4P3NvGkMWZQuyS6XnhDIxQ7nT5pBNvhZ2s,35528
-pex/docs/html/scie.html,sha256=-poWe4JLi68IHRbOyjMKdSm9CMmVNUcC3GMgqdhVKIg,62518
-pex/docs/html/search.html,sha256=KDPVhOP5hJZwSf1VHfHUd465F-4cDk1M901YFru05YQ,18501
+pex/docs/html/buildingpex.html,sha256=qV5rRBSVWMJYbx-8QJcCvJliU-8HWdvLXn-wxiizL0o,57743
+pex/docs/html/genindex.html,sha256=HQnto7SE3_OqMrUZenK_c1Zu_WYOENqTxZAcZFqRB6E,17530
+pex/docs/html/index.html,sha256=p-bRWrAWMI2sg6JeedAUb7ThfrqPhzAQnE-Ycz-LCHg,25362
+pex/docs/html/recipes.html,sha256=xTiZ9KEKoHkLQdKzSkDMd1FP7CA_xYC91bxnzZXYNMc,35528
+pex/docs/html/scie.html,sha256=8trlEYT9WHn43bJM4mzEhPiferGhiA8G_WHXQgNKPEc,62518
+pex/docs/html/search.html,sha256=IIM-l58amBu7uOr3u6ch3WwGw0c4TsiWI2LhhSJ8kA8,18501
 pex/docs/html/searchindex.js,sha256=R_L6Oveik_wlK5CmaE7YwRvmu81r6fd7jtnZUjfk1sA,18009
-pex/docs/html/whatispex.html,sha256=d6LDSq-AVieGPIkv3pnNMUJnfy5TwnScGoYQM869ATA,23090
-pex/docs/html/_pagefind/pagefind-entry.json,sha256=Damd2c6D7h51xp3FGO5ewquIBQwZj6ANRXgIKfTo_SU,90
+pex/docs/html/whatispex.html,sha256=7jm5bXIW2XGYaJZsBsrSDFjPotWA2uiGhJbkuUJN42Y,23090
+pex/docs/html/_pagefind/pagefind-entry.json,sha256=krmjE-XnQvvWAcW0PXbLioeOJWxcRHIKq7MYzWK00NY,90
 pex/docs/html/_pagefind/pagefind-highlight.js,sha256=5hRyi7gOMY9tlTe-tbmDrVJpoxbnYxhbJeoGwtmCfXA,43944
 pex/docs/html/_pagefind/pagefind-modular-ui.css,sha256=ZTqynk3lYp9t319vzfXSs-tTmowH__ila4ziFWpXB4g,7336
 pex/docs/html/_pagefind/pagefind-modular-ui.js,sha256=-DCEOJ2cInrvjEGZFxCuYy81EMWbKHhMu4wivlJmUzE,14486
 pex/docs/html/_pagefind/pagefind-ui.css,sha256=GL61nVezuyVA4ynNRJejhEwUBxhBtx4rDYVlAgI_W1U,14486
 pex/docs/html/_pagefind/pagefind-ui.js,sha256=WQ3yec_CMkBKswl16Ig5N_zJzeCgL4z9y344TcJeKAQ,78367
-pex/docs/html/_pagefind/pagefind.en_bda9565956.pf_meta,sha256=SXYWlM48WTlLFPOPYxX3oydbPCf4w3kLMJP_86GSPF8,151
+pex/docs/html/_pagefind/pagefind.en_bc4997bc6d.pf_meta,sha256=mDV2Ugof_qo0k15WUwYTyZKinCKiBqvi5wIB54Tm28Y,150
 pex/docs/html/_pagefind/pagefind.js,sha256=Q-4jKyPif6awDU9x8IoWXTWoJJR1JZicegUYQ-QI4MA,32912
 pex/docs/html/_pagefind/wasm.en.pagefind,sha256=mG0TKIE7WXynsyg-tpiMZiVG2Hwebbt2UqFqlqdTTsE,70873
 pex/docs/html/_pagefind/wasm.unknown.pagefind,sha256=eAREknqQnc_y96pbl8eYz9zqfUXsqe64B7HwrQE2SkY,67202
-pex/docs/html/_pagefind/fragment/en_279c9ed.pf_fragment,sha256=LVIyybRs7dFPlBcL6hro8MWi74kxNmGAMb60rOy2w9s,4884
-pex/docs/html/_pagefind/fragment/en_40d5577.pf_fragment,sha256=ZNr6YCRAgHFZuaBOWlnV7vhfcPx3tFY8Dmp7VOge3Dg,392
-pex/docs/html/_pagefind/fragment/en_789a214.pf_fragment,sha256=Fa03Q8qJTQlLIq94_ziv0e_PyRxtAN8rRtH9rlaX4W4,3053
-pex/docs/html/_pagefind/fragment/en_85eee42.pf_fragment,sha256=AiESq8oOKUBpJCr_ALpIUKkR6LHwJQPUUb8AJQzn7io,402
-pex/docs/html/_pagefind/fragment/en_8eb3225.pf_fragment,sha256=78r9GSA9vjZB2GmHOt-GwBMhghUNWVfIK1BJRgrSXAg,6844
-pex/docs/html/_pagefind/fragment/en_9e74eab.pf_fragment,sha256=izILpw8ZP1xHt7dTY5ovPzohn7HRcqeyt7LPH_uZuQk,3679
-pex/docs/html/_pagefind/fragment/en_acb471b.pf_fragment,sha256=zR8H21DBmfWBwW-nS0XLYxW6-B6F8vG9yIWPHSKM8U8,1172
-pex/docs/html/_pagefind/fragment/en_fb1d997.pf_fragment,sha256=f-oEMNuFYYZaKpYSktju84xvgoSUEUMXSPoETF_7_L0,1188
-pex/docs/html/_pagefind/index/en_56ab7db.pf_index,sha256=2RBck8jFnLK0nQK7ZgAc_7tl4MxJP9l4C-uZ-Lw6Rjs,29071
+pex/docs/html/_pagefind/fragment/en_1fd6283.pf_fragment,sha256=XJgjXqGIfVPvah7Z31ipxw8HERoAKY7BK-nUTpkTlns,3679
+pex/docs/html/_pagefind/fragment/en_3981384.pf_fragment,sha256=4GmV6XLt7TgVQv3Krq3vQF5GuM7YP6ODLdJdVQ2Mw1Y,1172
+pex/docs/html/_pagefind/fragment/en_5b3a816.pf_fragment,sha256=tuZcvsiYOK79Uz0hurP7qyRpSACQW3HMsa_9LOZQ1l0,4884
+pex/docs/html/_pagefind/fragment/en_668cbbe.pf_fragment,sha256=lsOOieX8IeB_03pGex7NaxK3dm_K-k1ncVw5vz3s1wQ,6845
+pex/docs/html/_pagefind/fragment/en_69b66dc.pf_fragment,sha256=hH2bf_2Ris36H9nUhB4Ilj2IPmlXQowFp_qOrrhCzWk,392
+pex/docs/html/_pagefind/fragment/en_93e5ea3.pf_fragment,sha256=RgTvbR6eiZ9NtRTGWBCiMzjHSu7wLJ26FlYvoPFuReQ,1188
+pex/docs/html/_pagefind/fragment/en_9ec1cdb.pf_fragment,sha256=UWy1TNqG7mskUxVh7UPjsMQPNuAsZgredbZ_QflI1No,3054
+pex/docs/html/_pagefind/fragment/en_edf644d.pf_fragment,sha256=3FNmGoQhcJ7N0klAIcohSfEJt2MKUDo-xXCK-M67VHg,402
+pex/docs/html/_pagefind/index/en_b7cb935.pf_index,sha256=4OUJgNA0w2mM4MVGkcjxwSxzLNnUB7hiwuSRxX8qGB4,29071
 pex/docs/html/_sources/buildingpex.rst.txt,sha256=87P3ZO871MILL9pmpDM8_M7_YV1z5HjTYa9m8yuxTa4,19138
 pex/docs/html/_sources/index.rst.txt,sha256=vWt1s6dirYeR-9mFJY1SClwWvbWqIqJSFCAF1CdZojc,1468
 pex/docs/html/_sources/recipes.rst.txt,sha256=kerzvp8_t5io6eGl3YJODtNBQy7GmY2AA6RHaij9C-g,6958
@@ -146,7 +146,7 @@ pex/docs/html/_sources/api/vars.md.txt,sha256=C9gu5czyB-g788xRfYKF8P176ew_q97X6z
 pex/docs/html/_static/basic.css,sha256=ZW_xus1vJg_H1xuX-cLx_L9pLchL9GnNlSA078ue7-0,14685
 pex/docs/html/_static/debug.css,sha256=DQXNnnnVMjQwRmfAjwKXHeYZbA_8pZPDkDs2Z7QFWtY,1266
 pex/docs/html/_static/doctools.js,sha256=KZLAnfkYJqjTPjtItkXud-RXrc98cS13aoFOHixEi0M,4322
-pex/docs/html/_static/documentation_options.js,sha256=ZtoMBFe3nZuyWS8ahgwxVZCEX0O7RgsMfPkd-yJkFGo,329
+pex/docs/html/_static/documentation_options.js,sha256=pHkxuYTmix91_abPXHV7GgGmK4z51aEo_UTWjbP5yWU,329
 pex/docs/html/_static/file.png,sha256=XEvJoWrr84xLlQ9ZuOUByjZJUyjLnrYiIYvOkGSjXj4,286
 pex/docs/html/_static/language_data.js,sha256=O8MRVjt_xegPyrL4Ypd0vzy2swICAA3zbf-OaVqQI7c,4598
 pex/docs/html/_static/minus.png,sha256=R-f8UNs2mfHKQc6aL_ogLADF0dUYDFX2K6hZsb1swAg,90
@@ -166,7 +166,7 @@ pex/docs/html/_static/styles/furo-extensions.css,sha256=PSsCB3EaBzE9-2yLJyKV9fkx
 pex/docs/html/_static/styles/furo-extensions.css.map,sha256=CzW267gfKqH8ruMlwJbWg-MsGAipIgZwoaP4gwDGkVw,7762
 pex/docs/html/_static/styles/furo.css,sha256=_VadhXUHMzTBCFYkutwKheVkdQlyNZJYRa8uhVGcpZ4,51074
 pex/docs/html/_static/styles/furo.css.map,sha256=fsUcXMqaSwEFTorfGfQjJ8xnUzkkWIjGkGfAgxKj5lA,76865
-pex/docs/html/api/vars.html,sha256=p1VAzipWrvIJHwgjv9X2_28VWEdNSQzMmsuZzWYoSkY,35237
+pex/docs/html/api/vars.html,sha256=tyCBeA2MjpRqkdm_V_SvLoK4Q4JS9WqNtnhnHwfbONw,35237
 pex/fs/__init__.py,sha256=ues2bnsufy1lYRyoWsiP-G4kuPrV-tXaZ0x-HFJFpwY,3605
 pex/fs/_posix.py,sha256=p-VkjEfRNXduBmkxcuEXWM1g6y6xrkufSYzEy93tqjA,1275
 pex/fs/_windows.py,sha256=apacgHpxNutF5HkU6cYOLHq7yqaijRMsFBdsdKSviDo,3304
@@ -179,7 +179,7 @@ pex/pip/installation.py,sha256=xxME2rUG4ODUQ--AsdRRdzNWyWfEphA2G09oMaYWNdI,21306
 pex/pip/local_project.py,sha256=0HsnUgb0d1XX1TokVogF1xV-pTFNuBLDG-7K2j5VUVI,2040
 pex/pip/log_analyzer.py,sha256=YLecIWrjTBvDZA_OwvQlcR1gf6-rI_eBt_LFZTA2E-U,4362
 pex/pip/tailer.py,sha256=af7yJ1rxvtTltno1BEVgJ6lf1C0PPnCzCs6CWto7Y9s,4445
-pex/pip/tool.py,sha256=gYOPJpSo6VKo3_4MX6FrYwBU4isUJp6DRKqQw4T4Beg,34403
+pex/pip/tool.py,sha256=pSymcCdNKs9A3DcU62Cd2wMYi1AqvnAYj7eaNMEbnxg,34840
 pex/pip/vcs.py,sha256=PWrS6pR2vm6rf08HCws4EVwX3kHAOyarMWj_KznoMoM,4041
 pex/pip/version.py,sha256=NADXFCx9g8D_QugtN7a6lTo_6YuBEpdicJvA8t7Mps4,12644
 pex/pip/dependencies/__init__.py,sha256=Hwrin59pqb2QPU4ysCPUhqzfsE1PHx56a-ED39eEV0Q,5126
@@ -204,16 +204,16 @@ pex/resolve/lock_resolver.py,sha256=b6UoqaXPNdWEt1JC8S6HSc4el5ows6kmIa5T87OsAm0,
 pex/resolve/locked_resolve.py,sha256=Vx9JQPe5SUW3A0IZ17pdd7Lhl8b6xa77nnGiBpJlfL0,40561
 pex/resolve/locker.py,sha256=NnSs60GxCVFyuxc5w-st4tzkC2xhYmJcxNUeRGp_UDQ,27049
 pex/resolve/locker_patches.py,sha256=t_30hjSYG570UJHgpf7i1L5ssvi1LZ2YbM4iHd44V6s,11294
-pex/resolve/package_repository.py,sha256=_zOULRNydlMag5SaHZCY9YuXC4Gq7_CXYuD9cIefXwQ,12122
+pex/resolve/package_repository.py,sha256=xMU9aTxojS2sNmWp03jfMBTIGhq3eqNuNOacl8BiiGY,15123
 pex/resolve/path_mappings.py,sha256=d6JVzD0K342ELz3O8AcsaXoikLDF3xYrgbXkixMmf3Q,2073
 pex/resolve/pex_repository_resolver.py,sha256=xXsDpecTaBj06HY81Y6PNQKVKicjiLnKUlQvjC0jzXk,5528
 pex/resolve/pre_resolved_resolver.py,sha256=SVafV5U4TSkolV2mqfte6QX6VnBgTTlQ9ZMoY83KOTk,9943
 pex/resolve/project.py,sha256=BYy1m8-jUsiaBR1DF3eJiqpqvdqrzB-cQDPvcMD2v-0,14923
-pex/resolve/requirement_configuration.py,sha256=EPw3P7lkzlr3oNNIU-QOwqywqIKya3KeV2yPo-5xQAU,2653
+pex/resolve/requirement_configuration.py,sha256=kK_si5GsaZUlaQMrwq6SWauk-0nWnwEbeeJB4V1qzfI,2891
 pex/resolve/requirement_options.py,sha256=4E5e_81ANZMg3-a1zYnJ--rixyqaEJ49197GjB3AYbA,2288
 pex/resolve/resolved_requirement.py,sha256=78dn81rEqnbkbhR9C6rAh_rTfQTLq-zUaZZVh9Z7ZAQ,2480
 pex/resolve/resolver_configuration.py,sha256=E7bkHBapJCzfFS5mjepkbA_k7CRB70GZy1cswzgHixY,9266
-pex/resolve/resolver_options.py,sha256=iWCSqPCpUJDJGE8k9NtZ5zHPMN2ZD7p-s4eXq1dZmdQ,40031
+pex/resolve/resolver_options.py,sha256=Cq7JO6C9YPb1VSLqNKFTIcSIqtsZSIldX8N2j2YRbAU,40742
 pex/resolve/resolvers.py,sha256=gLulbbaBYhh_kGsKjiP1y43OHIb5PzfpRqf2jw6b6vc,10012
 pex/resolve/script_metadata.py,sha256=6PdrBvUmKQGdTIPHfE-F07460drqjQB_HuBgz_35ql0,6903
 pex/resolve/target_configuration.py,sha256=FFrVHKgceCMlse2xOgxTtdnQ7ENw3A59t4IId0F1GDw,10349
@@ -968,10 +968,10 @@ pex/windows/stubs/uv-trampoline-aarch64-console.exe,sha256=1S2aM-6CV7rKz-3ncM5X7
 pex/windows/stubs/uv-trampoline-aarch64-gui.exe,sha256=mb8x1FpyH-wy11X5YgWfqh_VUwBb62M4Zf9aFr5V4EE,40448
 pex/windows/stubs/uv-trampoline-x86_64-console.exe,sha256=nLopBrlCMMFjkKVRlY7Ke2zFGpQOyF5mSlLs0d7-HRQ,40960
 pex/windows/stubs/uv-trampoline-x86_64-gui.exe,sha256=icnp1oXrOZpc-dHTGvDbTHjr-D8M0eamvRrC9bPI_KI,41984
-pex-2.57.0.dist-info/METADATA,sha256=xS_tx4_QbaCG2xBwn9gcYKf4gWTGrxMs95iGTFMeqPk,7425
-pex-2.57.0.dist-info/WHEEL,sha256=JNWh1Fm1UdwIQV075glCn4MVuCRs0sotJIq-J6rbxCU,109
-pex-2.57.0.dist-info/entry_points.txt,sha256=LD9tcxNxdsVLeIF6zR7dyH1vgo2eD9a-05TC1UraGMQ,174
-pex-2.57.0.dist-info/top_level.txt,sha256=HlafJUPu7mfjxv3SDH-RbkxsHOWSVbPXTEBC1hzonpM,4
-pex-2.57.0.dist-info/licenses/LICENSE,sha256=bcDgaNzzpbyOBUIFuFt3IOHUkmW7xkv1FdLPeRl99po,11323
-pex-2.57.0.dist-info/pylock/pylock.toml,sha256=ar9a6_myHcpeU4Ttsts2XQ15x6vs5aqDzjlRUATZHoI,7151
-pex-2.57.0.dist-info/RECORD,,
+pex-2.58.1.dist-info/METADATA,sha256=re_QwGkd88xKULg9V7GiTQaEIYRpNfbhfeP8VnoijA4,7425
+pex-2.58.1.dist-info/WHEEL,sha256=JNWh1Fm1UdwIQV075glCn4MVuCRs0sotJIq-J6rbxCU,109
+pex-2.58.1.dist-info/entry_points.txt,sha256=LD9tcxNxdsVLeIF6zR7dyH1vgo2eD9a-05TC1UraGMQ,174
+pex-2.58.1.dist-info/top_level.txt,sha256=HlafJUPu7mfjxv3SDH-RbkxsHOWSVbPXTEBC1hzonpM,4
+pex-2.58.1.dist-info/licenses/LICENSE,sha256=bcDgaNzzpbyOBUIFuFt3IOHUkmW7xkv1FdLPeRl99po,11323
+pex-2.58.1.dist-info/pylock/pylock.toml,sha256=ar9a6_myHcpeU4Ttsts2XQ15x6vs5aqDzjlRUATZHoI,7151
+pex-2.58.1.dist-info/RECORD,,