shellscripts 0.24.0__tar.gz → 0.24.1__tar.gz

{shellscripts-0.24.0 → shellscripts-0.24.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: shellscripts
-Version: 0.24.0
+Version: 0.24.1
 Summary: Execute useful shell scripts via an uvx-compatible CLI interface.
 Author: Francesco Rolando
 License-Expression: GPL-3.0-only
@@ -31,7 +31,7 @@ Dynamic: license-file
 > * **No Support or Feature Requests:** Please **do not** open issues, bug reports, or feature requests. They will not be addressed or accepted at this stage of development.
 > * **No Warranty:** This software is provided **"AS IS"**, without warranty of any kind, express or implied. You may use it strictly for **testing and evaluation purposes** at your own sole risk.
 
-# s/shellScripts (0.24.0)
+# s/shellScripts (0.24.1)
 
 <p align="center">
   <img src="https://img.shields.io/badge/python-3.11%2B-3776AB?style=flat-square&logo=python&logoColor=white" alt="Python 3.11+">

{shellscripts-0.24.0 → shellscripts-0.24.1}/README.md

@@ -10,7 +10,7 @@
 > * **No Support or Feature Requests:** Please **do not** open issues, bug reports, or feature requests. They will not be addressed or accepted at this stage of development.
 > * **No Warranty:** This software is provided **"AS IS"**, without warranty of any kind, express or implied. You may use it strictly for **testing and evaluation purposes** at your own sole risk.
 
-# s/shellScripts (0.24.0)
+# s/shellScripts (0.24.1)
 
 <p align="center">
   <img src="https://img.shields.io/badge/python-3.11%2B-3776AB?style=flat-square&logo=python&logoColor=white" alt="Python 3.11+">

{shellscripts-0.24.0 → shellscripts-0.24.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "shellscripts"
-version = "0.24.0"
+version = "0.24.1"
 description = "Execute useful shell scripts via an uvx-compatible CLI interface."
 readme = "README.md"
 requires-python = ">=3.11"

{shellscripts-0.24.0 → shellscripts-0.24.1}/src/shell_scripts/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "0.24.0"
+__version__ = "0.24.1"
 
 from .core import main  # noqa: F401
 

{shellscripts-0.24.0 → shellscripts-0.24.1}/src/shell_scripts/version_check.py

@@ -263,11 +263,12 @@ def print_remote_latest_versions(current_version: str) -> None:
 
     @details Emits one `<source> latest: <version>` line per remote source in
     fixed order (PyPI, GitHub). A failed source lookup prints one bright-red
-    error line instead of its version line, and the remaining source is still
-    processed. Complexity O(1) excluding network latency.
+    `<source> latest: unknown (<reason>)` line where `<reason>` is the
+    `_format_request_error` descriptor of the actual failure, and the remaining
+    source is still processed. Complexity O(1) excluding network latency.
     @param current_version {str} Installed package version used in User-Agent.
     @return {None} Writes two report or error lines to stdout.
-    @satisfies REQ-003, REQ-075, DES-020
+    @satisfies REQ-003, REQ-075, REQ-084, DES-020
     """
 
     for source_label, fetch_version in (
@@ -278,8 +279,8 @@ def print_remote_latest_versions(current_version: str) -> None:
             latest_version = fetch_version(current_version).lstrip("v")
         except Exception as error:
             print(
-                f"{BRIGHT_RED}{source_label} latest check failed: "
-                f"{_format_request_error(error)}.{RESET}"
+                f"{BRIGHT_RED}{source_label} latest: unknown "
+                f"({_format_request_error(error)}){RESET}"
             )
             continue
         print(f"{source_label} latest: {latest_version}")

{shellscripts-0.24.0 → shellscripts-0.24.1}/src/shellscripts.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: shellscripts
-Version: 0.24.0
+Version: 0.24.1
 Summary: Execute useful shell scripts via an uvx-compatible CLI interface.
 Author: Francesco Rolando
 License-Expression: GPL-3.0-only
@@ -31,7 +31,7 @@ Dynamic: license-file
 > * **No Support or Feature Requests:** Please **do not** open issues, bug reports, or feature requests. They will not be addressed or accepted at this stage of development.
 > * **No Warranty:** This software is provided **"AS IS"**, without warranty of any kind, express or implied. You may use it strictly for **testing and evaluation purposes** at your own sole risk.
 
-# s/shellScripts (0.24.0)
+# s/shellScripts (0.24.1)
 
 <p align="center">
   <img src="https://img.shields.io/badge/python-3.11%2B-3776AB?style=flat-square&logo=python&logoColor=white" alt="Python 3.11+">

{shellscripts-0.24.0 → shellscripts-0.24.1}/tests/test_tst_014_pypi_version_source.py

@@ -15,6 +15,7 @@
 import json
 import types
 import urllib.error
+from email.message import Message
 
 import shell_scripts.core as core
 from shell_scripts.config import get_default_runtime_config
@@ -204,12 +205,12 @@ def test_print_remote_latest_versions_reports_failed_source_and_continues(
     """
     @brief Validate per-source error reporting during version report.
     @details Forces the PyPI lookup to raise a non-HTTP exception and asserts
-      one bright-red failure line for PyPI while the GitHub line is still
-      emitted.
+      the bright-red `PyPI latest: unknown (<reason>)` failure line while the
+      GitHub line is still emitted.
     @param monkeypatch {pytest.MonkeyPatch} Runtime patch helper.
     @param capsys {pytest.CaptureFixture[str]} Stdout/stderr capture helper.
     @return {None} Assertions only.
-    @satisfies TST-014, DES-020
+    @satisfies TST-014, REQ-084, DES-020
     """
 
     def _raise_url_error(_version):
@@ -229,11 +230,54 @@ def test_print_remote_latest_versions_reports_failed_source_and_continues(
     version_check.print_remote_latest_versions("0.1.0")
     captured = capsys.readouterr()
 
-    assert "PyPI latest check failed" in captured.out
-    assert "PyPI latest:" not in captured.out
+    expected_output = "PyPI latest: unknown (URLError: <urlopen error pypi unreachable>)"
+    assert expected_output in captured.out
+    assert "PyPI latest check failed" not in captured.out
     assert "GitHub latest: 0.1.0" in captured.out
 
 
+def test_print_remote_latest_versions_reports_github_http_404(
+    monkeypatch,
+    capsys,
+):
+    """
+    @brief Validate GitHub HTTP failure rendering during version report.
+    @details Forces the GitHub lookup to raise an HTTP 404 error and asserts
+      the bright-red `GitHub latest: unknown (HTTP 404)` failure line while
+      the PyPI line is still emitted.
+    @param monkeypatch {pytest.MonkeyPatch} Runtime patch helper.
+    @param capsys {pytest.CaptureFixture[str]} Stdout/stderr capture helper.
+    @return {None} Assertions only.
+    @satisfies TST-014, REQ-084, DES-020
+    """
+
+    def _raise_http_404(_version):
+        """
+        @brief Simulate GitHub API HTTP 404 failure.
+        @param _version {str} Unused installed version.
+        @return {None} Always raises.
+        @throws {urllib.error.HTTPError} Deterministic HTTP failure.
+        """
+        raise urllib.error.HTTPError(
+            version_check.GITHUB_API_URL, 404, "Not Found", Message(), None
+        )
+
+    monkeypatch.setattr(
+        version_check, "fetch_pypi_latest_version", lambda _version: "0.1.0"
+    )
+    monkeypatch.setattr(
+        version_check, "fetch_github_latest_release", _raise_http_404
+    )
+
+    version_check.print_remote_latest_versions("0.1.0")
+    captured = capsys.readouterr()
+
+    expected_output = "GitHub latest: unknown (HTTP 404)"
+    assert expected_output in captured.out
+    assert "GitHub latest check failed" not in captured.out
+    assert "PyPI latest: 0.1.0" in captured.out
+
+
 def test_main_version_prints_installed_pypi_and_github_lines(
     monkeypatch,
     capsys,