checkup-python 0.2.0__py3-none-any.whl

checkup_python/__init__.py

@@ -0,0 +1,4 @@
+# version
+# black
+# ruff
+# dep manager which,

checkup_python/metrics/__init__.py

@@ -0,0 +1,3 @@
+from checkup_python.metrics.version import PythonVersionMetric
+
+__all__ = ["PythonVersionMetric"]

checkup_python/metrics/utils.py

@@ -0,0 +1,7 @@
+def parse_semantic_version(version: str) -> tuple[int, ...]:
+    """
+    Parse version string into tuple of integers for comparison.
+    """
+
+    parts = version.split(".")
+    return tuple(int(part) for part in parts if part.isdigit())

checkup_python/metrics/version.py

@@ -0,0 +1,112 @@
+import re
+import sys
+from pathlib import Path
+from typing import ClassVar
+
+from checkup.metric import Metric
+from checkup.types import Context
+from checkup_python.metrics.utils import parse_semantic_version
+
+
+class PythonVersionMetric(Metric):
+    """
+    Metric to detect the Python version configured for a project.
+
+    Checks (in order):
+    1. .python-version file
+    2. pyproject.toml
+    3. Falls back to current runtime version
+    """
+
+    name: ClassVar[str] = "python_version"
+    description: ClassVar[str] = "The Python version configured for the project"
+    unit: ClassVar[str] = "version"
+
+    def calculate(self, context: Context, metrics: dict[type[Metric], Metric]) -> None:
+        path = None
+
+        if "path" in context:
+            path = Path(context["path"])
+        else:
+            path = Path.cwd()
+
+        version = (
+            self._read_python_version_file(path)
+            or self._read_pyproject_toml(path)
+            or self._get_runtime_version()
+        )
+
+        self.value = version
+
+    def _read_python_version_file(self, path: Path) -> str | None:
+        """
+        Read version from `.python-version`.
+        """
+
+        version_file = path / ".python-version"
+        if not version_file.exists():
+            return None
+
+        return (
+            version_file.read_text().strip().removeprefix("python-").removeprefix("py")
+        )
+
+    def _read_pyproject_toml(self, path: Path) -> str | None:
+        """
+        Extract Python version from `pyproject.toml`.
+        """
+
+        pyproject_file = path / "pyproject.toml"
+        if not pyproject_file.exists():
+            return None
+
+        content = pyproject_file.read_text()
+        # Look for requires-python = ">=3.11" or similar
+        match = re.search(r'requires-python\s*=\s*["\']([^"\']+)["\']', content)
+        if not match:
+            return None
+
+        version_spec = match.group(1)
+        # Extract version number from spec like ">=3.11", "^3.11", "~=3.11.0"
+        version_match = re.search(r"(\d+\.\d+(?:\.\d+)?)", version_spec)
+        if not version_match:
+            return None
+
+        return version_match.group(1)
+
+    def _get_runtime_version(self) -> str:
+        """
+        Get the current runtime Python version.
+        """
+
+        return f"{sys.version_info.major}.{sys.version_info.minor}.{sys.version_info.micro}"
+
+    def __lt__(self, other) -> bool:
+        if not isinstance(other, PythonVersionMetric):
+            return NotImplemented
+        return parse_semantic_version(self.value) < parse_semantic_version(other.value)
+
+    def __le__(self, other) -> bool:
+        if not isinstance(other, PythonVersionMetric):
+            return NotImplemented
+        return parse_semantic_version(self.value) <= parse_semantic_version(other.value)
+
+    def __gt__(self, other) -> bool:
+        if not isinstance(other, PythonVersionMetric):
+            return NotImplemented
+        return parse_semantic_version(self.value) > parse_semantic_version(other.value)
+
+    def __ge__(self, other) -> bool:
+        if not isinstance(other, PythonVersionMetric):
+            return NotImplemented
+        return parse_semantic_version(self.value) >= parse_semantic_version(other.value)
+
+    def __eq__(self, other) -> bool:
+        if not isinstance(other, PythonVersionMetric):
+            return NotImplemented
+        return parse_semantic_version(self.value) == parse_semantic_version(other.value)
+
+    def __ne__(self, other) -> bool:
+        if not isinstance(other, PythonVersionMetric):
+            return NotImplemented
+        return parse_semantic_version(self.value) != parse_semantic_version(other.value)

checkup_python/metrics/version_check.py

@@ -0,0 +1,36 @@
+from typing import ClassVar
+
+from checkup.metric import Metric
+from checkup.types import Context
+from checkup_python.metrics.utils import parse_semantic_version
+from checkup_python.metrics.version import PythonVersionMetric
+
+
+class PythonVersionCheckMetric(Metric):
+    """
+    Metric that checks the Python version of the current project
+    and compares it to given thresholds.
+    """
+
+    name: ClassVar[str] = "python_version_check"
+    description: ClassVar[str] = (
+        "The Python version adheres to a minimum and maximum boundary"
+    )
+    unit: ClassVar[str] = "bool"
+
+    min_version: str
+    max_version: str
+
+    @classmethod
+    def depends_on(cls) -> list[type[Metric]]:
+        return [PythonVersionMetric]
+
+    def calculate(self, context: Context, metrics: dict[type[Metric], Metric]) -> None:
+        version_metric = metrics[PythonVersionMetric]
+        actual_version = version_metric.value
+
+        actual = parse_semantic_version(actual_version)
+        min_ver = parse_semantic_version(self.min_version)
+        max_ver = parse_semantic_version(self.max_version)
+
+        self.value = min_ver <= actual <= max_ver

checkup_python-0.2.0.dist-info/METADATA

@@ -0,0 +1,6 @@
+Metadata-Version: 2.4
+Name: checkup-python
+Version: 0.2.0
+Summary: Python metrics for checkup
+Requires-Python: >=3.12
+Requires-Dist: checkup

checkup_python-0.2.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+checkup_python/__init__.py,sha256=A2MO43t3qfaZzsCwjdC0Z7OKE3h9Y3i5dg71XBCBA10,46
+checkup_python/metrics/__init__.py,sha256=qxHEK2U1en27kQt7_eRm4vxHlch5vROGDROabR9Jngs,98
+checkup_python/metrics/utils.py,sha256=D8WQniMljWgnAwVhfBo6G6IK1K_58S2g3hiGpS-ZI8s,237
+checkup_python/metrics/version.py,sha256=QY_CYtUzzsArlbCANtY74hzq-7TmuwRzEr_zHMhWMp8,3667
+checkup_python/metrics/version_check.py,sha256=tV2SfdQ2u3LAfPF1b1VY0AlAI-HlKWY7-y3lAPtYIUc,1143
+checkup_python-0.2.0.dist-info/METADATA,sha256=RdVOb_6CVv9VUKvVVSsCl6vFaKdHyvw-k49n5SbmwZE,141
+checkup_python-0.2.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+checkup_python-0.2.0.dist-info/RECORD,,

checkup_python-0.2.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any