gda 0.1.24__py3-none-any.whl

gda/__init__.py

@@ -0,0 +1 @@
+"""gda — an agent-facing Godot CLI with structured output."""

gda/__main__.py

@@ -0,0 +1,14 @@
+"""Enable ``python -m gda`` (and thus ``sys.executable -m gda``).
+
+gda-mcp invokes the CLI as ``[sys.executable, "-m", "gda", …]`` for a
+deterministic, same-environment binary (ADR-0011, Design decision 3): it runs
+the *exact* gda paired with the running gda-mcp, never a wrong global ``gda`` a
+PATH lookup might resolve. This module is the ``-m gda`` entry point that makes
+that invocation work; it shares the one Typer ``app`` with the ``gda`` console
+script, so both entry points behave identically.
+"""
+
+from gda.cli import app
+
+if __name__ == "__main__":
+    app()

gda/binary.py

@@ -0,0 +1,35 @@
+"""Godot binary resolution.
+
+Resolution precedence (highest first):
+
+1. An explicit path passed by the caller (the ``--godot`` flag).
+2. The ``GDA_GODOT`` environment variable.
+3. The local development default (the path documented in RULES.md).
+"""
+
+import os
+from collections.abc import Mapping
+from pathlib import Path
+
+GODOT_BIN_ENV = "GDA_GODOT"
+
+# Local development default, per RULES.md.
+DEFAULT_GODOT_BIN = "~/Applications/Godot.app/Contents/MacOS/Godot"
+
+
+def resolve_godot_binary(
+    explicit: str | None = None,
+    env: Mapping[str, str] | None = None,
+) -> Path:
+    """Resolve the Godot binary path using flag > env > default precedence."""
+    if env is None:
+        env = os.environ
+    if explicit is not None:
+        # An explicit (even if empty) value is a deliberate choice; an empty
+        # one is a mistake we surface rather than silently override.
+        if not explicit:
+            raise ValueError("explicit Godot binary path is empty")
+        raw = explicit
+    else:
+        raw = env.get(GODOT_BIN_ENV) or DEFAULT_GODOT_BIN
+    return Path(raw).expanduser()