deepctl-cmd-ffprobe 0.0.2__py3-none-any.whl

deepctl_cmd_ffprobe/__init__.py

@@ -0,0 +1,6 @@
+"""FFprobe configuration command for deepctl."""
+
+from .command import FfprobeCommand
+from .models import FfprobeResult
+
+__all__ = ["FfprobeCommand", "FfprobeResult"]

deepctl_cmd_ffprobe/command.py

@@ -0,0 +1,190 @@
+"""FFprobe configuration command for deepctl."""
+
+from __future__ import annotations
+
+import os
+import shutil
+import subprocess
+from typing import Any
+
+from deepctl_core import AuthManager, BaseCommand, BaseResult, Config, DeepgramClient
+from deepctl_shared_utils import (
+    get_ffprobe_path,
+    print_ffprobe_install_instructions,
+)
+from rich.console import Console
+
+from .models import FfprobeResult
+
+console = Console()
+
+
+class FfprobeCommand(BaseCommand):
+    """Manage ffprobe configuration for audio analysis."""
+
+    name = "ffprobe"
+    help = (
+        "Show ffprobe status or configure a custom path. "
+        "ffprobe is used for audio analysis in transcribe and debug commands."
+    )
+    short_help = "Configure ffprobe"
+
+    requires_auth = False
+    requires_project = False
+    ci_friendly = True
+
+    examples = [
+        "dg ffprobe",
+        "dg ffprobe --path /opt/homebrew/bin/ffprobe",
+        "dg ffprobe --path $(which ffprobe)",
+        "dg ffprobe --reset",
+    ]
+    agent_help = (
+        "Show ffprobe detection status or set a custom path. "
+        "ffprobe (part of FFmpeg) is used for audio file analysis. "
+        "Use --path to store a custom binary path, --reset to clear it."
+    )
+
+    def get_arguments(self) -> list[dict[str, Any]]:
+        """Get command arguments and options."""
+        return [
+            {
+                "names": ["--path"],
+                "help": "Set custom ffprobe binary path",
+                "type": str,
+                "is_option": True,
+            },
+            {
+                "names": ["--reset"],
+                "help": "Clear stored path, revert to auto-detection",
+                "is_flag": True,
+                "is_option": True,
+            },
+        ]
+
+    def handle(
+        self,
+        config: Config,
+        auth_manager: AuthManager,
+        client: DeepgramClient,
+        **kwargs: Any,
+    ) -> BaseResult:
+        """Handle ffprobe command."""
+        path = kwargs.get("path")
+        reset = kwargs.get("reset", False)
+
+        if path and reset:
+            console.print("[red]Error:[/red] Cannot use --path and --reset together")
+            return BaseResult(
+                status="error",
+                message="Cannot use --path and --reset together",
+            )
+
+        if reset:
+            return self._handle_reset(config)
+
+        if path:
+            return self._handle_set_path(config, path)
+
+        return self._handle_status(config)
+
+    def _handle_set_path(self, config: Config, path: str) -> BaseResult:
+        """Store a custom ffprobe path."""
+        # Validate the path
+        if not os.path.isfile(path):
+            console.print(f"[red]Error:[/red] File not found: {path}")
+            return BaseResult(status="error", message=f"File not found: {path}")
+
+        if not os.access(path, os.X_OK):
+            console.print(f"[red]Error:[/red] File is not executable: {path}")
+            return BaseResult(status="error", message=f"File is not executable: {path}")
+
+        # Store in config
+        config._config.tools.ffprobe_path = path
+        config.save()
+
+        version = self._get_version(path)
+        console.print(f"[green]✓[/green] ffprobe path stored: {path}")
+        if version:
+            console.print(f"  Version: {version}")
+
+        return FfprobeResult(
+            status="success",
+            message=f"ffprobe path set to {path}",
+            stored_path=path,
+            version=version,
+            available=True,
+        )
+
+    def _handle_reset(self, config: Config) -> BaseResult:
+        """Clear stored ffprobe path."""
+        config._config.tools.ffprobe_path = None
+        config.save()
+
+        console.print("[green]✓[/green] Stored ffprobe path cleared")
+
+        # Show auto-detected path
+        auto_path = shutil.which("ffprobe")
+        if auto_path:
+            console.print(f"  Auto-detected: {auto_path}")
+        else:
+            console.print("  [yellow]ffprobe not found in PATH[/yellow]")
+
+        return FfprobeResult(
+            status="success",
+            message="Stored ffprobe path cleared",
+            detected_path=auto_path,
+            available=auto_path is not None,
+        )
+
+    def _handle_status(self, config: Config) -> BaseResult:
+        """Show ffprobe status."""
+        stored_path = config.get("tools.ffprobe_path")
+        auto_path = shutil.which("ffprobe")
+        effective_path = get_ffprobe_path(config)
+
+        if stored_path:
+            console.print(f"  Stored path:    {stored_path}")
+        if auto_path:
+            console.print(f"  Auto-detected:  {auto_path}")
+
+        if effective_path:
+            version = self._get_version(effective_path)
+            console.print(f"  Active path:    [green]{effective_path}[/green]")
+            if version:
+                console.print(f"  Version:        {version}")
+            console.print("\n[green]✓[/green] ffprobe is available")
+
+            return FfprobeResult(
+                status="success",
+                message="ffprobe is available",
+                stored_path=stored_path,
+                detected_path=auto_path,
+                version=version,
+                available=True,
+            )
+        else:
+            print_ffprobe_install_instructions()
+
+            return FfprobeResult(
+                status="error",
+                message="ffprobe not found",
+                available=False,
+            )
+
+    def _get_version(self, ffprobe_path: str) -> str | None:
+        """Get ffprobe version string."""
+        try:
+            result = subprocess.run(
+                [ffprobe_path, "-version"],
+                capture_output=True,
+                text=True,
+                timeout=5,
+            )
+            if result.returncode == 0:
+                # First line is typically "ffprobe version X.Y.Z ..."
+                first_line = result.stdout.strip().split("\n")[0]
+                return first_line
+        except (subprocess.TimeoutExpired, OSError):
+            pass
+        return None

