deepctl-cmd-usage 0.1.10__tar.gz → 0.1.12__tar.gz

{deepctl_cmd_usage-0.1.10 → deepctl_cmd_usage-0.1.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepctl-cmd-usage
-Version: 0.1.10
+Version: 0.1.12
 Summary: Usage command for deepctl
 Author-email: Deepgram <devrel@deepgram.com>
 Maintainer-email: Deepgram <devrel@deepgram.com>
@@ -18,9 +18,49 @@ 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: deepgram-sdk>=3.0.0
+Requires-Dist: deepgram-sdk>=7.5.0
 Requires-Dist: pydantic>=2.0.0
 
 # deepctl-cmd-usage
 
-Usage command for deepctl. This package is an internal component of deepctl and is not intended for standalone use.
+> Part of [deepctl](https://github.com/deepgram/cli) — Official Deepgram CLI
+
+Usage 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 usage` | `deepctl_cmd_usage.command:UsageCommand` |
+
+## Dependencies
+
+- `click>=8.0.0`
+- `rich>=13.0.0`
+- `deepgram-sdk>=6.0.0rc2`
+- `pydantic>=2.0.0`
+
+## License
+
+MIT — see [LICENSE](../../LICENSE)

deepctl_cmd_usage-0.1.12/README.md

@@ -0,0 +1,43 @@
+# deepctl-cmd-usage
+
+> Part of [deepctl](https://github.com/deepgram/cli) — Official Deepgram CLI
+
+Usage 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 usage` | `deepctl_cmd_usage.command:UsageCommand` |
+
+## Dependencies
+
+- `click>=8.0.0`
+- `rich>=13.0.0`
+- `deepgram-sdk>=6.0.0rc2`
+- `pydantic>=2.0.0`
+
+## License
+
+MIT — see [LICENSE](../../LICENSE)

{deepctl_cmd_usage-0.1.10 → deepctl_cmd_usage-0.1.12}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "deepctl-cmd-usage"
-version = "0.1.10"
+version = "0.1.12" # x-release-please-version
 description = "Usage command for deepctl"
 readme = "README.md"
 license = "MIT"
@@ -25,7 +25,7 @@ dependencies = [
     "deepctl-shared-utils>=0.1.10",
     "click>=8.0.0",
     "rich>=13.0.0",
-    "deepgram-sdk>=3.0.0",
+    "deepgram-sdk>=7.5.0",
     "pydantic>=2.0.0",
 ]
 

{deepctl_cmd_usage-0.1.10 → deepctl_cmd_usage-0.1.12}/src/deepctl_cmd_usage/command.py

@@ -30,6 +30,17 @@ class UsageCommand(BaseCommand):
     requires_project = True
     ci_friendly = True
 
+    examples = [
+        "dg usage",
+        "dg usage --days 30",
+        "dg usage --start 2025-01-01 --end 2025-01-31",
+    ]
+    agent_help = (
+        "View Deepgram API usage statistics for the current project. "
+        "Shows request counts and audio hours over a configurable date range. "
+        "Requires authentication and a project ID."
+    )
+
     def get_arguments(self) -> list[dict[str, Any]]:
         """Get command arguments and options."""
         return [
@@ -103,9 +114,7 @@ class UsageCommand(BaseCommand):
                 console.print("[blue]Fetching usage for last month...[/blue]")
             elif current_month:
                 start_date, end_date = self._get_current_month_range()
-                console.print(
-                    "[blue]Fetching usage for current month...[/blue]"
-                )
+                console.print("[blue]Fetching usage for current month...[/blue]")
             elif start_date or end_date:
                 # Validate custom date range
                 if start_date and not validate_date_format(start_date):
@@ -127,9 +136,7 @@ class UsageCommand(BaseCommand):
             else:
                 # Default to current month
                 start_date, end_date = self._get_current_month_range()
-                console.print(
-                    "[blue]Fetching usage for current month...[/blue]"
-                )
+                console.print("[blue]Fetching usage for current month...[/blue]")
 
             # Get usage data
             result = client.get_usage(project_id, start_date, end_date)
@@ -182,19 +189,11 @@ class UsageCommand(BaseCommand):
                 # For SDK response objects, we need to access attributes
                 # directly
                 result_dict = {
-                    "results": (
-                        result.results if hasattr(result, "results") else []
-                    ),
-                    "start": (
-                        result.start
-                        if hasattr(result, "start")
-                        else start_date
-                    ),
+                    "results": (result.results if hasattr(result, "results") else []),
+                    "start": (result.start if hasattr(result, "start") else start_date),
                     "end": result.end if hasattr(result, "end") else end_date,
                     "project_id": (
-                        result.project_id
-                        if hasattr(result, "project_id")
-                        else ""
+                        result.project_id if hasattr(result, "project_id") else ""
                     ),
                 }
             else:
@@ -236,16 +235,13 @@ class UsageCommand(BaseCommand):
 
                 # Display summary
                 console.print(
-                    f"\n[green]Usage Summary ({start_date} to "
-                    f"{end_date}):[/green]"
+                    f"\n[green]Usage Summary ({start_date} to {end_date}):[/green]"
                 )
                 console.print(f"  Total Hours: {total_hours:,.1f}")
                 console.print(f"  Total Requests: {total_requests:,}")
 
                 if total_tts_characters > 0:
-                    console.print(
-                        f"  TTS Characters: {total_tts_characters:,}"
-                    )
+                    console.print(f"  TTS Characters: {total_tts_characters:,}")
 
                 if total_tokens_out > 0:
                     console.print(f"  Tokens Out: {total_tokens_out:,}")
@@ -268,17 +264,12 @@ class UsageCommand(BaseCommand):
                                 f"{item['tts'].get('characters', 0):,}"
                             )
                             console.print(
-                                f"    TTS Requests: "
-                                f"{item['tts'].get('requests', 0):,}"
+                                f"    TTS Requests: {item['tts'].get('requests', 0):,}"
                             )
 
-                        if (
-                            "tokens" in item
-                            and item["tokens"].get("out", 0) > 0
-                        ):
+                        if "tokens" in item and item["tokens"].get("out", 0) > 0:
                             console.print(
-                                f"    Tokens Out: "
-                                f"{item['tokens'].get('out', 0):,}"
+                                f"    Tokens Out: {item['tokens'].get('out', 0):,}"
                             )
 
                 project_id = result_dict.get("project_id", "")
@@ -290,8 +281,7 @@ class UsageCommand(BaseCommand):
                 )
             else:
                 console.print(
-                    "[yellow]No usage data found for the specified "
-                    "period[/yellow]"
+                    "[yellow]No usage data found for the specified period[/yellow]"
                 )
                 return BaseResult(status="info", message="No usage data found")
 
@@ -315,9 +305,7 @@ class UsageCommand(BaseCommand):
         self, usage_data: dict[str, Any], start_date: str, end_date: str
     ) -> None:
         """Display usage summary."""
