deepctl-core 0.2.8__tar.gz → 0.2.10__tar.gz

{deepctl_core-0.2.8 → deepctl_core-0.2.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepctl-core
-Version: 0.2.8
+Version: 0.2.10
 Summary: Core components for deepctl
 Author-email: Deepgram <devrel@deepgram.com>
 Maintainer-email: Deepgram <devrel@deepgram.com>

{deepctl_core-0.2.8 → deepctl_core-0.2.10}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "deepctl-core"
-version = "0.2.8" # x-release-please-version
+version = "0.2.10" # x-release-please-version
 description = "Core components for deepctl"
 readme = "README.md"
 license = "MIT"

{deepctl_core-0.2.8 → deepctl_core-0.2.10}/src/deepctl_core/auth.py

@@ -647,9 +647,13 @@ class AuthManager:
                 keyring.set_password(
                     KEYRING_SERVICE, f"refresh-token.{profile_name}", refresh_token
                 )
-                console.print("[green]✓[/green] Session stored securely in system keyring")
+                console.print(
+                    "[green]✓[/green] Session stored securely in system keyring"
+                )
             except Exception as e:
-                console.print(f"[yellow]Warning:[/yellow] Could not store in keyring: {e}")
+                console.print(
+                    f"[yellow]Warning:[/yellow] Could not store in keyring: {e}"
+                )
 
             # Store expiry timestamps and project ID in config (non-sensitive).
             profile = self.config.get_profile(profile_name)
@@ -664,11 +668,17 @@ class AuthManager:
             keyring_available = False
 
             try:
-                keyring.set_password(KEYRING_SERVICE, f"api-key.{profile_name}", api_key)
-                console.print("[green]✓[/green] API key stored securely in system keyring")
+                keyring.set_password(
+                    KEYRING_SERVICE, f"api-key.{profile_name}", api_key
+                )
+                console.print(
+                    "[green]✓[/green] API key stored securely in system keyring"
+                )
                 keyring_available = True
             except Exception as e:
-                console.print(f"[yellow]Warning:[/yellow] Could not store in keyring: {e}")
+                console.print(
+                    f"[yellow]Warning:[/yellow] Could not store in keyring: {e}"
+                )
                 console.print("API key will be stored in config file instead")
 
             self.config.create_profile(

{deepctl_core-0.2.8 → deepctl_core-0.2.10}/src/deepctl_core/config.py

@@ -54,6 +54,12 @@ class ToolsConfig(BaseModel):
     ffprobe_path: str | None = None
 
 
+class TelemetryConfig(BaseModel):
+    """Phone-home telemetry configuration. Opt-out — defaults to on."""
+
+    enabled: bool = True
+
+
 class DeepgramConfig(BaseModel):
     """Main configuration model."""
 
@@ -64,6 +70,7 @@ class DeepgramConfig(BaseModel):
     plugins: PluginConfig = Field(default_factory=PluginConfig)
     update: UpdateConfig = Field(default_factory=UpdateConfig)
     tools: ToolsConfig = Field(default_factory=ToolsConfig)
+    telemetry: TelemetryConfig = Field(default_factory=TelemetryConfig)
 
 
 class Config:

{deepctl_core-0.2.8 → deepctl_core-0.2.10}/src/deepctl_core/plugin_env.py

@@ -96,6 +96,45 @@ def get_venv_python() -> str | None:
     return str(python) if python.exists() else None
 
 
+def get_venv_python_version() -> tuple[int, int] | None:
+    """Read the (major, minor) Python version that built the plugin venv.
+
+    Reads ``pyvenv.cfg`` from :data:`PLUGIN_VENV`. Both ``version`` (stdlib
+    ``python -m venv``) and ``version_info`` (uv-created venvs) are accepted.
+
+    Returns ``None`` when the venv doesn't exist, the cfg file is missing,
+    or the version line can't be parsed — callers should treat ``None`` as
+    "unknown" and skip ABI-mismatch checks rather than failing loudly.
+    """
+    if not PLUGIN_VENV.exists():
+        return None
+
+    cfg = PLUGIN_VENV / "pyvenv.cfg"
+    if not cfg.exists():
+        return None
+
+    try:
+        text = cfg.read_text()
+    except OSError:
+        return None
+
+    for line in text.splitlines():
+        key, sep, value = line.partition("=")
+        if not sep:
+            continue
+        if key.strip() not in ("version", "version_info"):
+            continue
+        parts = value.strip().split(".")
+        if len(parts) < 2:
+            continue
+        try:
+            return int(parts[0]), int(parts[1])
+        except ValueError:
+            continue
+
+    return None
+
+
 def get_venv_site_packages() -> Path | None:
     """Return the ``site-packages`` directory inside the plugin venv.
 

{deepctl_core-0.2.8 → deepctl_core-0.2.10}/src/deepctl_core/plugin_manager.py

@@ -12,7 +12,13 @@ from rich.console import Console
 from .base_command import BaseCommand
 from .base_group_command import BaseGroupCommand
 from .models import ErrorResult, PluginInfo
-from .plugin_env import PLUGIN_VENV, get_plugin_state, get_venv_site_packages
+from .output import print_warning
+from .plugin_env import (
+    PLUGIN_VENV,
+    get_plugin_state,
+    get_venv_python_version,
+    get_venv_site_packages,
+)
 from .timing import TimingContext
 
 console = Console()
@@ -139,6 +145,8 @@ class PluginManager:
         if site_packages is None:
             return
 
+        self._warn_if_plugin_venv_python_mismatch()
+
         site_packages_str = str(site_packages)
 
         # Append to sys.path so modules inside the plugin venv can be imported.
@@ -186,6 +194,36 @@ class PluginManager:
         except Exception as e:
             console.print(f"[red]Error loading plugins from plugin venv:[/red] {e}")
 
+    def _warn_if_plugin_venv_python_mismatch(self) -> None:
+        """Surface a one-line warning when the plugin venv's Python differs from ours.
+
+        Triggered when the underlying interpreter is bumped (e.g. ``brew upgrade
+        python@3.13`` rebuilding deepctl against a newer Python) without the user
+        recreating ``~/.deepctl/plugins/venv/``. Pure-Python plugins keep loading
+        via :data:`sys.path` bridging; only C-extension plugins fail to load,
+        and they fail with a confusing low-level ImportError. This warning gives
+        users a clear remediation before they hit that error.
+
+        Silent when the venv version can't be determined (no ``pyvenv.cfg``,
+        unparseable cfg, etc.) — there's no useful guidance to give.
+        """
+        venv_version = get_venv_python_version()
+        if venv_version is None:
+            return
+
+        running = (sys.version_info.major, sys.version_info.minor)
+        if venv_version == running:
+            return
+
+        venv_str = f"{venv_version[0]}.{venv_version[1]}"
+        running_str = f"{running[0]}.{running[1]}"
+        print_warning(
+            f"Plugin environment was built with Python {venv_str} but you're "
+            f"running Python {running_str}. C-extension plugins may fail to "
+            f"load. To rebuild:\n"
+            f"  rm -rf {PLUGIN_VENV} && dg plugin install <your-plugin>"
+        )
+
     def _create_click_command(self, command_instance: Any) -> click.Command:
         """Create a Click command from a BaseCommand instance.
 

{deepctl_core-0.2.8 → deepctl_core-0.2.10}/src/deepctl_core.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepctl-core
-Version: 0.2.8
+Version: 0.2.10
 Summary: Core components for deepctl
 Author-email: Deepgram <devrel@deepgram.com>
 Maintainer-email: Deepgram <devrel@deepgram.com>