Fix pytest ignore hook signature

Author: beauagainagainagainagainagain

conftest.py

@@ -0,0 +1,67 @@
+"""Pytest configuration for optional dependency heavy modules."""
+
+from __future__ import annotations
+
+import importlib
+import importlib.util
+from functools import lru_cache
+from pathlib import Path
+from typing import Sequence
+
+from _pytest.config import Config
+
+REPO_ROOT = Path(__file__).resolve().parent
+
+_OPTIONAL_PATHS: Sequence[tuple[frozenset[str], Path]] = (
+    (frozenset({"cv2"}), REPO_ROOT / "computer_vision"),
+    (frozenset({"cv2"}), REPO_ROOT / "data_compression" / "peak_signal_to_noise_ratio.py"),
+    (frozenset({"cv2"}), REPO_ROOT / "digital_image_processing"),
+    (frozenset({"tensorflow"}), REPO_ROOT / "computer_vision" / "cnn_classification.py"),
+    (frozenset({"tensorflow"}), REPO_ROOT / "dynamic_programming" / "k_means_clustering_tensorflow.py"),
+    (frozenset({"tensorflow", "keras"}), REPO_ROOT / "machine_learning" / "lstm" / "lstm_prediction.py"),
+    (frozenset({"tensorflow"}), REPO_ROOT / "neural_network" / "input_data.py"),
+    (frozenset({"qiskit"}), REPO_ROOT / "quantum" / "q_fourier_transform.py"),
+)
+
+_ALWAYS_SKIP: Sequence[Path] = (REPO_ROOT / "scripts" / "validate_filenames.py",)
+
+
+@lru_cache
+def _modules_unavailable(modules: frozenset[str]) -> bool:
+    for module in modules:
+        spec = importlib.util.find_spec(module)
+        if spec is None:
+            return True
+        try:
+            importlib.import_module(module)
+        except Exception:  # pragma: no cover - handled by skipping collection
+            return True
+    return False
+
+
+def _is_within(path: Path, location: Path) -> bool:
+    try:
+        path.relative_to(location)
+    except ValueError:
+        return False
+    return True
+
+
+def pytest_ignore_collect(collection_path: Path, config: Config) -> bool:  # type: ignore[override]
+    candidate = Path(collection_path)
+    if not candidate.is_absolute():
+        candidate = REPO_ROOT / candidate
+
+    if any(candidate == location or _is_within(candidate, location) for location in _ALWAYS_SKIP):
+        return True
+
+    for modules, location in _OPTIONAL_PATHS:
+        if modules and not _modules_unavailable(modules):
+            continue
+
+        if location.is_dir() and _is_within(candidate, location):
+            return True
+        if not location.is_dir() and candidate == location:
+            return True
+
+    return False

digital_image_processing/test_digital_image_processing.py

@@ -1,8 +1,10 @@
-"""
-PyTest's for Digital Image Processing
-"""
+"""PyTest's for Digital Image Processing."""
 
 import numpy as np
+import pytest
+
+pytest.importorskip("cv2", exc_type=ImportError)
+
 from cv2 import COLOR_BGR2GRAY, cvtColor, imread
 from numpy import array, uint8
 from PIL import Image

docs/conf.py

@@ -1,3 +1,12 @@
+from pathlib import Path
+
 from sphinx_pyproject import SphinxConfig
 
-project = SphinxConfig("../pyproject.toml", globalns=globals()).name
+
+def _pyproject_path() -> Path:
+    """Return the absolute path to the project's ``pyproject.toml`` file."""
+
+    return Path(__file__).resolve().parent.parent / "pyproject.toml"
+
+
+project = SphinxConfig(str(_pyproject_path()), globalns=globals()).name

web_programming/covid_stats_via_xpath.py

@@ -1,8 +1,4 @@
-"""
-This is to show simple COVID19 info fetching from worldometers archive site using lxml
-* The main motivation to use lxml in place of bs4 is that it is faster and therefore
-more convenient to use in Python web projects (e.g. Django or Flask-based)
-"""
+"""Fetch COVID-19 statistics from the Worldometer archive."""
 
 # /// script
 # requires-python = ">=3.13"
@@ -12,6 +8,8 @@
 # ]
 # ///
 
+from __future__ import annotations
+
 from typing import NamedTuple
 
 import httpx
@@ -27,13 +25,24 @@ class CovidData(NamedTuple):
 def covid_stats(
     url: str = "https://web.archive.org/web/20250825095350/https://www.worldometers.info/coronavirus/",
 ) -> CovidData:
+    """Return worldwide COVID-19 statistics for the given archive ``url``."""
+
     xpath_str = '//div[@class = "maincounter-number"]/span/text()'
-    return CovidData(
-        *html.fromstring(httpx.get(url, timeout=10).content).xpath(xpath_str)
-    )
+    response = httpx.get(url, timeout=10)
+    response.raise_for_status()
+    return CovidData(*html.fromstring(response.content).xpath(xpath_str))
+
+
+def _format_stats(data: CovidData) -> str:
+    return (
+        "Total COVID-19 cases in the world: {}\n"
+        "Total deaths due to COVID-19 in the world: {}\n"
+        "Total COVID-19 patients recovered in the world: {}"
+    ).format(*data)
 
 
-fmt = """Total COVID-19 cases in the world: {}
-Total deaths due to COVID-19 in the world: {}
-Total COVID-19 patients recovered in the world: {}"""
-print(fmt.format(*covid_stats()))
+if __name__ == "__main__":
+    try:
+        print(_format_stats(covid_stats()))
+    except httpx.HTTPError as exc:  # pragma: no cover - network dependent
+        raise SystemExit(f"Unable to fetch COVID-19 statistics: {exc}") from exc