deepctl-cmd-speak 0.0.2__tar.gz

deepctl_cmd_speak-0.0.2/PKG-INFO

@@ -0,0 +1,63 @@
+Metadata-Version: 2.4
+Name: deepctl-cmd-speak
+Version: 0.0.2
+Summary: Speak (text-to-speech) command for deepctl
+Author-email: Deepgram <devrel@deepgram.com>
+Maintainer-email: Deepgram <devrel@deepgram.com>
+License-Expression: MIT
+Keywords: deepgram,cli,tts,text-to-speech,speak
+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: click>=8.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: pydantic>=2.0.0
+
+# deepctl-cmd-speak
+
+> Part of [deepctl](https://github.com/deepgram/cli) — Official Deepgram CLI
+
+Speak (text-to-speech) 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 speak` | `deepctl_cmd_speak.command:SpeakCommand` |
+
+## Dependencies
+
+- `click>=8.0.0`
+- `rich>=13.0.0`
+- `pydantic>=2.0.0`
+
+## License
+
+MIT — see [LICENSE](../../LICENSE)

deepctl_cmd_speak-0.0.2/README.md

@@ -0,0 +1,42 @@
+# deepctl-cmd-speak
+
+> Part of [deepctl](https://github.com/deepgram/cli) — Official Deepgram CLI
+
+Speak (text-to-speech) 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 speak` | `deepctl_cmd_speak.command:SpeakCommand` |
+
+## Dependencies
+
+- `click>=8.0.0`
+- `rich>=13.0.0`
+- `pydantic>=2.0.0`
+
+## License
+
+MIT — see [LICENSE](../../LICENSE)

deepctl_cmd_speak-0.0.2/pyproject.toml

@@ -0,0 +1,40 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "deepctl-cmd-speak"
+version = "0.0.2" # x-release-please-version
+description = "Speak (text-to-speech) command for deepctl"
+readme = "README.md"
+license = "MIT"
+authors = [{ name = "Deepgram", email = "devrel@deepgram.com" }]
+maintainers = [{ name = "Deepgram", email = "devrel@deepgram.com" }]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+keywords = ["deepgram", "cli", "tts", "text-to-speech", "speak"]
+requires-python = ">=3.10"
+dependencies = [
+    "deepctl-core>=0.1.10",
+    "click>=8.0.0",
+    "rich>=13.0.0",
+    "pydantic>=2.0.0",
+]
+
+[project.scripts]
+
+[project.entry-points."deepctl.commands"]
+speak = "deepctl_cmd_speak.command:SpeakCommand"
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["deepctl_cmd_speak*"]

deepctl_cmd_speak-0.0.2/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

deepctl_cmd_speak-0.0.2/src/deepctl_cmd_speak/__init__.py

@@ -0,0 +1 @@
+"""Speak (text-to-speech) command for deepctl."""

deepctl_cmd_speak-0.0.2/src/deepctl_cmd_speak/command.py

@@ -0,0 +1,185 @@
+"""Speak (text-to-speech) command for deepctl."""
+
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+from typing import Any
+
+from deepctl_core import (
+    AuthManager,
+    BaseCommand,
+    BaseResult,
+    Config,
+    DeepgramClient,
+)
+from rich.console import Console
+
+from .models import SpeakResult
+
+console = Console(stderr=True)
+
+
+class SpeakCommand(BaseCommand):
+    """Command for generating speech from text using Deepgram TTS."""
+
+    name = "speak"
+    help = "Convert text to speech using Deepgram TTS"
+    short_help = "Text-to-speech"
+
+    requires_auth = True
+    requires_project = False
+    ci_friendly = True
+
+    examples = [
+        'dg speak "Hello world"',
+        'dg speak "Hello world" -o hello.mp3',
+        "dg speak --file message.txt -o output.mp3",
+        'echo "Hello" | dg speak -o hello.mp3',
+        'dg speak "Hello" | ffplay -nodisp -',
+        'dg speak "Hello" -m aura-2-luna-en -o hello.wav --encoding linear16 --container wav',
+    ]
+    agent_help = (
+        "Convert text to speech using Deepgram's TTS API. "
+        "Text can be provided as an argument, from a file, or piped via stdin. "
+        "Audio is written to a file (--output) or stdout for piping. "
+        "Supports model selection and audio format options."
+    )
+
+    def get_arguments(self) -> list[dict[str, Any]]:
+        return [
+            {
+                "name": "text",
+                "help": "Text to convert to speech",
+                "required": False,
+                "default": None,
+            },
+            {
+                "names": ["--output", "-o"],
+                "help": "Output file path (required if stdout is a terminal)",
+                "type": str,
+                "is_option": True,
+            },
+            {
+                "names": ["--model", "-m"],
+                "help": "TTS model (default: aura-2-asteria-en)",
+                "type": str,
+                "is_option": True,
+                "default": "aura-2-asteria-en",
+            },
+            {
+                "names": ["--encoding"],
+                "help": "Audio encoding (mp3, linear16, flac, mulaw, alaw, opus, aac)",
+                "type": str,
+                "is_option": True,
+            },
+            {
+                "names": ["--container"],
+                "help": "Audio container (none, wav, ogg)",
+                "type": str,
+                "is_option": True,
+            },
+            {
+                "names": ["--sample-rate"],
+                "help": "Audio sample rate in Hz",
+                "type": float,
+                "is_option": True,
+            },
+            {
+                "names": ["--file", "-f"],
+                "help": "Read text from file",
+                "type": str,
+                "is_option": True,
+            },
+        ]
+
+    def handle(
+        self,
+        config: Config,
+        auth_manager: AuthManager,
+        client: DeepgramClient,
+        **kwargs: Any,
+    ) -> BaseResult:
+        text = kwargs.get("text")
+        output_path = kwargs.get("output")
+        model = kwargs.get("model") or "aura-2-asteria-en"
+        encoding = kwargs.get("encoding")
+        container = kwargs.get("container")
+        sample_rate = kwargs.get("sample_rate")
+        file_path = kwargs.get("file")
+
+        # Resolve text input: arg > --file > stdin
+        if not text and file_path:
+            path = Path(file_path)
+            if not path.exists():
+                return BaseResult(
+                    status="error", message=f"File not found: {file_path}"
+                )
+            text = path.read_text().strip()
+        elif not text and not sys.stdin.isatty():
+            text = sys.stdin.read().strip()
+
+        if not text:
+            return BaseResult(
+                status="error",
+                message="No text provided. Pass text as argument, use --file, or pipe via stdin.",
+            )
+
+        # If stdout is a TTY and no output file, require --output
+        stdout_is_tty = sys.stdout.isatty()
+        if not output_path and stdout_is_tty:
+            return BaseResult(
+                status="error",
+                message="No output specified. Use -o/--output to save to file, or pipe stdout.",
+            )
+
+        try:
+            console.print(f"[blue]Generating speech with {model}...[/blue]")
+
+            audio_iter = client.speak_text(
+                text=text,
+                model=model,
+                encoding=encoding,
+                container=container,
+                sample_rate=sample_rate,
+            )
+
+            total_bytes = 0
+
+            if output_path:
+                # Write to file
+                out = Path(output_path)
+                with open(out, "wb") as f:
+                    for chunk in audio_iter:
+                        f.write(chunk)
+                        total_bytes += len(chunk)
+
+                console.print(
+                    f"[green]Audio saved to {output_path}[/green] ({total_bytes:,} bytes)"
+                )
+
+                return SpeakResult(
+                    status="success",
+                    message=f"Audio saved to {output_path}",
+                    output_path=output_path,
+                    model=model,
+                    bytes_written=total_bytes,
+                )
+            else:
+                # Write to stdout (piping)
+                stdout_buffer = sys.stdout.buffer
+                for chunk in audio_iter:
+                    stdout_buffer.write(chunk)
+                    total_bytes += len(chunk)
+                stdout_buffer.flush()
+
+                return SpeakResult(
+                    status="success",
+                    message=f"Wrote {total_bytes:,} bytes to stdout",
+                    model=model,
+                    bytes_written=total_bytes,
+                )
+
+        except Exception as e:
+            console.print(f"[red]Error generating speech:[/red] {e}")
+            return BaseResult(status="error", message=str(e))

deepctl_cmd_speak-0.0.2/src/deepctl_cmd_speak/models.py

@@ -0,0 +1,11 @@
+"""Models for speak command."""
+
+from __future__ import annotations
+
+from deepctl_core import BaseResult
+
+
+class SpeakResult(BaseResult):
+    output_path: str = ""
+    model: str = ""
+    bytes_written: int = 0

deepctl_cmd_speak-0.0.2/src/deepctl_cmd_speak.egg-info/PKG-INFO

@@ -0,0 +1,63 @@
+Metadata-Version: 2.4
+Name: deepctl-cmd-speak
+Version: 0.0.2
+Summary: Speak (text-to-speech) command for deepctl
+Author-email: Deepgram <devrel@deepgram.com>
+Maintainer-email: Deepgram <devrel@deepgram.com>
+License-Expression: MIT
+Keywords: deepgram,cli,tts,text-to-speech,speak
+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: click>=8.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: pydantic>=2.0.0
+
+# deepctl-cmd-speak
+
+> Part of [deepctl](https://github.com/deepgram/cli) — Official Deepgram CLI
+
+Speak (text-to-speech) 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 speak` | `deepctl_cmd_speak.command:SpeakCommand` |
+
+## Dependencies
+
+- `click>=8.0.0`
+- `rich>=13.0.0`
+- `pydantic>=2.0.0`
+
+## License
+
+MIT — see [LICENSE](../../LICENSE)

deepctl_cmd_speak-0.0.2/src/deepctl_cmd_speak.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+src/deepctl_cmd_speak/__init__.py
+src/deepctl_cmd_speak/command.py
+src/deepctl_cmd_speak/models.py
+src/deepctl_cmd_speak.egg-info/PKG-INFO
+src/deepctl_cmd_speak.egg-info/SOURCES.txt
+src/deepctl_cmd_speak.egg-info/dependency_links.txt
+src/deepctl_cmd_speak.egg-info/entry_points.txt
+src/deepctl_cmd_speak.egg-info/requires.txt
+src/deepctl_cmd_speak.egg-info/top_level.txt

deepctl_cmd_speak-0.0.2/src/deepctl_cmd_speak.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

deepctl_cmd_speak-0.0.2/src/deepctl_cmd_speak.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[deepctl.commands]
+speak = deepctl_cmd_speak.command:SpeakCommand

deepctl_cmd_speak-0.0.2/src/deepctl_cmd_speak.egg-info/requires.txt

@@ -0,0 +1,4 @@
+deepctl-core>=0.1.10
+click>=8.0.0
+rich>=13.0.0
+pydantic>=2.0.0

deepctl_cmd_speak-0.0.2/src/deepctl_cmd_speak.egg-info/top_level.txt

@@ -0,0 +1 @@
+deepctl_cmd_speak