eeroctl 1.1.1__tar.gz

eeroctl-1.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Eero CLI Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

eeroctl-1.1.1/PKG-INFO

@@ -0,0 +1,113 @@
+Metadata-Version: 2.4
+Name: eeroctl
+Version: 1.1.1
+Summary: Command-line interface for Eero network management
+Author: Eero CLI Contributors
+License: MIT
+Project-URL: Repository, https://github.com/fulviofreitas/eeroctl
+Project-URL: Issues, https://github.com/fulviofreitas/eeroctl/issues
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Home Automation
+Classifier: Topic :: System :: Networking
+Classifier: Environment :: Console
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: eero-api>=1.3.1
+Requires-Dist: rich>=13.0.0
+Requires-Dist: click>=8.0.0
+Requires-Dist: pyyaml>=6.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: isort>=5.12.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Dynamic: license-file
+
+# 🌐 eeroctl
+
+[![CI](https://github.com/fulviofreitas/eeroctl/actions/workflows/ci.yml/badge.svg)](https://github.com/fulviofreitas/eeroctl/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/eeroctl)](https://pypi.org/project/eeroctl/)
+[![Homebrew](https://img.shields.io/badge/homebrew-eeroctl-orange)](https://github.com/fulviofreitas/homebrew-eeroctl)
+
+> Manage your Eero mesh Wi-Fi from the terminal ✨
+
+## ⚡ Features
+
+- 🧭 **Intuitive commands** — noun-first structure (`eero network list`)
+- 📊 **Multiple formats** — table, JSON, YAML, text
+- 🛡️ **Safety rails** — confirmation for destructive actions
+- 🔧 **Script-friendly** — non-interactive mode + machine-readable output
+- 🐚 **Shell completion** — bash, zsh, fish
+
+## 📦 Install
+
+### Homebrew
+
+```bash
+brew install fulviofreitas/eeroctl/eeroctl
+```
+
+### PyPI
+
+```bash
+pip install eeroctl
+```
+
+<details>
+<summary>From source</summary>
+
+```bash
+git clone https://github.com/fulviofreitas/eeroctl.git
+cd eeroctl
+uv sync && source .venv/bin/activate
+```
+
+Or with pip:
+
+```bash
+python3 -m venv .venv && source .venv/bin/activate
+pip install -e .
+```
+
+</details>
+
+## 🚀 Quick Start
+
+```bash
+eero auth login           # Authenticate
+eero network list         # List networks
+eero device list          # Connected devices
+eero eero list            # Mesh nodes
+eero troubleshoot speedtest --force
+```
+
+## 📖 Documentation
+
+Full documentation lives in the **[Wiki](https://github.com/fulviofreitas/eeroctl/wiki)**:
+
+| 📚 Guide | Description |
+|----------|-------------|
+| [CLI Reference](https://github.com/fulviofreitas/eeroctl/wiki/CLI-Reference) | Commands, flags & exit codes |
+| [Usage Examples](https://github.com/fulviofreitas/eeroctl/wiki/Usage-Examples) | Practical examples |
+| [Configuration](https://github.com/fulviofreitas/eeroctl/wiki/Configuration) | Auth storage & env vars |
+| [Troubleshooting](https://github.com/fulviofreitas/eeroctl/wiki/Troubleshooting) | Common issues |
+
+## 🔗 Dependencies
+
+Built on [eero-api](https://github.com/fulviofreitas/eero-api) for API communication.
+
+## 📄 License
+
+MIT — see [LICENSE](LICENSE)

eeroctl-1.1.1/README.md

@@ -0,0 +1,76 @@
+# 🌐 eeroctl
+
+[![CI](https://github.com/fulviofreitas/eeroctl/actions/workflows/ci.yml/badge.svg)](https://github.com/fulviofreitas/eeroctl/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/eeroctl)](https://pypi.org/project/eeroctl/)
+[![Homebrew](https://img.shields.io/badge/homebrew-eeroctl-orange)](https://github.com/fulviofreitas/homebrew-eeroctl)
+
+> Manage your Eero mesh Wi-Fi from the terminal ✨
+
+## ⚡ Features
+
+- 🧭 **Intuitive commands** — noun-first structure (`eero network list`)
+- 📊 **Multiple formats** — table, JSON, YAML, text
+- 🛡️ **Safety rails** — confirmation for destructive actions
+- 🔧 **Script-friendly** — non-interactive mode + machine-readable output
+- 🐚 **Shell completion** — bash, zsh, fish
+
+## 📦 Install
+
+### Homebrew
+
+```bash
+brew install fulviofreitas/eeroctl/eeroctl
+```
+
+### PyPI
+
+```bash
+pip install eeroctl
+```
+
+<details>
+<summary>From source</summary>
+
+```bash
+git clone https://github.com/fulviofreitas/eeroctl.git
+cd eeroctl
+uv sync && source .venv/bin/activate
+```
+
+Or with pip:
+
+```bash
+python3 -m venv .venv && source .venv/bin/activate
+pip install -e .
+```
+
+</details>
+
+## 🚀 Quick Start
+
+```bash
+eero auth login           # Authenticate
+eero network list         # List networks
+eero device list          # Connected devices
+eero eero list            # Mesh nodes
+eero troubleshoot speedtest --force
+```
+
+## 📖 Documentation
+
+Full documentation lives in the **[Wiki](https://github.com/fulviofreitas/eeroctl/wiki)**:
+
+| 📚 Guide | Description |
+|----------|-------------|
+| [CLI Reference](https://github.com/fulviofreitas/eeroctl/wiki/CLI-Reference) | Commands, flags & exit codes |
+| [Usage Examples](https://github.com/fulviofreitas/eeroctl/wiki/Usage-Examples) | Practical examples |
+| [Configuration](https://github.com/fulviofreitas/eeroctl/wiki/Configuration) | Auth storage & env vars |
+| [Troubleshooting](https://github.com/fulviofreitas/eeroctl/wiki/Troubleshooting) | Common issues |
+
+## 🔗 Dependencies
+
+Built on [eero-api](https://github.com/fulviofreitas/eero-api) for API communication.
+
+## 📄 License
+
+MIT — see [LICENSE](LICENSE)

eeroctl-1.1.1/pyproject.toml

@@ -0,0 +1,105 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "eeroctl"
+version = "1.1.1"
+description = "Command-line interface for Eero network management"
+readme = "README.md"
+requires-python = ">=3.12"
+license = {text = "MIT"}
+authors = [
+    {name = "Eero CLI Contributors"},
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: End Users/Desktop",
+    "Intended Audience :: System Administrators",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Home Automation",
+    "Topic :: System :: Networking",
+    "Environment :: Console",
+    "Typing :: Typed",
+]
+dependencies = [
+    "eero-api>=1.3.1",
+    "rich>=13.0.0",
+    "click>=8.0.0",
+    "pyyaml>=6.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "pytest-cov>=4.0.0",
+    "black>=23.0.0",
+    "isort>=5.12.0",
+    "mypy>=1.0.0",
+    "ruff>=0.1.0",
+]
+
+[project.urls]
+Repository = "https://github.com/fulviofreitas/eeroctl"
+Issues = "https://github.com/fulviofreitas/eeroctl/issues"
+
+[project.scripts]
+eero = "eeroctl.main:cli"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.black]
+line-length = 100
+target-version = ["py312"]
+
+[tool.isort]
+profile = "black"
+line_length = 100
+
+[tool.mypy]
+python_version = "3.12"
+warn_return_any = false
+warn_unused_configs = true
+ignore_missing_imports = true
+check_untyped_defs = false
+disallow_untyped_defs = false
+no_implicit_optional = false
+
+[tool.ruff]
+line-length = 100
+target-version = "py312"
+
+[tool.ruff.lint]
+select = ["E", "F", "B", "W", "I"]
+ignore = [
+    "E501",  # Line too long - handled by black
+    "B904",  # raise-without-from-inside-except - existing code pattern
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+
+# =============================================================================
+# Bandit Security Scanner Configuration
+# =============================================================================
+# Bandit is a tool designed to find common security issues in Python code.
+# https://bandit.readthedocs.io/
+# =============================================================================
+[tool.bandit]
+# Directories to scan
+targets = ["src"]
+# Exclude test files from security scanning
+exclude_dirs = ["tests", ".venv", "build", "dist"]
+# Skip specific tests if needed (uncomment to skip)
+# skips = ["B101"]  # Example: skip assert_used checks
+# Confidence level: LOW, MEDIUM, HIGH
+# confidence_level = "MEDIUM"
+# Severity level: LOW, MEDIUM, HIGH  
+# severity_level = "MEDIUM"

eeroctl-1.1.1/setup.cfg

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

eeroctl-1.1.1/src/eero_cli/__init__.py

@@ -0,0 +1,11 @@
+"""Command-line interface for Eero client.
+
+This package provides the CLI for managing Eero networks.
+
+Entry point: eero_cli.main:cli
+"""
+
+from .main import cli, main
+
+__version__ = "1.2.2"
+__all__ = ["cli", "main", "__version__"]

eeroctl-1.1.1/src/eero_cli/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-1.1.1/src/eero_cli/commands/activity.py

@@ -0,0 +1,215 @@
+"""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
+
+import click
+from eero import EeroClient
+from rich.panel import Panel
+from rich.table import Table
+
+from ..context import ensure_cli_context, get_cli_context
+from ..errors import is_premium_error
+from ..exit_codes import ExitCode
+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")
+@click.pass_context
+@with_client
+async def activity_summary(ctx: click.Context, client: EeroClient) -> None:
+    """Show network activity summary."""
+    cli_ctx = get_cli_context(ctx)
+    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")
+@click.pass_context
+@with_client
+async def activity_clients(ctx: click.Context, client: EeroClient) -> None:
+    """Show per-client activity data."""
+    cli_ctx = get_cli_context(ctx)
+    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)",
+)
+@click.pass_context
+@with_client
+async def activity_history(ctx: click.Context, client: EeroClient, period: str) -> None:
+    """Show historical activity data.
+
+    \b
+    Options:
+      --period  Time period: hour, day, week, month
+    """
+    cli_ctx = get_cli_context(ctx)
+    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")
+@click.pass_context
+@with_client
+async def activity_categories(ctx: click.Context, client: EeroClient) -> None:
+    """Show activity grouped by category."""
+    cli_ctx = get_cli_context(ctx)
+    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)