deepctl-cmd-debug-toolkit 0.1.0__py3-none-any.whl → 0.5.0__py3-none-any.whl

deepctl_cmd_debug_toolkit/command.py

@@ -8,7 +8,10 @@ import sys
 from typing import Any
 
 import click
-from deepctl_core import AuthManager, BaseGroupCommand, Config
+from deepctl_core import AuthenticationError, AuthManager, BaseGroupCommand, Config
+
+# Already loaded with BaseGroupCommand (deepctl_core.base_command imports it).
+from deepctl_core.hosts import DEFAULT_BASE_URL
 from rich.console import Console
 
 from .fetcher import get_cached_manifest, get_or_fetch_script, refresh_manifest
@@ -16,6 +19,9 @@ from .models import ToolkitScript
 
 console = Console()
 
+# The streaming endpoint the examples point at, built from the one default.
+_LISTEN_WS_URL = DEFAULT_BASE_URL.replace("https://", "wss://", 1) + "/v1/listen"
+
 
 class ToolkitCommand(BaseGroupCommand):
     """Runs field engineering scripts from deepgram/support-toolkit."""
@@ -35,8 +41,8 @@ class ToolkitCommand(BaseGroupCommand):
 
     examples = [
         "dg debug toolkit refresh",
-        "dg debug toolkit latency wss://api.deepgram.com/v1/listen",
-        "dg debug toolkit latency wss://api.deepgram.com/v1/listen --duration=60",
+        f"dg debug toolkit latency {_LISTEN_WS_URL}",
+        f"dg debug toolkit latency {_LISTEN_WS_URL} --duration=60",
     ]
 
     def setup_commands(self) -> list[click.Command]:
@@ -131,8 +137,10 @@ def _make_script_command(name: str, entry: ToolkitScript) -> click.Command:
                 api_key = AuthManager(Config()).get_api_key()
                 if api_key:
                     env["DEEPGRAM_API_KEY"] = api_key
