eeroctl 1.7.1__py3-none-any.whl

eeroctl/__init__.py

@@ -0,0 +1,19 @@
+"""Command-line interface for Eero client.
+
+This package provides the CLI for managing Eero networks.
+
+Entry point: eeroctl.main:cli
+"""
+
+from .main import cli, main
+
+__version__ = "1.7.1"
+__version_info__ = tuple(int(x) for x in __version__.split(".")[:3])
+
+
+def get_version() -> str:
+    """Return the current version of eeroctl."""
+    return __version__
+
+
+__all__ = ["cli", "main", "__version__", "__version_info__", "get_version"]

eeroctl/commands/__init__.py

@@ -0,0 +1,32 @@
+"""New command structure for the Eero CLI.
+
+This package contains the new noun-first command tree:
+- auth: Authentication management
+- network: Network configuration and settings
+- eero: Mesh node management
+- device: Connected device management
+- profile: Profile/parental controls management
+- activity: Network activity data (Eero Plus)
+- troubleshoot: Diagnostics and troubleshooting
+- completion: Shell completion
+"""
+
+from .activity import activity_group
+from .auth import auth_group
+from .completion import completion_group
+from .device import device_group
+from .eero import eero_group
+from .network import network_group
+from .profile import profile_group
+from .troubleshoot import troubleshoot_group
+
+__all__ = [
+    "auth_group",
+    "network_group",
+    "eero_group",
+    "device_group",
+    "profile_group",
+    "activity_group",
+    "troubleshoot_group",
+    "completion_group",
+]

eeroctl/commands/activity.py

