deepctl-cmd-billing 0.0.2__tar.gz

deepctl_cmd_billing-0.0.2/PKG-INFO

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

deepctl_cmd_billing-0.0.2/README.md

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

deepctl_cmd_billing-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-billing"
+version = "0.0.2" # x-release-please-version
+description = "Billing 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", "billing", "usage"]
+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"]
+billing = "deepctl_cmd_billing.command:BillingCommand"
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["deepctl_cmd_billing*"]

deepctl_cmd_billing-0.0.2/setup.cfg

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

deepctl_cmd_billing-0.0.2/src/deepctl_cmd_billing/__init__.py

@@ -0,0 +1 @@
+"""Billing command for deepctl."""

deepctl_cmd_billing-0.0.2/src/deepctl_cmd_billing/command.py

@@ -0,0 +1,210 @@
+"""Billing command for deepctl."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from deepctl_core import (
+    AuthManager,
+    BaseCommand,
+    BaseResult,
+    Config,
+    DeepgramClient,
+)
+from rich.console import Console
+from rich.table import Table
+
+from .models import BalanceInfo, BillingResult
+
+console = Console()
+
+
+class BillingCommand(BaseCommand):
+    """Command for viewing billing information."""
+
+    name = "billing"
+    help = "View Deepgram billing and balances"
+    short_help = "Billing info"
+
+    requires_auth = True
+    requires_project = True
+    ci_friendly = True
+
+    examples = [
+        "dg billing",
+        "dg billing --balances",
+        "dg billing --breakdown --start 2025-01-01 --end 2025-01-31",
+        "dg billing --breakdown --grouping tags",
+    ]
+    agent_help = (
+        "View billing breakdown and account balances for the current project. "
+        "Requires authentication and a project ID."
+    )
+
+    def get_arguments(self) -> list[dict[str, Any]]:
+        return [
+            {
+                "names": ["--balances", "-b"],
+                "help": "Show account balances",
+                "is_flag": True,
+                "is_option": True,
+            },
+            {
+                "names": ["--breakdown"],
+                "help": "Show billing breakdown",
+                "is_flag": True,
+                "is_option": True,
+            },
+            {
+                "names": ["--start"],
+                "help": "Start date for breakdown (YYYY-MM-DD)",
+                "type": str,
+                "is_option": True,
+            },
+            {
+                "names": ["--end"],
+                "help": "End date for breakdown (YYYY-MM-DD)",
+                "type": str,
+                "is_option": True,
+            },
+            {
+                "names": ["--grouping"],
+                "help": "Grouping for breakdown (accessor, deployment, line_item, tags)",
+                "type": str,
+                "is_option": True,
+            },
+            {
+                "names": ["--project-id", "-p"],
+                "help": "Project ID (uses configured project if not provided)",
+                "type": str,
+                "is_option": True,
+            },
+        ]
+
+    def handle(
+        self,
+        config: Config,
+        auth_manager: AuthManager,
+        client: DeepgramClient,
+        **kwargs: Any,
+    ) -> BaseResult:
+        show_balances = kwargs.get("balances", False)
+        show_breakdown = kwargs.get("breakdown", False)
+        project_id = kwargs.get("project_id")
+
+        try:
+            # Default: show both balances and breakdown
+            if not show_balances and not show_breakdown:
+                show_balances = True
+                show_breakdown = True
+
+            result = BillingResult(status="success")
+
+            if show_balances:
+                self._show_balances(client, project_id, result)
+
+            if show_breakdown:
+                self._show_breakdown(
+                    client,
+                    project_id,
+                    result,
+                    start=kwargs.get("start"),
+                    end=kwargs.get("end"),
+                    grouping=kwargs.get("grouping"),
+                )
+
+            return result
+
+        except Exception as e:
+            console.print(f"[red]Error:[/red] {e}")
+            return BaseResult(status="error", message=str(e))
+
+    def _show_balances(
+        self,
+        client: DeepgramClient,
+        project_id: str | None,
+        result: BillingResult,
+    ) -> None:
+        console.print("[blue]Fetching balances...[/blue]")
+        data = client.get_balances(project_id=project_id)
+
+        balances_raw = data.get("balances", [])
+        if not balances_raw:
+            console.print("[yellow]No balances found[/yellow]")
+            return
+
+        table = Table(
+            title="Account Balances", show_header=True, header_style="bold blue"
+        )
+        table.add_column("Balance ID", style="dim")
+        table.add_column("Amount", justify="right", style="green")
+        table.add_column("Units")
+
+        for b in balances_raw:
+            b_data = (
+                b
+                if isinstance(b, dict)
+                else (b.__dict__ if hasattr(b, "__dict__") else {})
+            )
+            info = BalanceInfo(
+                balance_id=b_data.get("balance_id", ""),
+                amount=float(b_data.get("amount", 0)),
+                units=b_data.get("units", ""),
+            )
+            result.balances.append(info)
+            table.add_row(info.balance_id, f"{info.amount:,.2f}", info.units)
+
+        console.print(table)
+
+    def _show_breakdown(
+        self,
+        client: DeepgramClient,
+        project_id: str | None,
+        result: BillingResult,
+        start: str | None = None,
+        end: str | None = None,
+        grouping: str | None = None,
+    ) -> None:
+
+        console.print("[blue]Fetching billing breakdown...[/blue]")
+        data = client.get_billing_breakdown(
+            project_id=project_id,
+            start=start,
+            end=end,
+            grouping=grouping,
+        )
+
+        result.breakdown = data
+
+        # Display breakdown summary
+        resolution = data.get("resolution", {})
+        if resolution:
+            period = resolution.get("period", "")
+            amount = resolution.get("amount", 0)
+            if period:
+                console.print(
+                    f"\n[green]Billing Period:[/green] {period} ({amount} units)"
+                )
+
+        results = data.get("results", [])
+        if results:
+            table = Table(
+                title="Billing Breakdown", show_header=True, header_style="bold blue"
+            )
+            table.add_column("Period")
+            table.add_column("Amount", justify="right", style="green")
+            table.add_column("Units")
+
+            for item in results:
+                item_data = item if isinstance(item, dict) else {}
+                table.add_row(
+                    str(item_data.get("start", "-")),
+                    f"{item_data.get('amount', 0):,.2f}",
+                    str(item_data.get("units", "")),
+                )
+
+            console.print(table)
+        else:
+            console.print(
+                "[dim]No breakdown data available for the specified period[/dim]"
+            )

deepctl_cmd_billing-0.0.2/src/deepctl_cmd_billing/models.py

@@ -0,0 +1,19 @@
+"""Models for billing command."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from deepctl_core import BaseResult
+from pydantic import BaseModel, Field
+
+
+class BalanceInfo(BaseModel):
+    balance_id: str = ""
+    amount: float = 0.0
+    units: str = ""
+
+
+class BillingResult(BaseResult):
+    balances: list[BalanceInfo] = Field(default_factory=list)
+    breakdown: dict[str, Any] = Field(default_factory=dict)

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

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

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

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

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1,2 @@
+[deepctl.commands]
+billing = deepctl_cmd_billing.command:BillingCommand

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

@@ -0,0 +1 @@
+deepctl_cmd_billing