deepctl-shared-utils 0.1.10__tar.gz → 0.1.11__tar.gz

deepctl_shared_utils-0.1.11/PKG-INFO

@@ -0,0 +1,60 @@
+Metadata-Version: 2.4
+Name: deepctl-shared-utils
+Version: 0.1.11
+Summary: Shared utilities for deepctl
+Author-email: Deepgram <devrel@deepgram.com>
+Maintainer-email: Deepgram <devrel@deepgram.com>
+License-Expression: MIT
+Keywords: deepgram,utilities,validation,helpers
+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: pydantic>=2.0.0
+Requires-Dist: click>=8.0.0
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: rich>=13.0.0
+
+# deepctl-shared-utils
+
+> Part of [deepctl](https://github.com/deepgram/cli) — Official Deepgram CLI
+
+Shared utilities for deepctl
+
+This package provides internal APIs for deepctl and its command packages. It is not intended for direct use.
+
+## 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
+```
+
+## Dependencies
+
+- `pydantic>=2.0.0`
+- `click>=8.0.0`
+- `httpx>=0.24.0`
+- `rich>=13.0.0`
+
+## License
+
+MIT — see [LICENSE](../../LICENSE)

deepctl_shared_utils-0.1.11/README.md

@@ -0,0 +1,39 @@
+# deepctl-shared-utils
+
+> Part of [deepctl](https://github.com/deepgram/cli) — Official Deepgram CLI
+
+Shared utilities for deepctl
+
+This package provides internal APIs for deepctl and its command packages. It is not intended for direct use.
+
+## 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
+```
+
+## Dependencies
+
+- `pydantic>=2.0.0`
+- `click>=8.0.0`
+- `httpx>=0.24.0`
+- `rich>=13.0.0`
+
+## License
+
+MIT — see [LICENSE](../../LICENSE)

{deepctl_shared_utils-0.1.10 → deepctl_shared_utils-0.1.11}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "deepctl-shared-utils"
-version = "0.1.10"
+version = "0.1.11" # x-release-please-version
 description = "Shared utilities for deepctl"
 readme = "README.md"
 license = "MIT"
@@ -20,7 +20,7 @@ classifiers = [
 ]
 keywords = ["deepgram", "utilities", "validation", "helpers"]
 requires-python = ">=3.10"
-dependencies = ["pydantic>=2.0.0", "click>=8.0.0", "httpx>=0.24.0"]
+dependencies = ["pydantic>=2.0.0", "click>=8.0.0", "httpx>=0.24.0", "rich>=13.0.0"]
 
 [tool.setuptools]
 package-dir = { "" = "src" }

deepctl_shared_utils-0.1.11/src/deepctl_shared_utils/__init__.py

@@ -0,0 +1,31 @@
+"""Shared utilities for deepctl."""
+
+from .ffprobe import (
+    check_ffprobe,
+    get_ffprobe_path,
+    print_ffprobe_install_instructions,
+    probe_buffer,
+    probe_file,
+    require_ffprobe,
+)
+from .ffprobe_models import AudioFormatInfo, AudioProbeResult, AudioStreamInfo
+from .models import FileInfo
+from .validation import validate_audio_file, validate_date_format, validate_url
+
+__all__ = [
+    "AudioFormatInfo",
+    "AudioProbeResult",
+    "AudioStreamInfo",
+    "FileInfo",
+    "check_ffprobe",
+    "get_ffprobe_path",
+    "print_ffprobe_install_instructions",
+    "probe_buffer",
+    "probe_file",
+    "require_ffprobe",
+    "validate_audio_file",
+    "validate_date_format",
+    "validate_url",
+]
+
+__version__ = "0.1.11"  # x-release-please-version

deepctl_shared_utils-0.1.11/src/deepctl_shared_utils/ffprobe.py

@@ -0,0 +1,225 @@
+"""Shared ffprobe wrapper for audio file analysis."""
+
+from __future__ import annotations
+
+import json
+import os
+import platform
+import shutil
+import subprocess
+import tempfile
+from typing import TYPE_CHECKING
+
+from rich.console import Console
+from rich.panel import Panel
+
+from .ffprobe_models import AudioFormatInfo, AudioProbeResult, AudioStreamInfo
+
+if TYPE_CHECKING:
+    from deepctl_core import Config
+
+console = Console()
+
+
+def get_ffprobe_path(config: Config | None = None) -> str | None:
+    """Get the ffprobe binary path.
+
+    Checks stored config path first, then falls back to auto-detection
+    via shutil.which().
+    """
+    if config is not None:
+        stored_path = config.get("tools.ffprobe_path")
+        if (
+            stored_path
+            and os.path.isfile(stored_path)
+            and os.access(stored_path, os.X_OK)
+        ):
+            return str(stored_path)
+
+    return shutil.which("ffprobe")
+
+
+def check_ffprobe(config: Config | None = None) -> bool:
+    """Check if ffprobe is available."""
+    return get_ffprobe_path(config) is not None
+
+
+def print_ffprobe_install_instructions() -> None:
+    """Print platform-specific ffprobe installation instructions."""
+    system = platform.system()
+
+    if system == "Darwin":
+        instructions = (
+            "[bold]Install FFmpeg (includes ffprobe):[/bold]\n\n"
+            "  [cyan]brew install ffmpeg[/cyan]\n"
+        )
+    elif system == "Linux":
+        instructions = (
+            "[bold]Install FFmpeg (includes ffprobe):[/bold]\n\n"
+            "  [cyan]sudo apt install ffmpeg[/cyan]      # Debian/Ubuntu\n"
+            "  [cyan]sudo dnf install ffmpeg[/cyan]      # Fedora\n"
+            "  [cyan]sudo pacman -S ffmpeg[/cyan]        # Arch\n"
+        )
+    elif system == "Windows":
+        instructions = (
+            "[bold]Install FFmpeg (includes ffprobe):[/bold]\n\n"
+            "  [cyan]winget install FFmpeg[/cyan]\n"
+            "  [cyan]choco install ffmpeg[/cyan]         # Chocolatey\n"
+            "  [cyan]scoop install ffmpeg[/cyan]         # Scoop\n"
+        )
+    else:
+        instructions = (
+            "[bold]Install FFmpeg (includes ffprobe):[/bold]\n\n"
+            "  Download from [cyan]https://ffmpeg.org/download.html[/cyan]\n"
+        )
+
+    instructions += (
+        "\nAfter installing, you can set a custom path with:\n"
+        "  [dim]dg ffprobe --path /path/to/ffprobe[/dim]"
+    )
+
+    console.print(
+        Panel(
+            instructions,
+            title="[red]ffprobe not found[/red]",
+            border_style="red",
+        )
+    )
+
+
+def require_ffprobe(config: Config | None = None) -> bool:
+    """Check for ffprobe and print install instructions if missing.
+
+    Returns True if ffprobe is available, False otherwise.
+    """
+    if check_ffprobe(config):
+        return True
+
+    print_ffprobe_install_instructions()
+    return False
+
+
+def _parse_probe_data(data: dict[str, object]) -> AudioProbeResult:
+    """Parse raw ffprobe JSON output into an AudioProbeResult."""
+    result = AudioProbeResult(raw_data=data)
+
+    fmt = data.get("format")
+    if isinstance(fmt, dict):
+        duration_str = fmt.get("duration")
+        size_str = fmt.get("size")
+        result.format = AudioFormatInfo(
+            format_name=fmt.get("format_name"),
+            format_long_name=fmt.get("format_long_name"),
+            duration=float(duration_str) if duration_str else None,
+            size=int(size_str) if size_str else None,
+            bit_rate=fmt.get("bit_rate"),
+        )
+
+    streams_data = data.get("streams")
+    if isinstance(streams_data, list):
+        for stream in streams_data:
+            if not isinstance(stream, dict):
+                continue
+            if stream.get("codec_type") != "audio":
+                continue
+            duration_str = stream.get("duration")
+            result.streams.append(
+                AudioStreamInfo(
+                    codec_name=stream.get("codec_name"),
+                    codec_long_name=stream.get("codec_long_name"),
+                    sample_rate=stream.get("sample_rate"),
+                    channels=stream.get("channels"),
+                    channel_layout=stream.get("channel_layout"),
+                    bit_rate=stream.get("bit_rate"),
+                    bits_per_sample=stream.get("bits_per_sample"),
+                    duration=float(duration_str) if duration_str else None,
+                )
+            )
+
+    return result
+
+
+def probe_file(file_path: str, config: Config | None = None) -> AudioProbeResult | None:
+    """Probe an audio file using ffprobe.
+
+    Returns AudioProbeResult on success, None on failure.
+    """
+    ffprobe_bin = get_ffprobe_path(config)
+    if not ffprobe_bin:
+        return None
+
+    try:
+        cmd = [
+            ffprobe_bin,
+            "-v",
+            "quiet",
+            "-print_format",
+            "json",
+            "-show_format",
+            "-show_streams",
+            file_path,
+        ]
+
+        result = subprocess.run(cmd, capture_output=True, text=True, timeout=30)
+
+        if result.returncode != 0:
+            return None
+
+        data = json.loads(result.stdout)
+        return _parse_probe_data(data)
+
+    except (subprocess.TimeoutExpired, json.JSONDecodeError, OSError):
+        return None
+
+
+def probe_buffer(
+    audio_bytes: bytes,
+    label: str = "audio",
+    config: Config | None = None,
+) -> AudioProbeResult | None:
+    """Probe audio bytes by writing to a temp file and running ffprobe.
+
+    Returns AudioProbeResult on success, None on failure.
+    """
+    if not audio_bytes:
+        return None
+
+    ffprobe_bin = get_ffprobe_path(config)
+    if not ffprobe_bin:
+        return None
+
+    tmp_name = None
+    try:
+        with tempfile.NamedTemporaryFile(
+            suffix=".raw", delete=False, prefix=f"deepctl_{label}_"
+        ) as tmp_file:
+            tmp_name = tmp_file.name
+            tmp_file.write(audio_bytes)
+
+        cmd = [
+            ffprobe_bin,
+            "-v",
+            "quiet",
+            "-print_format",
+            "json",
+            "-show_format",
+            "-show_streams",
+            tmp_name,
+        ]
+
+        result = subprocess.run(cmd, capture_output=True, text=True, timeout=10)
+
+        if result.returncode != 0:
+            return None
+
+        data = json.loads(result.stdout)
+        return _parse_probe_data(data)
+
+    except (subprocess.TimeoutExpired, json.JSONDecodeError, OSError):
+        return None
+    finally:
+        if tmp_name:
+            try:
+                os.unlink(tmp_name)
+            except OSError:
+                pass

deepctl_shared_utils-0.1.11/src/deepctl_shared_utils/ffprobe_models.py

@@ -0,0 +1,38 @@
+"""Pydantic models for ffprobe audio analysis results."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from pydantic import BaseModel, Field
+
+
+class AudioStreamInfo(BaseModel):
+    """Information about a single audio stream from ffprobe."""
+
+    codec_name: str | None = None
+    codec_long_name: str | None = None
+    sample_rate: str | None = None
+    channels: int | None = None
+    channel_layout: str | None = None
+    bit_rate: str | None = None
+    bits_per_sample: int | None = None
+    duration: float | None = None
+
+
+class AudioFormatInfo(BaseModel):
+    """Format-level information from ffprobe."""
+
+    format_name: str | None = None
+    format_long_name: str | None = None
+    duration: float | None = None
+    size: int | None = None
+    bit_rate: str | None = None
+
+
+class AudioProbeResult(BaseModel):
+    """Complete ffprobe analysis result."""
+
+    format: AudioFormatInfo | None = None
+    streams: list[AudioStreamInfo] = Field(default_factory=list)
+    raw_data: dict[str, Any] | None = None

{deepctl_shared_utils-0.1.10 → deepctl_shared_utils-0.1.11}/src/deepctl_shared_utils/validation.py

@@ -88,17 +88,14 @@ def validate_audio_file(file_path: str | Path) -> bool:
 
         # Check if file is readable
         if not os.access(path, os.R_OK):
-            console.print(
-                f"[red]Error:[/red] File is not readable: {file_path}"
-            )
+            console.print(f"[red]Error:[/red] File is not readable: {file_path}")
             return False
 
         # Check file size (warn if very large)
         size_mb = path.stat().st_size / (1024 * 1024)
         if size_mb > 500:  # 500 MB
             console.print(
-                f"[yellow]Warning:[/yellow] Large file detected "
-                f"({size_mb:.1f} MB)"
+                f"[yellow]Warning:[/yellow] Large file detected ({size_mb:.1f} MB)"
             )
             console.print("[dim]Large files may take longer to process[/dim]")
 
@@ -173,10 +170,19 @@ def _check_url_accessibility(url: str) -> bool:
         console.print("[dim]Checking URL accessibility...[/dim]")
 
         with httpx.Client(timeout=10.0) as client:
-            # Use HEAD request to check without downloading
+            # Try HEAD first; fall back to a ranged GET if the server
+            # doesn't support HEAD (some CDNs/redirect services return
+            # 404 or 405 for HEAD but serve GET fine).
             response = client.head(url, follow_redirects=True)
 
-            if response.status_code == 200:
+            if response.status_code not in range(200, 400):
+                response = client.get(
+                    url,
+                    follow_redirects=True,
+                    headers={"Range": "bytes=0-0"},
+                )
+
+            if response.status_code in (200, 206):
                 # Check content type if available
                 content_type = response.headers.get("content-type", "").lower()
                 if content_type and not any(
@@ -264,13 +270,10 @@ def validate_project_id(project_id: str) -> bool:
         return False
 
     # Check if it's a valid UUID format
-    uuid_pattern = (
-        r"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
-    )
+    uuid_pattern = r"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
     if not re.match(uuid_pattern, project_id, re.IGNORECASE):
         console.print(
-            "[yellow]Warning:[/yellow] Project ID doesn't match expected "
-            "UUID format"
+            "[yellow]Warning:[/yellow] Project ID doesn't match expected UUID format"
         )
         return False
 
@@ -336,8 +339,7 @@ def validate_language_code(language: str) -> bool:
 
     if language not in supported_languages:
         console.print(
-            f"[yellow]Warning:[/yellow] Language '{language}' may not be "
-            f"supported"
+            f"[yellow]Warning:[/yellow] Language '{language}' may not be supported"
         )
         console.print(
             "[dim]Common supported languages: en-US, es-ES, fr-FR, de-DE, "
@@ -387,9 +389,7 @@ def validate_model_name(model: str) -> bool:
     }
 
     if model not in supported_models:
-        console.print(
-            f"[yellow]Warning:[/yellow] Model '{model}' may not be supported"
-        )
+        console.print(f"[yellow]Warning:[/yellow] Model '{model}' may not be supported")
         console.print(
             "[dim]Common supported models: nova-2, nova, enhanced, base, "
             "meeting, phonecall[/dim]"
@@ -446,9 +446,7 @@ def validate_file_permissions(file_path: str | Path) -> bool:
 
         # Check read permission
         if not os.access(path, os.R_OK):
-            console.print(
-                f"[red]Error:[/red] No read permission for file: {file_path}"
-            )
+            console.print(f"[red]Error:[/red] No read permission for file: {file_path}")
             return False
 
         # Check if file is not empty
@@ -501,12 +499,9 @@ def validate_output_format(format_type: str) -> bool:
     supported_formats = {"json", "yaml", "table", "csv"}
 
     if format_type not in supported_formats:
+        console.print(f"[red]Error:[/red] Unsupported output format: {format_type}")
         console.print(
-            f"[red]Error:[/red] Unsupported output format: {format_type}"
-        )
-        console.print(
-            f"[dim]Supported formats: "
-            f"{', '.join(sorted(supported_formats))}[/dim]"
+            f"[dim]Supported formats: {', '.join(sorted(supported_formats))}[/dim]"
         )
         return False
 

deepctl_shared_utils-0.1.11/src/deepctl_shared_utils.egg-info/PKG-INFO

@@ -0,0 +1,60 @@
+Metadata-Version: 2.4
+Name: deepctl-shared-utils
+Version: 0.1.11
+Summary: Shared utilities for deepctl
+Author-email: Deepgram <devrel@deepgram.com>
+Maintainer-email: Deepgram <devrel@deepgram.com>
+License-Expression: MIT
+Keywords: deepgram,utilities,validation,helpers
+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: pydantic>=2.0.0
+Requires-Dist: click>=8.0.0
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: rich>=13.0.0
+
+# deepctl-shared-utils
+
+> Part of [deepctl](https://github.com/deepgram/cli) — Official Deepgram CLI
+
+Shared utilities for deepctl
+
+This package provides internal APIs for deepctl and its command packages. It is not intended for direct use.
+
+## 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
+```
+
+## Dependencies
+
+- `pydantic>=2.0.0`
+- `click>=8.0.0`
+- `httpx>=0.24.0`
+- `rich>=13.0.0`
+
+## License
+
+MIT — see [LICENSE](../../LICENSE)

{deepctl_shared_utils-0.1.10 → deepctl_shared_utils-0.1.11}/src/deepctl_shared_utils.egg-info/SOURCES.txt

@@ -1,6 +1,8 @@
 README.md
 pyproject.toml
 src/deepctl_shared_utils/__init__.py
+src/deepctl_shared_utils/ffprobe.py
+src/deepctl_shared_utils/ffprobe_models.py
 src/deepctl_shared_utils/models.py
 src/deepctl_shared_utils/py.typed
 src/deepctl_shared_utils/validation.py

{deepctl_shared_utils-0.1.10 → deepctl_shared_utils-0.1.11}/src/deepctl_shared_utils.egg-info/requires.txt

@@ -1,3 +1,4 @@
 pydantic>=2.0.0
 click>=8.0.0
 httpx>=0.24.0
+rich>=13.0.0

deepctl_shared_utils-0.1.10/PKG-INFO

@@ -1,23 +0,0 @@
-Metadata-Version: 2.4
-Name: deepctl-shared-utils
-Version: 0.1.10
-Summary: Shared utilities for deepctl
-Author-email: Deepgram <devrel@deepgram.com>
-Maintainer-email: Deepgram <devrel@deepgram.com>
-License-Expression: MIT
-Keywords: deepgram,utilities,validation,helpers
-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: pydantic>=2.0.0
-Requires-Dist: click>=8.0.0
-Requires-Dist: httpx>=0.24.0
-
-# deepctl-shared-utils
-
-Shared utilities for deepctl. This package is an internal component of deepctl and is not intended for standalone use.

deepctl_shared_utils-0.1.10/README.md

@@ -1,3 +0,0 @@
-# deepctl-shared-utils
-
-Shared utilities for deepctl. This package is an internal component of deepctl and is not intended for standalone use.

deepctl_shared_utils-0.1.10/src/deepctl_shared_utils/__init__.py

@@ -1,13 +0,0 @@
-"""Shared utilities for deepctl."""
-
-from .models import FileInfo
-from .validation import validate_audio_file, validate_date_format, validate_url
-
-__all__ = [
-    "FileInfo",
-    "validate_audio_file",
-    "validate_date_format",
-    "validate_url",
-]
-
-__version__ = "0.1.0"

deepctl_shared_utils-0.1.10/src/deepctl_shared_utils.egg-info/PKG-INFO

@@ -1,23 +0,0 @@
-Metadata-Version: 2.4
-Name: deepctl-shared-utils
-Version: 0.1.10
-Summary: Shared utilities for deepctl
-Author-email: Deepgram <devrel@deepgram.com>
-Maintainer-email: Deepgram <devrel@deepgram.com>
-License-Expression: MIT
-Keywords: deepgram,utilities,validation,helpers
-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: pydantic>=2.0.0
-Requires-Dist: click>=8.0.0
-Requires-Dist: httpx>=0.24.0
-
-# deepctl-shared-utils
-
-Shared utilities for deepctl. This package is an internal component of deepctl and is not intended for standalone use.