@@ -0,0 +1,237 @@
+"""Activity commands for the Eero CLI (Eero Plus feature).
+
+Commands:
+- eero activity summary: Network activity summary
+- eero activity clients: Per-client activity
+- eero activity history: Historical activity
+- eero activity categories: Activity by category
+"""
+
+import sys
+from typing import Optional
+
+import click
+from eero import EeroClient
+from rich.panel import Panel
+from rich.table import Table
+
+from ..context import ensure_cli_context
+from ..errors import is_premium_error
+from ..exit_codes import ExitCode
+from ..options import apply_options, network_option, output_option
+from ..utils import with_client
+
+
+def _format_bytes(bytes_val: int) -> str:
+    """Format bytes into human-readable format."""
+    if bytes_val < 1024:
+        return f"{bytes_val} B"
+    elif bytes_val < 1024 * 1024:
+        return f"{bytes_val / 1024:.1f} KB"
+    elif bytes_val < 1024 * 1024 * 1024:
+        return f"{bytes_val / (1024 * 1024):.1f} MB"
+    else:
+        return f"{bytes_val / (1024 * 1024 * 1024):.2f} GB"
+
+
+@click.group(name="activity")
+@click.pass_context
+def activity_group(ctx: click.Context) -> None:
+    """View network activity data (Eero Plus feature).
+
+    \b
+    Commands:
+      summary    - Network activity summary
+      clients    - Per-client activity
+      history    - Historical activity
+      categories - Activity by category
+
+    \b
+    Note: Requires an active Eero Plus subscription.
+
+    \b
+    Examples:
+      eero activity summary
+      eero activity clients
+      eero activity history --period week
+    """
+    ensure_cli_context(ctx)
+
+
+@activity_group.command(name="summary")
+@output_option
+@network_option
+@click.pass_context
+@with_client
+async def activity_summary(
+    ctx: click.Context, client: EeroClient, output: Optional[str], network_id: Optional[str]
+) -> None:
+    """Show network activity summary."""
+    cli_ctx = apply_options(ctx, output=output, network_id=network_id)
+    console = cli_ctx.console
+
+    with cli_ctx.status("Getting network activity..."):
+        try:
+            activity_data = await client.get_activity(cli_ctx.network_id)
+        except Exception as e:
+            if is_premium_error(e):
+                console.print("[yellow]This feature requires Eero Plus subscription[/yellow]")
+                sys.exit(ExitCode.PREMIUM_REQUIRED)
+            raise
+
+    if cli_ctx.is_structured_output():
+        cli_ctx.render_structured(activity_data, "eero.activity.summary/v1")
+    else:
+        upload = activity_data.get("upload_bytes", 0)
+        download = activity_data.get("download_bytes", 0)
+        total = upload + download
+
+        content = (
+            f"[bold cyan]Download:[/bold cyan] {_format_bytes(download)}\n"
+            f"[bold cyan]Upload:[/bold cyan] {_format_bytes(upload)}\n"
+            f"[bold cyan]Total:[/bold cyan] {_format_bytes(total)}"
+        )
+        console.print(Panel(content, title="Network Activity Summary", border_style="blue"))
+
+
+@activity_group.command(name="clients")
+@output_option
+@network_option
+@click.pass_context
+@with_client
+async def activity_clients(
+    ctx: click.Context, client: EeroClient, output: Optional[str], network_id: Optional[str]
+) -> None:
+    """Show per-client activity data."""
+    cli_ctx = apply_options(ctx, output=output, network_id=network_id)
+    console = cli_ctx.console
+
+    with cli_ctx.status("Getting client activity..."):
+        try:
+            clients_data = await client.get_activity_clients(cli_ctx.network_id)
+        except Exception as e:
+            if is_premium_error(e):
+                console.print("[yellow]This feature requires Eero Plus subscription[/yellow]")
+                sys.exit(ExitCode.PREMIUM_REQUIRED)
+            raise
+
+    if cli_ctx.is_structured_output():
+        cli_ctx.render_structured(clients_data, "eero.activity.clients/v1")
+    else:
+        if not clients_data:
+            console.print("[yellow]No client activity data available[/yellow]")
+            return
+
+        table = Table(title="Client Activity")
+        table.add_column("Device", style="cyan")
+        table.add_column("Download", justify="right")
+        table.add_column("Upload", justify="right")
+        table.add_column("Total", justify="right")
+
+        for client_info in clients_data:
+            name = (
+                client_info.get("display_name")
+                or client_info.get("hostname")
+                or client_info.get("mac", "Unknown")
+            )
+            download = client_info.get("download_bytes", 0)
+            upload = client_info.get("upload_bytes", 0)
+            total = download + upload
+
+            table.add_row(
+                name, _format_bytes(download), _format_bytes(upload), _format_bytes(total)
+            )
+
+        console.print(table)
+
+
+@activity_group.command(name="history")
+@click.option(
+    "--period",
+    type=click.Choice(["hour", "day", "week", "month"]),
+    default="day",
+    help="Time period (default: day)",
+)
+@output_option
+@network_option
+@click.pass_context
+@with_client
+async def activity_history(
+    ctx: click.Context,
+    client: EeroClient,
+    period: str,
+    output: Optional[str],
+    network_id: Optional[str],
+) -> None:
+    """Show historical activity data.
+
+    \b
+    Options:
+      --period  Time period: hour, day, week, month
+    """
+    cli_ctx = apply_options(ctx, output=output, network_id=network_id)
+    console = cli_ctx.console
+
+    with cli_ctx.status(f"Getting activity history ({period})..."):
+        try:
+            history_data = await client.get_activity_history(cli_ctx.network_id, period)
+        except Exception as e:
+            if is_premium_error(e):
+                console.print("[yellow]This feature requires Eero Plus subscription[/yellow]")
+                sys.exit(ExitCode.PREMIUM_REQUIRED)
+            raise
+
+    if cli_ctx.is_structured_output():
+        cli_ctx.render_structured(history_data, "eero.activity.history/v1")
+    else:
+        total_download = history_data.get("total_download_bytes", 0)
+        total_upload = history_data.get("total_upload_bytes", 0)
+        data_points = history_data.get("data_points", [])
+
+        content = (
+            f"[bold]Period:[/bold] {period}\n"
+            f"[bold cyan]Total Download:[/bold cyan] {_format_bytes(total_download)}\n"
+            f"[bold cyan]Total Upload:[/bold cyan] {_format_bytes(total_upload)}\n"
+            f"[bold]Data Points:[/bold] {len(data_points)}"
+        )
+        console.print(Panel(content, title=f"Activity History ({period})", border_style="blue"))
+
+
+@activity_group.command(name="categories")
+@output_option
+@network_option
+@click.pass_context
+@with_client
+async def activity_categories(
+    ctx: click.Context, client: EeroClient, output: Optional[str], network_id: Optional[str]
+) -> None:
+    """Show activity grouped by category."""
+    cli_ctx = apply_options(ctx, output=output, network_id=network_id)
+    console = cli_ctx.console
+
+    with cli_ctx.status("Getting activity categories..."):
+        try:
+            categories_data = await client.get_activity_categories(cli_ctx.network_id)
+        except Exception as e:
+            if is_premium_error(e):
+                console.print("[yellow]This feature requires Eero Plus subscription[/yellow]")
+                sys.exit(ExitCode.PREMIUM_REQUIRED)
+            raise
+
+    if cli_ctx.is_structured_output():
+        cli_ctx.render_structured(categories_data, "eero.activity.categories/v1")
+    else:
+        if not categories_data:
+            console.print("[yellow]No category data available[/yellow]")
+            return
+
+        table = Table(title="Activity by Category")
+        table.add_column("Category", style="cyan")
+        table.add_column("Usage", justify="right")
+
+        for category in categories_data:
+            name = category.get("name", "Unknown")
+            usage = category.get("bytes", 0)
+            table.add_row(name, _format_bytes(usage))
+
+        console.print(table)