-        console.print(
-            f"\n[green]Usage Summary ({start_date} to " f"{end_date}):[/green]"
-        )
+        console.print(f"\n[green]Usage Summary ({start_date} to {end_date}):[/green]")
 
         # Try to extract common usage metrics
         total_requests = usage_data.get("requests", 0)
@@ -331,8 +319,7 @@ class UsageCommand(BaseCommand):
             if isinstance(total_duration, int | float):
                 hours = total_duration / 3600
                 console.print(
-                    f"  Total Duration: {hours:.2f} hours "
-                    f"({total_duration:,} seconds)"
+                    f"  Total Duration: {hours:.2f} hours ({total_duration:,} seconds)"
                 )
             else:
                 console.print(f"  Total Duration: {total_duration}")
@@ -350,13 +337,9 @@ class UsageCommand(BaseCommand):
                 "breakdown",
             ]:
                 if isinstance(value, int | float):
-                    console.print(
-                        f"  {key.replace('_', ' ').title()}: " f"{value:,}"
-                    )
+                    console.print(f"  {key.replace('_', ' ').title()}: {value:,}")
                 else:
-                    console.print(
-                        f"  {key.replace('_', ' ').title()}: {value}"
-                    )
+                    console.print(f"  {key.replace('_', ' ').title()}: {value}")
 
     def _display_usage_details(self, usage_data: dict[str, Any]) -> None:
         """Display detailed usage breakdown."""
@@ -373,8 +356,7 @@ class UsageCommand(BaseCommand):
                     for key, value in data.items():
                         if isinstance(value, int | float):
                             console.print(
-                                f"    {key.replace('_', ' ').title()}: "
-                                f"{value:,}"
+                                f"    {key.replace('_', ' ').title()}: {value:,}"
                             )
                         else:
                             console.print(

{deepctl_cmd_usage-0.1.10 → deepctl_cmd_usage-0.1.12}/src/deepctl_cmd_usage.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepctl-cmd-usage
-Version: 0.1.10
+Version: 0.1.12
 Summary: Usage command for deepctl
 Author-email: Deepgram <devrel@deepgram.com>
 Maintainer-email: Deepgram <devrel@deepgram.com>
@@ -18,9 +18,49 @@ 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: deepgram-sdk>=3.0.0
+Requires-Dist: deepgram-sdk>=7.5.0
 Requires-Dist: pydantic>=2.0.0
 
 # deepctl-cmd-usage
 
-Usage command for deepctl. This package is an internal component of deepctl and is not intended for standalone use.
+> Part of [deepctl](https://github.com/deepgram/cli) — Official Deepgram CLI
+
+Usage 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 usage` | `deepctl_cmd_usage.command:UsageCommand` |
+
+## Dependencies
+
+- `click>=8.0.0`
+- `rich>=13.0.0`
+- `deepgram-sdk>=6.0.0rc2`
+- `pydantic>=2.0.0`
+
+## License
+
+MIT — see [LICENSE](../../LICENSE)

{deepctl_cmd_usage-0.1.10 → deepctl_cmd_usage-0.1.12}/src/deepctl_cmd_usage.egg-info/requires.txt

@@ -2,5 +2,5 @@ deepctl-core>=0.1.10
 deepctl-shared-utils>=0.1.10
 click>=8.0.0
 rich>=13.0.0
-deepgram-sdk>=3.0.0
+deepgram-sdk>=7.5.0
 pydantic>=2.0.0

deepctl_cmd_usage-0.1.10/README.md

@@ -1,3 +0,0 @@
-# deepctl-cmd-usage
-
-Usage command for deepctl. This package is an internal component of deepctl and is not intended for standalone use.