python-discovery 1.1.1__py3-none-any.whl → 1.1.3__py3-none-any.whl

python_discovery/_cached_py_info.py

@@ -210,6 +210,7 @@ def _run_subprocess(
             code = process.returncode
         except TimeoutExpired:
             process.kill()
+            process.communicate()
             out, err, code = "", "timed out", -1
         except OSError as os_error:
             out, err, code = "", os_error.strerror, os_error.errno

python_discovery/_py_info.py

@@ -469,12 +469,24 @@ class PythonInfo:  # noqa: PLR0904
         if spec.version_specifier is None:  # pragma: no cover
             return True
         version_info = self.version_info
-        release = f"{version_info.major}.{version_info.minor}.{version_info.micro}"
-        if version_info.releaselevel != "final":
-            suffix = {"alpha": "a", "beta": "b", "candidate": "rc"}.get(version_info.releaselevel)
-            if suffix is not None:  # pragma: no branch # releaselevel is always alpha/beta/candidate here
+        for specifier in spec.version_specifier:
+            assert specifier.version is not None  # noqa: S101
+            numeric_version = specifier.version_str
+            for prefix in ("rc", "b", "a"):
+                if prefix in numeric_version:
+                    numeric_version = numeric_version.split(prefix)[0]
+                    break
+            precision = numeric_version.count(".") + 1
+            release = ".".join(str(c) for c in [version_info.major, version_info.minor, version_info.micro][:precision])
+            if (
+                version_info.releaselevel != "final"
+                and (precision == 3 or specifier.version.pre_type is not None)  # noqa: PLR2004
+                and (suffix := {"alpha": "a", "beta": "b", "candidate": "rc"}.get(version_info.releaselevel))
+            ):
                 release = f"{release}{suffix}{version_info.serial}"
-        return spec.version_specifier.contains(release)
+            if not specifier.contains(release):
+                return False
+        return True
 
     _current_system = None
     _current = None

{python_discovery-1.1.1.dist-info → python_discovery-1.1.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-discovery
-Version: 1.1.1
+Version: 1.1.3
 Summary: Python interpreter discovery
 Project-URL: Changelog, https://github.com/tox-dev/python-discovery/releases
 Project-URL: Documentation, https://python-discovery.readthedocs.io
@@ -64,8 +64,43 @@ Description-Content-Type: text/markdown
 # [`python-discovery`](https://python-discovery.readthedocs.io/en/latest/)
 
 [![PyPI](https://img.shields.io/pypi/v/python-discovery?style=flat-square)](https://pypi.org/project/python-discovery/)
-[![Supported Python
-versions](https://img.shields.io/pypi/pyversions/python-discovery.svg)](https://pypi.org/project/python-discovery/)
+[![Supported Python versions](https://img.shields.io/pypi/pyversions/python-discovery.svg)](https://pypi.org/project/python-discovery/)
 [![Downloads](https://static.pepy.tech/badge/python-discovery/month)](https://pepy.tech/project/python-discovery)
 [![check](https://github.com/tox-dev/python-discovery/actions/workflows/check.yaml/badge.svg)](https://github.com/tox-dev/python-discovery/actions/workflows/check.yaml)
 [![Documentation Status](https://readthedocs.org/projects/python-discovery/badge/?version=latest)](https://python-discovery.readthedocs.io/en/latest/?badge=latest)
+
+## What is python-discovery?
+
+`python-discovery` is a library for discovering Python interpreters installed on your machine. You may have multiple
+Python versions from system packages, [pyenv](https://github.com/pyenv/pyenv), [mise](https://mise.jdx.dev/),
+[asdf](https://asdf-vm.com/), [uv](https://docs.astral.sh/uv/), or the Windows registry (PEP 514). This library finds
+the right one for you.
+
+Give it a requirement like `python3.12` or `>=3.11,<3.13`, and it searches all known locations, verifies each candidate,
+and returns detailed metadata about the match. Results are cached to disk so repeated lookups are fast.
+
+## Usage
+
+```python
+from pathlib import Path
+
+from python_discovery import DiskCache, get_interpreter
+
+cache = DiskCache(root=Path("~/.cache/python-discovery").expanduser())
+result = get_interpreter("python3.12", cache=cache)
+if result is not None:
+    print(result.executable)  # /usr/bin/python3.12
+    print(result.implementation)  # CPython
+    print(result.version_info[:3])  # (3, 12, 1)
+```
+
+The `get_interpreter()` function accepts various specification formats:
+
+- Absolute path: `/usr/bin/python3.12`
+- Version: `3.12`
+- Implementation prefix: `cpython3.12`
+- PEP 440 specifier: `>=3.10`, `>=3.11,<3.13`
+
+## Documentation
+
+Full documentation is available at [python-discovery.readthedocs.io](https://python-discovery.readthedocs.io/en/latest/)

{python_discovery-1.1.1.dist-info → python_discovery-1.1.3.dist-info}/RECORD

@@ -1,16 +1,16 @@
 python_discovery/__init__.py,sha256=Omg3KoCm1ETlMYb9UPsxDJ7ygtFyopJUk-_ln2xrmhs,628
 python_discovery/_cache.py,sha256=bG4fD-h2pdPmb4v9BldbXmJ5Tlt1boiH1Qrz8kp9Dds,5063
-python_discovery/_cached_py_info.py,sha256=3C41bIxq9bgrVV2XEZzn2BsOdauDaHKlMxRjwEUU1Yc,8441
+python_discovery/_cached_py_info.py,sha256=CTqnvHCEnub8vE0kkRx9te4UGRGSXcJCXi-XRulkHBU,8475
 python_discovery/_compat.py,sha256=iqxGuhK9rPaiui80G1H1KrweoMJ16gyLYEmUrSXrp5c,709
 python_discovery/_discovery.py,sha256=yccO7GNtNuxHtmDHsyqtaASmNHFgKIeEX6Me3jX-GFs,12822
-python_discovery/_py_info.py,sha256=KtlIMi8CT_B4G3cyXgN2uXf-ve16nqt08WApnDQK3ac,33080
+python_discovery/_py_info.py,sha256=7JFVTXoah2ivDeWg0KYqys-ZhzlLdSBwSTnAPQqAG7k,33600
 python_discovery/_py_spec.py,sha256=rhm9uahWSQL3JLyyMmM2HQVhrTMVnHnZEAhArkjeNtM,9601
 python_discovery/_specifier.py,sha256=PTh6suNTC0hMnFSxFYF_vggdciFLnwxoh1YflSbgCXA,10368
 python_discovery/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 python_discovery/_windows/__init__.py,sha256=qthcyGh36b3WkeSbZ4ECRRYLbCOCaQu5X_DRZ98tXfk,315
 python_discovery/_windows/_pep514.py,sha256=JYSQ5tOYbSMOKtVVfOEkyYskBhEoTsImNr3DJcv7XNE,7658
 python_discovery/_windows/_propose.py,sha256=iMJf6l0TU4SvuV8UsCHHINAe9L5dUT949xyeyMVdong,1565
-python_discovery-1.1.1.dist-info/METADATA,sha256=1ai_-_BpIWorroopADBL99vytMc_AlfLxmh0ba_ShzE,4024
-python_discovery-1.1.1.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-python_discovery-1.1.1.dist-info/licenses/LICENSE,sha256=kOJeH68qSq6o2V7o5_VziwUqGswMnFgGgQH5Mahr1Yg,1023
-python_discovery-1.1.1.dist-info/RECORD,,
+python_discovery-1.1.3.dist-info/METADATA,sha256=i9erm4S9TcyhTiiIaJ0lc6B1Np_1buU1ooT1mzyWtuY,5404
+python_discovery-1.1.3.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+python_discovery-1.1.3.dist-info/licenses/LICENSE,sha256=kOJeH68qSq6o2V7o5_VziwUqGswMnFgGgQH5Mahr1Yg,1023
+python_discovery-1.1.3.dist-info/RECORD,,