gd-tools-cli 0.3.0__tar.gz → 0.4.0__tar.gz

{gd_tools_cli-0.3.0 → gd_tools_cli-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gd-tools-cli
-Version: 0.3.0
+Version: 0.4.0
 Summary: A modern development workflow CLI for GDScript projects in Godot 4.5+
 Author-email: mansyar <m.ansyarafi@gmail.com>
 License: MIT
@@ -45,8 +45,8 @@ A modern development workflow CLI for GDScript projects in Godot 4.5+.
 
 [![CI](https://github.com/mansyar/gd-tools/actions/workflows/ci.yml/badge.svg)](https://github.com/mansyar/gd-tools/actions/workflows/ci.yml)
 [![Coverage](https://codecov.io/gh/mansyar/gd-tools/branch/main/graph/badge.svg)](https://codecov.io/gh/mansyar/gd-tools)
-[![PyPI version](https://img.shields.io/pypi/v/gd-tools.svg)](https://pypi.org/project/gd-tools/)
-[![Python versions](https://img.shields.io/pypi/pyversions/gd-tools.svg)](https://pypi.org/project/gd-tools/)
+[![PyPI version](https://img.shields.io/pypi/v/gd-tools-cli.svg)](https://pypi.org/project/gd-tools-cli/)
+[![Python versions](https://img.shields.io/pypi/pyversions/gd-tools-cli.svg)](https://pypi.org/project/gd-tools-cli/)
 [![Godot version](https://img.shields.io/badge/Godot-4.5%2B-blue.svg)](https://godotengine.org)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
@@ -66,7 +66,7 @@ One install, one config, one mental model.
 
 | Feature | Description |
 |---------|-------------|
-| **Unified workflow** | One install, one config (`gd-tools.toml`), one mental model for test, lint, format, and coverage. |
+| **Unified workflow** | One install, one config (`gd-tools.toml`), one mental model for test, lint, format, and coverage. Consistent terminal output with colored markers and summary footers across all commands. |
 | **Zero-friction bootstrap** | `gd-tools init` gets a project fully set up in under a minute -- GUT installed, coverage addon deployed, configs generated. |
 | **Coverage gap-filling** | Production-quality line and branch coverage for GDScript -- HTML, LCOV, and Cobertura reports that integrate with CI and code review tools. |
 | **CI/CD friendly** | Exit codes, `--check` flags, machine-readable output (JSON, JUnit XML, LCOV, Cobertura), no interactive prompts in CI mode. |
@@ -113,6 +113,8 @@ gd-tools test --coverage --min 80
 | `gd-tools lint` | Lint GDScript files using gdlint with text or JSON output. Accepts one or more file or directory paths. |
 | `gd-tools format` | Format GDScript files using gdformat with check and diff modes. Accepts one or more file or directory paths. |
 | `gd-tools coverage` | Coverage subcommands -- `report`, `merge`, `show`. |
+| `gd-tools config` | Configuration management -- `show` (display resolved config), `validate` (check config validity). |
+| `gd-tools version` | Display versions of all gd-tools components (gd-tools, Godot, GUT, gdtoolkit, Python) in a table or JSON. |
 
 See the [User Guide](./docs/USER_GUIDE.md) for full command reference,
 flags, examples, and exit codes.

{gd_tools_cli-0.3.0 → gd_tools_cli-0.4.0}/README.md

@@ -4,8 +4,8 @@ A modern development workflow CLI for GDScript projects in Godot 4.5+.
 
 [![CI](https://github.com/mansyar/gd-tools/actions/workflows/ci.yml/badge.svg)](https://github.com/mansyar/gd-tools/actions/workflows/ci.yml)
 [![Coverage](https://codecov.io/gh/mansyar/gd-tools/branch/main/graph/badge.svg)](https://codecov.io/gh/mansyar/gd-tools)
-[![PyPI version](https://img.shields.io/pypi/v/gd-tools.svg)](https://pypi.org/project/gd-tools/)
-[![Python versions](https://img.shields.io/pypi/pyversions/gd-tools.svg)](https://pypi.org/project/gd-tools/)
+[![PyPI version](https://img.shields.io/pypi/v/gd-tools-cli.svg)](https://pypi.org/project/gd-tools-cli/)
+[![Python versions](https://img.shields.io/pypi/pyversions/gd-tools-cli.svg)](https://pypi.org/project/gd-tools-cli/)
 [![Godot version](https://img.shields.io/badge/Godot-4.5%2B-blue.svg)](https://godotengine.org)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
@@ -25,7 +25,7 @@ One install, one config, one mental model.
 
 | Feature | Description |
 |---------|-------------|
-| **Unified workflow** | One install, one config (`gd-tools.toml`), one mental model for test, lint, format, and coverage. |
+| **Unified workflow** | One install, one config (`gd-tools.toml`), one mental model for test, lint, format, and coverage. Consistent terminal output with colored markers and summary footers across all commands. |
 | **Zero-friction bootstrap** | `gd-tools init` gets a project fully set up in under a minute -- GUT installed, coverage addon deployed, configs generated. |
 | **Coverage gap-filling** | Production-quality line and branch coverage for GDScript -- HTML, LCOV, and Cobertura reports that integrate with CI and code review tools. |
 | **CI/CD friendly** | Exit codes, `--check` flags, machine-readable output (JSON, JUnit XML, LCOV, Cobertura), no interactive prompts in CI mode. |
@@ -72,6 +72,8 @@ gd-tools test --coverage --min 80
 | `gd-tools lint` | Lint GDScript files using gdlint with text or JSON output. Accepts one or more file or directory paths. |
 | `gd-tools format` | Format GDScript files using gdformat with check and diff modes. Accepts one or more file or directory paths. |
 | `gd-tools coverage` | Coverage subcommands -- `report`, `merge`, `show`. |
+| `gd-tools config` | Configuration management -- `show` (display resolved config), `validate` (check config validity). |
+| `gd-tools version` | Display versions of all gd-tools components (gd-tools, Godot, GUT, gdtoolkit, Python) in a table or JSON. |
 
 See the [User Guide](./docs/USER_GUIDE.md) for full command reference,
 flags, examples, and exit codes.

{gd_tools_cli-0.3.0 → gd_tools_cli-0.4.0}/pyproject.toml

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

gd_tools_cli-0.4.0/src/gd_tools/addon_check.py

@@ -0,0 +1,75 @@
+"""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