deepctl_cmd_ffprobe/models.py

@@ -0,0 +1,10 @@
+"""Models for ffprobe command."""
+
+from deepctl_core import BaseResult
+
+
+class FfprobeResult(BaseResult):
+    stored_path: str | None = None
+    detected_path: str | None = None
+    version: str | None = None
+    available: bool = False

deepctl_cmd_ffprobe-0.0.2.dist-info/METADATA

@@ -0,0 +1,64 @@
+Metadata-Version: 2.4
+Name: deepctl-cmd-ffprobe
+Version: 0.0.2
+Summary: FFprobe configuration command for deepctl
+Author-email: Deepgram <devrel@deepgram.com>
+Maintainer-email: Deepgram <devrel@deepgram.com>
+License-Expression: MIT
+Keywords: deepgram,cli,ffprobe,audio,config
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: deepctl-core>=0.1.10
+Requires-Dist: deepctl-shared-utils>=0.1.10
+Requires-Dist: click>=8.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: pydantic>=2.0.0
+
+# deepctl-cmd-ffprobe
+
+> Part of [deepctl](https://github.com/deepgram/cli) — Official Deepgram CLI
+
+FFprobe configuration command for deepctl
+
+## Installation
+
+This package is included with deepctl and does not need to be installed separately.
+
+### Install deepctl
+
+```bash
+# Install with pip
+pip install deepctl
+
+# Or install with uv
+uv tool install deepctl
+
+# Or install with pipx
+pipx install deepctl
+
+# Or run without installing
+uvx deepctl --help
+pipx run deepctl --help
+```
+
+## Commands
+
+| Command | Entry Point |
+|---------|-------------|
+| `deepctl ffprobe` | `deepctl_cmd_ffprobe.command:FfprobeCommand` |
+
+## Dependencies
+
+- `click>=8.0.0`
+- `rich>=13.0.0`
+- `pydantic>=2.0.0`
+
+## License
+
+MIT — see [LICENSE](../../LICENSE)

deepctl_cmd_ffprobe-0.0.2.dist-info/RECORD

@@ -0,0 +1,8 @@
+deepctl_cmd_ffprobe/__init__.py,sha256=3eEcc91Th0_CXbjVvTUf84silZRqMHRZdI2kO-ZZ0Nw,167
+deepctl_cmd_ffprobe/command.py,sha256=kbdwheOUHiaO2iSloG5whysxoMQ-1mdEzVXwbF1ARrI,6040
+deepctl_cmd_ffprobe/models.py,sha256=VnteyE8BwC2B2tkpQjClqv-8DzP1PLZQn4Uja0LLNY4,237
+deepctl_cmd_ffprobe-0.0.2.dist-info/METADATA,sha256=fMuHW2CtEPVzZJX1CUCzRG3v63sGPlS-Kc6lc9KMdnQ,1537
+deepctl_cmd_ffprobe-0.0.2.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+deepctl_cmd_ffprobe-0.0.2.dist-info/entry_points.txt,sha256=ou9pLAJ-nPfmHmc1YXaJp4f3QHBRUAzMojIy4FcqU1g,72
+deepctl_cmd_ffprobe-0.0.2.dist-info/top_level.txt,sha256=XTEF_ttbyl-aE8Fz9k3T7n1goc76-0wxSKHaNA4OFYI,20
+deepctl_cmd_ffprobe-0.0.2.dist-info/RECORD,,

deepctl_cmd_ffprobe-0.0.2.dist-info/WHEEL

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

deepctl_cmd_ffprobe-0.0.2.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[deepctl.commands]
+ffprobe = deepctl_cmd_ffprobe.command:FfprobeCommand

deepctl_cmd_ffprobe-0.0.2.dist-info/top_level.txt

@@ -0,0 +1 @@
+deepctl_cmd_ffprobe