deepctl-cmd-read 0.0.2__tar.gz

deepctl_cmd_read-0.0.2/PKG-INFO

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

deepctl_cmd_read-0.0.2/README.md

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

deepctl_cmd_read-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-read"
+version = "0.0.2" # x-release-please-version
+description = "Read (text intelligence) 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", "text-intelligence", "nlp", "read"]
+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"]
+read = "deepctl_cmd_read.command:ReadCommand"
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["deepctl_cmd_read*"]

deepctl_cmd_read-0.0.2/setup.cfg

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

deepctl_cmd_read-0.0.2/src/deepctl_cmd_read/__init__.py

@@ -0,0 +1 @@
+"""Read (text intelligence) command for deepctl."""

deepctl_cmd_read-0.0.2/src/deepctl_cmd_read/command.py

@@ -0,0 +1,222 @@
+"""Read (text intelligence) 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 ReadResult
+
+console = Console()
+
+
+class ReadCommand(BaseCommand):
+    """Command for analyzing text using Deepgram's text intelligence."""
+
+    name = "read"
+    help = "Analyze text using Deepgram text intelligence"
+    short_help = "Text intelligence"
+
+    requires_auth = True
+    requires_project = False
+    ci_friendly = True
+
+    examples = [
+        'dg read "The product is amazing and works perfectly."',
+        "dg read --file article.txt --summarize",
+        'dg read --sentiment --topics --intents "Customer called about billing issue."',
+        "cat review.txt | dg read --sentiment --summarize",
+    ]
+    agent_help = (
+        "Analyze text using Deepgram's text intelligence API. "
+        "Supports sentiment analysis, summarization, topic detection, and intent recognition. "
+        "Text can be provided as an argument, from a file, or piped via stdin."
+    )
+
+    def get_arguments(self) -> list[dict[str, Any]]:
+        return [
+            {
+                "name": "text",
+                "help": "Text to analyze",
+                "required": False,
+                "default": None,
+            },
+            {
+                "names": ["--file", "-f"],
+                "help": "Read text from file",
+                "type": str,
+                "is_option": True,
+            },
+            {
+                "names": ["--sentiment"],
+                "help": "Analyze sentiment",
+                "is_flag": True,
+                "is_option": True,
+            },
+            {
+                "names": ["--summarize"],
+                "help": "Generate summary",
+                "is_flag": True,
+                "is_option": True,
+            },
+            {
+                "names": ["--topics"],
+                "help": "Detect topics",
+                "is_flag": True,
+                "is_option": True,
+            },
+            {
+                "names": ["--intents"],
+                "help": "Detect intents",
+                "is_flag": True,
+                "is_option": True,
+            },
+            {
+                "names": ["--language", "-l"],
+                "help": "Language code (e.g., en)",
+                "type": str,
+                "is_option": True,
+            },
+        ]
+
+    def handle(
+        self,
+        config: Config,
+        auth_manager: AuthManager,
+        client: DeepgramClient,
+        **kwargs: Any,
+    ) -> BaseResult:
+        text = kwargs.get("text")
+        file_path = kwargs.get("file")
+        sentiment = kwargs.get("sentiment", False)
+        summarize = kwargs.get("summarize", False)
+        topics = kwargs.get("topics", False)
+        intents = kwargs.get("intents", False)
+        language = kwargs.get("language")
+
+        # 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.",
+            )
+
+        # Default: enable all features if none specified
+        if not any([sentiment, summarize, topics, intents]):
+            sentiment = True
+            summarize = True
+            topics = True
+            intents = True
+
+        try:
+            console.print("[blue]Analyzing text...[/blue]")
+
+            result = client.analyze_text(
+                text=text,
+                sentiment=sentiment,
+                summarize=summarize,
+                topics=topics,
+                intents=intents,
+                language=language,
+            )
+
+            return self._display_results(result, sentiment, summarize, topics, intents)
+
+        except Exception as e:
+            console.print(f"[red]Error analyzing text:[/red] {e}")
+            return BaseResult(status="error", message=str(e))
+
+    def _display_results(
+        self,
+        result: dict[str, Any],
+        show_sentiment: bool,
+        show_summary: bool,
+        show_topics: bool,
+        show_intents: bool,
+    ) -> ReadResult:
+        results = result.get("results", {})
+        read_result = ReadResult(status="success")
+
+        # Summary
+        if show_summary:
+            summaries = results.get("summary", {})
+            summary_text = (
+                summaries.get("text", "") if isinstance(summaries, dict) else ""
+            )
+            if summary_text:
+                console.print("\n[green]Summary:[/green]")
+                console.print(f"  {summary_text}")
+                read_result.summary = summary_text
+
+        # Sentiment
+        if show_sentiment:
+            sentiments = results.get("sentiments", {})
+            if sentiments:
+                average = sentiments.get("average", {})
+                sentiment_val = average.get("sentiment", "")
+                sentiment_score = average.get("sentiment_score", 0.0)
+                console.print(
+                    f"\n[green]Sentiment:[/green] {sentiment_val} ({sentiment_score:.2f})"
+                )
+                read_result.sentiment = sentiment_val
+                read_result.sentiment_score = float(sentiment_score)
+
+        # Topics
+        if show_topics:
+            topics_data = results.get("topics", {})
+            segments = (
+                topics_data.get("segments", []) if isinstance(topics_data, dict) else []
+            )
+            if segments:
+                console.print("\n[green]Topics:[/green]")
+                seen_topics: set[str] = set()
+                for seg in segments:
+                    for topic in seg.get("topics", []):
+                        topic_name = topic.get("topic", "")
+                        if topic_name and topic_name not in seen_topics:
+                            seen_topics.add(topic_name)
+                            confidence = topic.get("confidence_score", 0.0)
+                            console.print(f"  • {topic_name} ({confidence:.0%})")
+                read_result.topics = segments
+
+        # Intents
+        if show_intents:
+            intents_data = results.get("intents", {})
+            segments = (
+                intents_data.get("segments", [])
+                if isinstance(intents_data, dict)
+                else []
+            )
+            if segments:
+                console.print("\n[green]Intents:[/green]")
+                seen_intents: set[str] = set()
+                for seg in segments:
+                    for intent in seg.get("intents", []):
+                        intent_name = intent.get("intent", "")
+                        if intent_name and intent_name not in seen_intents:
+                            seen_intents.add(intent_name)
+                            confidence = intent.get("confidence_score", 0.0)
+                            console.print(f"  • {intent_name} ({confidence:.0%})")
+                read_result.intents = segments
+
+        return read_result

deepctl_cmd_read-0.0.2/src/deepctl_cmd_read/models.py

@@ -0,0 +1,16 @@
+"""Models for read command."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from deepctl_core import BaseResult
+from pydantic import Field
+
+
+class ReadResult(BaseResult):
+    summary: str = ""
+    sentiment: str = ""
+    sentiment_score: float = 0.0
+    topics: list[dict[str, Any]] = Field(default_factory=list)
+    intents: list[dict[str, Any]] = Field(default_factory=list)

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

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

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

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

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1,2 @@
+[deepctl.commands]
+read = deepctl_cmd_read.command:ReadCommand

deepctl_cmd_read-0.0.2/src/deepctl_cmd_read.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_read-0.0.2/src/deepctl_cmd_read.egg-info/top_level.txt

@@ -0,0 +1 @@
+deepctl_cmd_read