-            except Exception:
-                pass  # Script will surface its own missing-key error
+            except AuthenticationError as exc:
+                console.print(
+                    f"[yellow]Could not provide Deepgram credentials:[/yellow] {exc}"
+                )
 
         result = subprocess.run(
             [sys.executable, str(script_path)] + list(script_args),

deepctl_cmd_debug_toolkit/fetcher.py

@@ -9,7 +9,6 @@ import time
 from pathlib import Path
 from typing import TYPE_CHECKING
 
-import httpx
 import platformdirs
 from rich.console import Console
 
@@ -50,6 +49,8 @@ def _fetch_github_contents(path: str) -> tuple[str, bytes]:
 
     Returns (blob_sha, raw_bytes). Raises on any HTTP error or SHA mismatch.
     """
+    import httpx
+
     url = f"{GITHUB_API_BASE}/{path}"
     resp = httpx.get(
         url,
@@ -72,10 +73,18 @@ def _fetch_github_contents(path: str) -> tuple[str, bytes]:
 
 
 def get_cached_manifest() -> ToolkitManifest | None:
-    """Return the cached manifest if it exists and is fresh, else None."""
-    if not _MANIFEST_CACHE.exists():
+    """Return the cached manifest if it exists and is fresh, else None.
+
+    An unreadable cache (a HOME the user can't read) counts as no cache:
+    loading the debug group, and every `dg debug <sub> --help`, reads this.
+    """
+    try:
+        if not _MANIFEST_CACHE.exists():
+            return None
+        has_age = _MANIFEST_AGE.exists()
+    except OSError:
         return None
-    if _MANIFEST_AGE.exists():
+    if has_age:
         try:
             age = float(_MANIFEST_AGE.read_text().strip())
             if time.time() - age > _MANIFEST_TTL:

{deepctl_cmd_debug_toolkit-0.1.0.dist-info → deepctl_cmd_debug_toolkit-0.5.0.dist-info}/METADATA

@@ -1,17 +1,18 @@
 Metadata-Version: 2.4
 Name: deepctl-cmd-debug-toolkit
-Version: 0.1.0
+Version: 0.5.0
 Summary: Toolkit subcommand for dg debug — runs field support scripts from deepgram/support-toolkit
 Author-email: Deepgram <devrel@deepgram.com>
 License-Expression: MIT
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
-Requires-Dist: deepctl-core>=0.1.10
-Requires-Dist: httpx>=0.27.0
-Requires-Dist: pydantic>=2.10.1
-Requires-Dist: platformdirs>=4.0.0
-Requires-Dist: rich>=13.9.4
-Requires-Dist: click>=8.1.7
+Requires-Dist: deepctl==0.5.0
+Requires-Dist: deepctl-core==0.5.0
+Requires-Dist: httpx<1,>=0.27.0
+Requires-Dist: pydantic<3,>=2.10.1
+Requires-Dist: platformdirs<5,>=4.0.0
+Requires-Dist: rich<16,>=13.9.4
+Requires-Dist: click<9,>=8.2.0
 Provides-Extra: dev
 Requires-Dist: pytest>=8.3.3; extra == "dev"
 Requires-Dist: pytest-mock>=3.14.0; extra == "dev"
@@ -55,11 +56,11 @@ pipx run deepctl --help
 
 ## Dependencies
 
-- `httpx>=0.27.0`
-- `pydantic>=2.10.1`
-- `platformdirs>=4.0.0`
-- `rich>=13.9.4`
-- `click>=8.1.7`
+- `httpx>=0.27.0,<1`
+- `pydantic>=2.10.1,<3`
+- `platformdirs>=4.0.0,<5`
+- `rich>=13.9.4,<16`
+- `click>=8.2.0,<9`
 
 ## License
 

deepctl_cmd_debug_toolkit-0.5.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+deepctl_cmd_debug_toolkit/__init__.py,sha256=koXSDCTIRP3qm6Aa__0bGkrfMGP0QQK53EEwk5VbKcI,162
+deepctl_cmd_debug_toolkit/command.py,sha256=pEd3qf_oX7UqgC1jWD0Hgd5iuoMunCYVC8KSHdgW-7I,5269
+deepctl_cmd_debug_toolkit/fetcher.py,sha256=kzoVoVftL0o-AjzKO3UHzEgkd2lD21Bx6gVEf8qyUjY,5075
+deepctl_cmd_debug_toolkit/models.py,sha256=boToXfTJWbRXmZdbmwhSByul3V8TySUGTaSlp-IkAjI,499
+deepctl_cmd_debug_toolkit-0.5.0.dist-info/METADATA,sha256=F1aPOcCw17ZTPblhs2f3IlEi8Pf95uKgoRqO9gzY5eM,1651
+deepctl_cmd_debug_toolkit-0.5.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+deepctl_cmd_debug_toolkit-0.5.0.dist-info/entry_points.txt,sha256=L1Lk43utOWOLoEMRdwWC7OX0re75omA4y9ZIwAvJyw8,87
+deepctl_cmd_debug_toolkit-0.5.0.dist-info/top_level.txt,sha256=nY0EOsmsW2gdj-lQZNzh8bhkrGXZMvnNpLLy6FJJpfQ,26
+deepctl_cmd_debug_toolkit-0.5.0.dist-info/RECORD,,

{deepctl_cmd_debug_toolkit-0.1.0.dist-info → deepctl_cmd_debug_toolkit-0.5.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (82.0.1)
+Generator: setuptools (84.2.1)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

deepctl_cmd_debug_toolkit-0.1.0.dist-info/RECORD

@@ -1,9 +0,0 @@
-deepctl_cmd_debug_toolkit/__init__.py,sha256=koXSDCTIRP3qm6Aa__0bGkrfMGP0QQK53EEwk5VbKcI,162
-deepctl_cmd_debug_toolkit/command.py,sha256=kXK386bSHtWcHsn_c8C3Lwql5ycSGC8VRttAEemXHgw,4909
-deepctl_cmd_debug_toolkit/fetcher.py,sha256=xeeefB8Ev672k0VCEEVFC_89soP_1gk5jvnY1Lu3AOQ,4832
-deepctl_cmd_debug_toolkit/models.py,sha256=boToXfTJWbRXmZdbmwhSByul3V8TySUGTaSlp-IkAjI,499
-deepctl_cmd_debug_toolkit-0.1.0.dist-info/METADATA,sha256=KUbeEu83nRjHWM-wBo3ZlngNRnPJeTrOT51O5lI-84Y,1590
-deepctl_cmd_debug_toolkit-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-deepctl_cmd_debug_toolkit-0.1.0.dist-info/entry_points.txt,sha256=L1Lk43utOWOLoEMRdwWC7OX0re75omA4y9ZIwAvJyw8,87
-deepctl_cmd_debug_toolkit-0.1.0.dist-info/top_level.txt,sha256=nY0EOsmsW2gdj-lQZNzh8bhkrGXZMvnNpLLy6FJJpfQ,26
-deepctl_cmd_debug_toolkit-0.1.0.dist-info/RECORD,,