easymanet 0.1.0__tar.gz

easymanet-0.1.0/PKG-INFO

@@ -0,0 +1,59 @@
+Metadata-Version: 2.4
+Name: easymanet
+Version: 0.1.0
+Summary: Zero-touch OpenMANET provisioning and imaging
+Author: EasyMANET Contributors
+License-Expression: MIT
+Keywords: openmanet,mesh,provisioning,openwrt
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: System Administrators
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Topic :: System :: Installation/Setup
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: typer>=0.9
+Requires-Dist: pyyaml>=6
+Requires-Dist: rich>=13
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: setuptools>=68; extra == "dev"
+Requires-Dist: tomli>=2; extra == "dev"
+Requires-Dist: wheel; extra == "dev"
+
+# EasyMANET CLI
+
+Public installable CLI and automation surface for EasyMANET.
+
+This repository is generated from `the-Drunken-coder/easymanet`. Its job is to
+publish the command-line tool that validates fleet files, renders node
+provisioning payloads, lists disks, downloads or builds images, flashes media,
+and exposes diagnostics-friendly workflows for humans, scripts, and local AI
+agents.
+
+## Install From Source
+
+```bash
+python -m pip install -e ".[dev]"
+```
+
+## Common Commands
+
+```bash
+easymanet validate --config fleet.yml
+easymanet render --config fleet.yml --node point01
+easymanet disks
+easymanet flash --config fleet.yml --node point01 --device /dev/disk4 --base-image ./image.img.gz --dry-run
+```
+
+## Release Flow
+
+The tiny bootstrap workflow accepts an intentional `repository_dispatch` or
+manual trigger, then invokes the larger CLI release workflow. The release
+workflow runs tests, builds the wheel and source distribution, uploads them as
+artifacts, and creates a GitHub Release when a release tag is supplied.

easymanet-0.1.0/README.md

@@ -0,0 +1,31 @@
+# EasyMANET CLI
+
+Public installable CLI and automation surface for EasyMANET.
+
+This repository is generated from `the-Drunken-coder/easymanet`. Its job is to
+publish the command-line tool that validates fleet files, renders node
+provisioning payloads, lists disks, downloads or builds images, flashes media,
+and exposes diagnostics-friendly workflows for humans, scripts, and local AI
+agents.
+
+## Install From Source
+
+```bash
+python -m pip install -e ".[dev]"
+```
+
+## Common Commands
+
+```bash
+easymanet validate --config fleet.yml
+easymanet render --config fleet.yml --node point01
+easymanet disks
+easymanet flash --config fleet.yml --node point01 --device /dev/disk4 --base-image ./image.img.gz --dry-run
+```
+
+## Release Flow
+
+The tiny bootstrap workflow accepts an intentional `repository_dispatch` or
+manual trigger, then invokes the larger CLI release workflow. The release
+workflow runs tests, builds the wheel and source distribution, uploads them as
+artifacts, and creates a GitHub Release when a release tag is supplied.

easymanet-0.1.0/apps/cli/src/easymanet_cli/__init__.py

@@ -0,0 +1 @@
+"""Installable EasyMANET CLI surface."""

easymanet-0.1.0/apps/cli/src/easymanet_cli/app.py

