gd-tools-cli 0.9.0__tar.gz → 0.10.0__tar.gz

{gd_tools_cli-0.9.0 → gd_tools_cli-0.10.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gd-tools-cli
-Version: 0.9.0
+Version: 0.10.0
 Summary: A modern development workflow CLI for GDScript projects in Godot 4.5+
 Author-email: mansyar <m.ansyarafi@gmail.com>
 License: MIT

{gd_tools_cli-0.9.0 → gd_tools_cli-0.10.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "gd-tools-cli"
-version = "0.9.0"
+version = "0.10.0"
 description = "A modern development workflow CLI for GDScript projects in Godot 4.5+"
 readme = "README.md"
 license = {text = "MIT"}
@@ -110,7 +110,7 @@ target-version = ["py310"]
 
 [tool.commitizen]
 name = "cz_conventional_commits"
-version = "0.9.0"
+version = "0.10.0"
 version_files = ["pyproject.toml:version"]
 changelog_file = "CHANGELOG.md"
 tag_format = "v$version"

gd_tools_cli-0.10.0/src/gd_tools/addon_check.py

@@ -0,0 +1,157 @@
+"""Stale addon detection module.
+
+Checks whether the deployed coverage addon version matches the installed
+gd-tools-cli package version. Prints warnings to stderr when the addon
+is missing or stale. Fails silently on any error and can be disabled via
+the GD_TOOLS_NO_UPDATE_CHECK environment variable.
+"""
+
+import os
+
+import click
+from packaging.version import parse as parse_version
+
+from gd_tools import __version__
+from gd_tools.config import find_project_root
+
+ADDON_VERSION_FILENAME = "_version.txt"
+COVERAGE_ADDON_DIR = "gd-tools-coverage"
+NATIVE_ADDON_DIR = "gd-tools-test"
+
+
+def _stale_refusal(label: str, deployed: str) -> str:
+    """Build the refusal message for a stale/unparseable addon.
+
+    Args:
+        label: Human-readable addon label ("Coverage"/"Native test").
+        deployed: Deployed version string (raw, may be unparseable).
+
+    Returns:
+        Refusal message naming both versions, the fix, and the abort.
+    """
+    return (
+        f"Error: {label} addon is outdated (v{deployed} deployed, "
+        f"v{__version__} installed). Run `gd-tools init` to "
+        "update. Aborted before running tests."
+    )
+
+
+def _missing_refusal(label: str) -> str:
+    """Build the refusal message for a missing version file.
+
+    Args:
+        label: Human-readable addon label ("Coverage"/"Native test").
+
+    Returns:
+        Refusal message naming the CLI version, the fix, and abort.
+    """
+    return (
+        f"Error: {label} addon version file not found "
+        f"(deployed version unknown, v{__version__} installed). "
+        "Run `gd-tools init` to deploy the addon. "
+        "Aborted before running tests."
+    )
+
+
+def check_coverage_addon_gate() -> str | None:
+    """Check the coverage-run addon gate before suite dispatch.
+
+    Compares the deployed coverage and native test addon versions
+    against the CLI version. A missing, unparseable, or older
+    deployed version refuses the run. Newer deployed addons and
+    matching versions pass. Suppressed by
+    ``GD_TOOLS_NO_UPDATE_CHECK=1``. Never raises; unexpected
+    errors defer to the caller's existing behavior.
+
+    Returns:
+        Refusal message when the run must abort, else None.
+    """
+    if os.environ.get("GD_TOOLS_NO_UPDATE_CHECK") == "1":
+        return None
+    try:
+        project_root = find_project_root()
+    except Exception:
+        return None
+    for addon_dir, label in (
+        (COVERAGE_ADDON_DIR, "Coverage"),
+        (NATIVE_ADDON_DIR, "Native test"),
+    ):
+        version_file = (
+            project_root / "addons" / addon_dir / ADDON_VERSION_FILENAME
+        )
+        try:
+            exists = version_file.exists()
+        except Exception:
+            return None
+        if not exists:
+            return _missing_refusal(label)
+        try:
+            addon_version = version_file.read_text(encoding="utf-8").strip()
+        except Exception:
+            return None
+        try:
+            addon_parsed = parse_version(addon_version)
+            package_parsed = parse_version(__version__)
+        except (TypeError, ValueError):
+            return _stale_refusal(label, addon_version)
+        if addon_parsed < package_parsed:
+            return _stale_refusal(label, addon_version)
+    return None
+
+
+def check_addon_version() -> None:
+    """Check if the deployed coverage addon version is stale.
+
+    Compares the version in _version.txt against the installed package
+    version. Prints a warning to stderr if the addon is missing or stale.
+    Fails silently on any unexpected error.
+
+    FR2: Stale Addon Check on CLI Invocation.
+    FR3: Suppressed by GD_TOOLS_NO_UPDATE_CHECK=1.
+    FR4: Uses packaging.version.parse() for comparison.
+    """
+    # FR3.1: Environment variable disables check entirely.
+    if os.environ.get("GD_TOOLS_NO_UPDATE_CHECK") == "1":
+        return
+
+    try:
+        project_root = find_project_root()
+        version_file = (
+            project_root
+            / "addons"
+            / "gd-tools-coverage"
+            / ADDON_VERSION_FILENAME
+        )
+
+        if not version_file.exists():
+            click.echo(
+                "WARNING: Coverage addon version file not found. "
+                "Run `gd-tools init` to deploy the addon.",
+                err=True,
+            )
+            return
+
+        addon_version = version_file.read_text(encoding="utf-8").strip()
+        stale_msg = (
+            f"WARNING: Coverage addon is outdated (v{addon_version} "
+            f"deployed, v{__version__} available). "
+            f"Run `gd-tools init` to update."
+        )
+
+        # FR4.1: Compare versions using packaging.version.parse().
+        try:
+            addon_parsed = parse_version(addon_version)
+            package_parsed = parse_version(__version__)
+        except (TypeError, ValueError):
+            # FR4.2: Unparseable version = treated as stale.
+            click.echo(stale_msg, err=True)
+            return
+
+        # FR2.4: Stale (addon < package)
+        if addon_parsed < package_parsed:
+            click.echo(stale_msg, err=True)
+        # FR2.5: Match = no warning
+        # FR2.6: Newer addon (downgrade) = no warning
+    except Exception:
+        # FR2.8: Fail silently on any unexpected error.
+        pass

{gd_tools_cli-0.9.0 → gd_tools_cli-0.10.0}/src/gd_tools/commands/test.py

@@ -2,6 +2,7 @@
 
 import click
 
+from ..addon_check import check_coverage_addon_gate
 from ..config import ConfigError, load_config
 from ..errors import GdToolsError, TestFailureError
 from ..native_test.command import run_native_test_command
@@ -291,6 +292,13 @@ def test(
 
     validate_test_flags(flags, stage=RuleStage.PRE_DISPATCH)
 
+    if coverage:
+        refusal = check_coverage_addon_gate()
+        if refusal is not None:
+            click.echo(refusal, err=True)
+            ctx = click.get_current_context()
+            ctx.exit(2)
+
     try:
         if watch:
             ctx = click.get_current_context()

{gd_tools_cli-0.9.0 → gd_tools_cli-0.10.0}/src/gd_tools_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gd-tools-cli
-Version: 0.9.0
+Version: 0.10.0
 Summary: A modern development workflow CLI for GDScript projects in Godot 4.5+
 Author-email: mansyar <m.ansyarafi@gmail.com>
 License: MIT

gd_tools_cli-0.9.0/src/gd_tools/addon_check.py

@@ -1,75 +0,0 @@
-"""Stale addon detection module.
-
-Checks whether the deployed coverage addon version matches the installed
-gd-tools-cli package version. Prints warnings to stderr when the addon
-is missing or stale. Fails silently on any error and can be disabled via
-the GD_TOOLS_NO_UPDATE_CHECK environment variable.
-"""
-
-import os
-
-import click
-from packaging.version import parse as parse_version
-
-from gd_tools import __version__
-from gd_tools.config import find_project_root
-
-ADDON_VERSION_FILENAME = "_version.txt"
-
-
-def check_addon_version() -> None:
-    """Check if the deployed coverage addon version is stale.
-
-    Compares the version in _version.txt against the installed package
-    version. Prints a warning to stderr if the addon is missing or stale.
-    Fails silently on any unexpected error.
-
-    FR2: Stale Addon Check on CLI Invocation.
-    FR3: Suppressed by GD_TOOLS_NO_UPDATE_CHECK=1.
-    FR4: Uses packaging.version.parse() for comparison.
-    """
-    # FR3.1: Environment variable disables check entirely.
-    if os.environ.get("GD_TOOLS_NO_UPDATE_CHECK") == "1":
-        return
-
-    try:
-        project_root = find_project_root()
-        version_file = (
-            project_root
-            / "addons"
-            / "gd-tools-coverage"
-            / ADDON_VERSION_FILENAME
-        )
-
-        if not version_file.exists():
-            click.echo(
-                "WARNING: Coverage addon version file not found. "
-                "Run `gd-tools init` to deploy the addon.",
-                err=True,
-            )
-            return
-
-        addon_version = version_file.read_text(encoding="utf-8").strip()
-        stale_msg = (
-            f"WARNING: Coverage addon is outdated (v{addon_version} "
-            f"deployed, v{__version__} available). "
-            f"Run `gd-tools init` to update."
-        )
-
-        # FR4.1: Compare versions using packaging.version.parse().
-        try:
-            addon_parsed = parse_version(addon_version)
-            package_parsed = parse_version(__version__)
-        except (TypeError, ValueError):
-            # FR4.2: Unparseable version = treated as stale.
-            click.echo(stale_msg, err=True)
-            return
-
-        # FR2.4: Stale (addon < package)
-        if addon_parsed < package_parsed:
-            click.echo(stale_msg, err=True)
-        # FR2.5: Match = no warning
-        # FR2.6: Newer addon (downgrade) = no warning
-    except Exception:
-        # FR2.8: Fail silently on any unexpected error.
-        pass