@@ -0,0 +1,162 @@
+"""EasyMANET CLI — zero-touch OpenMANET provisioning and imaging.
+
+Commands:
+    easymanet disks                    List removable disks
+    easymanet validate --config FILE   Validate fleet config
+    easymanet render --config FILE     Render resolved provision.json
+    easymanet flash --config FILE ...  Flash an image and stage node config
+"""
+
+from typing import Optional
+
+import typer
+
+from easymanet.disks import list_disks
+from easymanet.manifest import ManifestError, load_manifest
+from easymanet.platform import check_platform
+from easymanet.render import render
+from easymanet.validate import validate
+from easymanet.workspace import (
+    ensure_workspace,
+    fleet_file_records,
+    fleets_dir,
+    resolve_fleet_config,
+    workspace_payload,
+)
+from easymanet_image.cli import register_image_commands
+
+from .common import print_errors_and_warnings
+from .flash import register_flash_command
+
+app = typer.Typer(
+    name="easymanet",
+    help="Zero-touch OpenMANET provisioning and imaging",
+    no_args_is_help=True,
+)
+image_app = typer.Typer(help="Manage image URLs, cache, and firmware builds")
+app.add_typer(image_app, name="image")
+
+register_flash_command(app)
+register_image_commands(image_app)
+
+
+@app.command(name="validate")
+def validate_cmd(
+    config: str = typer.Option(
+        ..., "--config", "-c", help="Path to fleet.yml config file"
+    ),
+    node: Optional[str] = typer.Option(
+        None, "--node", "-n", help="Validate a specific node"
+    ),
+):
+    """Validate a fleet.yml config file."""
+    config_path = resolve_fleet_config(config)
+    try:
+        manifest = load_manifest(str(config_path))
+    except ManifestError as e:
+        typer.secho(f"Error: {e}", fg=typer.colors.RED)
+        raise typer.Exit(1) from e
+
+    result = validate(manifest, node_name=node)
+    typer.secho(f"Validating: {config_path}", bold=True)
+    if node:
+        typer.secho(f"Selected node: {node}")
+
+    exit_code = print_errors_and_warnings(result)
+    raise typer.Exit(exit_code)
+
+
+@app.command(name="render")
+def render_cmd(
+    config: str = typer.Option(
+        ..., "--config", "-c", help="Path to fleet.yml config file"
+    ),
+    node: str = typer.Option(
+        ..., "--node", "-n", help="Node name to render resolved config for"
+    ),
+):
+    """Render the resolved provision.json for a node."""
+    config_path = resolve_fleet_config(config)
+    try:
+        manifest = load_manifest(str(config_path))
+    except ManifestError as e:
+        typer.secho(f"Error: {e}", fg=typer.colors.RED)
+        raise typer.Exit(1) from e
+
+    result = validate(manifest, node_name=node)
+    if result.errors:
+        typer.secho("Config has validation errors:", fg=typer.colors.RED)
+        for e in result.errors:
+            typer.secho(f"  ✗ {e}", fg=typer.colors.RED)
+        raise typer.Exit(1)
+
+    output = render(manifest, node)
+    print(output)
+
+
+@app.command(name="init")
+def init_cmd():
+    """Create the shared EasyMANET workspace in Documents."""
+    payload = workspace_payload()
+    typer.secho("EasyMANET workspace ready.", fg=typer.colors.GREEN)
+    typer.echo(f"  Root:        {payload['root']}")
+    typer.echo(f"  Fleets:      {payload['fleets_dir']}")
+    typer.echo(f"  Images:      {payload['images_dir']}")
+    typer.echo(f"  Diagnostics: {payload['diagnostics_dir']}")
+    typer.echo(f"  Builds:      {payload['builds_dir']}")
+
+
+@app.command(name="fleets")
+def fleets_cmd():
+    """List fleet files in the shared EasyMANET workspace."""
+    records = fleet_file_records()
+    typer.echo(f"Fleets folder: {fleets_dir()}")
+    if not records:
+        typer.secho("No fleet files found.", fg=typer.colors.YELLOW)
+        typer.echo("Add .yml or .yaml files to the Fleets folder above.")
+        return
+    for record in records:
+        typer.echo(f"  {record['relative_path']}")
+
+
+@app.command(name="disks")
+def disks_cmd(
+    all_disks: bool = typer.Option(
+        False,
+        "--all",
+        help="List every block device, not only removable/USB/MMC (Linux) or external (macOS)",
+    ),
+):
+    """List available disks for flashing."""
+    check_platform()
+    disks = list_disks(include_all=all_disks)
+
+    if not disks:
+        msg = "No disks found." if all_disks else "No removable/external disks found."
+        typer.secho(msg, fg=typer.colors.YELLOW)
+        if not all_disks:
+            typer.echo("Use --all to include every block device.")
+        return
+
+    for d in disks:
+        removable = "yes" if d.removable else "no"
+        mounted_str = ", ".join(d.mounted) if d.mounted else "(none)"
+        typer.echo(f"  {d.device}")
+        typer.echo(f"    Model:      {d.model}")
+        typer.echo(f"    Size:       {d.size_human}")
+        typer.echo(f"    Removable:  {removable}")
+        typer.echo(f"    Mounted:    {mounted_str}")
+
+        for w in d.warnings:
+            typer.secho(f"    {w}", fg=typer.colors.RED)
+
+        typer.echo()
+
+
+def main():
+    ensure_workspace()
+    app()
+
+
+if __name__ == "__main__":
+    main()

easymanet-0.1.0/apps/cli/src/easymanet_cli/common.py

@@ -0,0 +1,57 @@
+"""Shared CLI helpers."""
+
+import os
+import sys
+
+import typer
+
+from easymanet import __version__
+from easymanet.download import check_easymanet_update
+from easymanet.validate import ValidationResult
+
+
+def print_header(text: str) -> None:
+    typer.secho(text, bold=True)
+
+
+def maybe_show_update_notice() -> None:
+    if os.environ.get("EASYMANET_SKIP_UPDATE_CHECK", "").strip().lower() in {
+        "1",
+        "true",
+        "yes",
+    }:
+        return
+    update = check_easymanet_update()
+    if update:
+        typer.secho(
+            f"EasyMANET {update} is available (you have {__version__}). "
+            f"Run: {_upgrade_command()}",
+            fg=typer.colors.YELLOW,
+        )
+
+
+def _upgrade_command() -> str:
+    in_venv = bool(os.environ.get("VIRTUAL_ENV")) or (
+        getattr(sys, "base_prefix", sys.prefix) != sys.prefix
+    )
+    if in_venv:
+        return "pip3 install --upgrade easymanet"
+    return "pipx upgrade easymanet"
+
+
+def print_errors_and_warnings(result: ValidationResult) -> int:
+    exit_code = 0
+    if result.errors:
+        typer.secho(f"\n{len(result.errors)} error(s):", fg=typer.colors.RED)
+        for e in result.errors:
+            typer.secho(f"  ✗ {e}", fg=typer.colors.RED)
+        exit_code = 1
+    if result.warnings:
+        typer.secho(f"\n{len(result.warnings)} warning(s):", fg=typer.colors.YELLOW)
+        for w in result.warnings:
+            typer.secho(f"  ⚠ {w}", fg=typer.colors.YELLOW)
+    if result.valid and not result.warnings:
+        typer.secho("✓ Config is valid", fg=typer.colors.GREEN)
+    elif result.valid:
+        typer.secho("✓ Config is valid (with warnings)", fg=typer.colors.GREEN)
+    return exit_code