redeploy 0.1.6__tar.gz → 0.2.4__tar.gz

{redeploy-0.1.6 → redeploy-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: redeploy
-Version: 0.1.6
+Version: 0.2.4
 Summary: Infrastructure migration toolkit: detect → plan → apply
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
@@ -26,17 +26,17 @@ Requires-Dist: pfix>=0.1.60; extra == "dev"
 
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.1.6-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
-![AI Cost](https://img.shields.io/badge/AI%20Cost-$1.95-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-3.3h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.2.4-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![AI Cost](https://img.shields.io/badge/AI%20Cost-$3.30-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-5.3h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $1.9500 (13 commits)
-- 👤 **Human dev:** ~$333 (3.3h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $3.3000 (22 commits)
+- 👤 **Human dev:** ~$533 (5.3h @ $100/h, 30min dedup)
 
 Generated on 2026-04-20 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
 
 ---
 
-![PyPI](https://img.shields.io/badge/pypi-redeploy-blue) ![Version](https://img.shields.io/badge/version-0.1.6-blue) ![Python](https://img.shields.io/badge/python-3.10+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![PyPI](https://img.shields.io/badge/pypi-redeploy-blue) ![Version](https://img.shields.io/badge/version-0.2.4-blue) ![Python](https://img.shields.io/badge/python-3.10+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
 
 Infrastructure migration and device deploy toolkit — VPS, Raspberry Pi kiosk, Podman Quadlet, k3s.
 
@@ -162,8 +162,15 @@ Execute deploy from a YAML spec file (or `redeploy.yaml` project manifest if no
 | `--plan-only` | Show steps without connecting via SSH |
 | `--dry-run` | Connect, show steps, make no changes |
 | `--detect` | Live-probe host before planning (recommended for prod) |
+| `--env NAME` | Use named environment from `redeploy.yaml` (e.g. `prod`, `rpi5`) |
 | `--plan-out FILE` | Save generated plan to file |
 
+```bash
+redeploy run --env prod             # use prod env from redeploy.yaml
+redeploy run --env rpi5 --detect    # deploy to rpi5 with live probe
+redeploy run --dry-run              # uses .env DEPLOY_* vars if no redeploy.yaml
+```
+
 ### `redeploy scan [options]`
 
 Discover SSH-accessible devices on the local network.
@@ -327,6 +334,11 @@ extra_steps:
 | `version_check` | `version_check` | Verify deployed version |
 | `sync_env` | `scp` | Copy .env to remote |
 | `podman_daemon_reload` | `systemctl_start` | `systemctl --user daemon-reload` |
+| `stop_podman` | `systemctl_stop` | Stop all Podman containers via systemd |
+| `enable_podman_unit` | `systemctl_start` | `systemctl daemon-reload && enable --now {service}.service` |
+| `systemctl_restart` | `systemctl_start` | Restart a systemd service (`command=` to override) |
+| `systemctl_daemon_reload` | `ssh_cmd` | `systemctl daemon-reload` |
+| `git_pull` | `ssh_cmd` | `git pull --ff-only` with rollback (`git reset --hard HEAD@{1}`) |
 
 ### `insert_before`
 
@@ -338,17 +350,92 @@ extra_steps:
     insert_before: docker_build_pull   # runs before build, not after verify
 ```
 
-## `redeploy.yaml` project manifest
+## Plugin system
+
+Extend the step pipeline with custom action types using `action: plugin`:
+
+```yaml
+extra_steps:
+  - id: reload_kiosk
+    action: plugin
+    plugin_type: browser_reload
+    description: Reload kiosk browser after deploy
+    plugin_params:
+      port: 9222
+      ignore_cache: true
+      url_contains: "localhost:8100"
+```
+
+### Built-in plugins
+
+| `plugin_type` | Description | `plugin_params` |
+|---------------|-------------|-----------------|
+| `browser_reload` | Reload Chromium via CDP (Chrome DevTools Protocol) over SSH | `port` (9222), `ignore_cache` (true), `url_contains` ("") |
+
+### Writing a custom plugin
+
+Place a `.py` file in `./redeploy_plugins/` (project-local) or `~/.redeploy/plugins/` (user-global):
+
+```python
+# ./redeploy_plugins/notify.py
+from redeploy.plugins import register_plugin, PluginContext
+from redeploy.models import StepStatus
+
+@register_plugin("notify_slack")
+def notify_slack(ctx: PluginContext) -> None:
+    webhook = ctx.params["webhook"]
+    ctx.probe.run(f"curl -X POST {webhook} -d '{{\"text\":\"deployed!\"}}'")
+    ctx.step.result = "notified"
+    ctx.step.status = StepStatus.DONE
+```
+
+`PluginContext` fields:
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `step` | `MigrationStep` | Current step — set `result` and `status` here |
+| `host` | `str` | SSH host (e.g. `pi@192.168.1.5`) |
+| `probe` | `RemoteProbe` | Call `probe.run(cmd)` for remote SSH commands |
+| `emitter` | `ProgressEmitter?` | Emit mid-step progress: `emitter.progress(step.id, msg)` |
+| `params` | `dict` | Shortcut for `step.plugin_params` |
+| `dry_run` | `bool` | Skip side-effects if True |
+
 
-Place in project root — `redeploy run` (no args) uses it automatically:
+
+Place in project root — `redeploy run` (no args) uses it automatically.
+Supports **named environments** for multi-target projects:
 
 ```yaml
 spec: migration.yaml          # default spec file
-host: root@87.106.87.183
 app: myapp
-domain: myapp.example.com
-ssh_port: 22
-env_file: envs/vps.env
+
+environments:
+  prod:
+    host: root@87.106.87.183
+    strategy: docker_full
+    domain: myapp.example.com
+    env_file: envs/vps.env
+    verify_url: https://myapp.example.com/api/v1/health
+  rpi5:
+    host: pi@192.168.188.108
+    strategy: systemd
+    env_file: .env
+    verify_url: http://192.168.188.108:8000/api/v1/health
+  dev:
+    host: local
+    strategy: docker_full
+    env_file: .env.local
+    verify_url: http://localhost:8000/api/v1/health
+```
+
+Fallback: if no `redeploy.yaml` found, `redeploy run` reads `DEPLOY_*` vars from `.env`:
+
+```bash
+# .env
+DEPLOY_HOST=pi@192.168.1.5
+DEPLOY_APP=myapp
+DEPLOY_DOMAIN=myapp.local
+DEPLOY_ENV_FILE=.env
 ```
 
 ## doql integration

{redeploy-0.1.6 → redeploy-0.2.4}/README.md

@@ -3,17 +3,17 @@
 
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.1.6-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
-![AI Cost](https://img.shields.io/badge/AI%20Cost-$1.95-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-3.3h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.2.4-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![AI Cost](https://img.shields.io/badge/AI%20Cost-$3.30-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-5.3h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $1.9500 (13 commits)
-- 👤 **Human dev:** ~$333 (3.3h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $3.3000 (22 commits)
+- 👤 **Human dev:** ~$533 (5.3h @ $100/h, 30min dedup)
 
 Generated on 2026-04-20 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
 
 ---
 
-![PyPI](https://img.shields.io/badge/pypi-redeploy-blue) ![Version](https://img.shields.io/badge/version-0.1.6-blue) ![Python](https://img.shields.io/badge/python-3.10+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![PyPI](https://img.shields.io/badge/pypi-redeploy-blue) ![Version](https://img.shields.io/badge/version-0.2.4-blue) ![Python](https://img.shields.io/badge/python-3.10+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
 
 Infrastructure migration and device deploy toolkit — VPS, Raspberry Pi kiosk, Podman Quadlet, k3s.
 
@@ -139,8 +139,15 @@ Execute deploy from a YAML spec file (or `redeploy.yaml` project manifest if no
 | `--plan-only` | Show steps without connecting via SSH |
 | `--dry-run` | Connect, show steps, make no changes |
 | `--detect` | Live-probe host before planning (recommended for prod) |
+| `--env NAME` | Use named environment from `redeploy.yaml` (e.g. `prod`, `rpi5`) |
 | `--plan-out FILE` | Save generated plan to file |
 
+```bash
+redeploy run --env prod             # use prod env from redeploy.yaml
+redeploy run --env rpi5 --detect    # deploy to rpi5 with live probe
+redeploy run --dry-run              # uses .env DEPLOY_* vars if no redeploy.yaml
+```
+
 ### `redeploy scan [options]`
 
 Discover SSH-accessible devices on the local network.
@@ -304,6 +311,11 @@ extra_steps:
 | `version_check` | `version_check` | Verify deployed version |
 | `sync_env` | `scp` | Copy .env to remote |
 | `podman_daemon_reload` | `systemctl_start` | `systemctl --user daemon-reload` |
+| `stop_podman` | `systemctl_stop` | Stop all Podman containers via systemd |
+| `enable_podman_unit` | `systemctl_start` | `systemctl daemon-reload && enable --now {service}.service` |
+| `systemctl_restart` | `systemctl_start` | Restart a systemd service (`command=` to override) |
+| `systemctl_daemon_reload` | `ssh_cmd` | `systemctl daemon-reload` |
+| `git_pull` | `ssh_cmd` | `git pull --ff-only` with rollback (`git reset --hard HEAD@{1}`) |
 
 ### `insert_before`
 
@@ -315,17 +327,92 @@ extra_steps:
     insert_before: docker_build_pull   # runs before build, not after verify
 ```
 
-## `redeploy.yaml` project manifest
+## Plugin system
+
+Extend the step pipeline with custom action types using `action: plugin`:
+
+```yaml
+extra_steps:
+  - id: reload_kiosk
+    action: plugin
+    plugin_type: browser_reload
+    description: Reload kiosk browser after deploy
+    plugin_params:
+      port: 9222
+      ignore_cache: true
+      url_contains: "localhost:8100"
+```
+
+### Built-in plugins
+
+| `plugin_type` | Description | `plugin_params` |
+|---------------|-------------|-----------------|
+| `browser_reload` | Reload Chromium via CDP (Chrome DevTools Protocol) over SSH | `port` (9222), `ignore_cache` (true), `url_contains` ("") |
+
+### Writing a custom plugin
+
+Place a `.py` file in `./redeploy_plugins/` (project-local) or `~/.redeploy/plugins/` (user-global):
+
+```python
+# ./redeploy_plugins/notify.py
+from redeploy.plugins import register_plugin, PluginContext
+from redeploy.models import StepStatus
+
+@register_plugin("notify_slack")
+def notify_slack(ctx: PluginContext) -> None:
+    webhook = ctx.params["webhook"]
+    ctx.probe.run(f"curl -X POST {webhook} -d '{{\"text\":\"deployed!\"}}'")
+    ctx.step.result = "notified"
+    ctx.step.status = StepStatus.DONE
+```
+
+`PluginContext` fields:
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `step` | `MigrationStep` | Current step — set `result` and `status` here |
+| `host` | `str` | SSH host (e.g. `pi@192.168.1.5`) |
+| `probe` | `RemoteProbe` | Call `probe.run(cmd)` for remote SSH commands |
+| `emitter` | `ProgressEmitter?` | Emit mid-step progress: `emitter.progress(step.id, msg)` |
+| `params` | `dict` | Shortcut for `step.plugin_params` |
+| `dry_run` | `bool` | Skip side-effects if True |
+
 
-Place in project root — `redeploy run` (no args) uses it automatically:
+
+Place in project root — `redeploy run` (no args) uses it automatically.
+Supports **named environments** for multi-target projects:
 
 ```yaml
 spec: migration.yaml          # default spec file
-host: root@87.106.87.183
 app: myapp
-domain: myapp.example.com
-ssh_port: 22
-env_file: envs/vps.env
+
+environments:
+  prod:
+    host: root@87.106.87.183
+    strategy: docker_full
+    domain: myapp.example.com
+    env_file: envs/vps.env
+    verify_url: https://myapp.example.com/api/v1/health
+  rpi5:
+    host: pi@192.168.188.108
+    strategy: systemd
+    env_file: .env
+    verify_url: http://192.168.188.108:8000/api/v1/health
+  dev:
+    host: local
+    strategy: docker_full
+    env_file: .env.local
+    verify_url: http://localhost:8000/api/v1/health
+```
+
+Fallback: if no `redeploy.yaml` found, `redeploy run` reads `DEPLOY_*` vars from `.env`:
+
+```bash
+# .env
+DEPLOY_HOST=pi@192.168.1.5
+DEPLOY_APP=myapp
+DEPLOY_DOMAIN=myapp.local
+DEPLOY_ENV_FILE=.env
 ```
 
 ## doql integration

{redeploy-0.1.6 → redeploy-0.2.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "redeploy"
-version = "0.1.6"
+version = "0.2.4"
 description = "Infrastructure migration toolkit: detect → plan → apply"
 readme = "README.md"
 requires-python = ">=3.11"

redeploy-0.2.4/redeploy/__init__.py

@@ -0,0 +1,149 @@
+"""redeploy — Infrastructure migration toolkit: detect → plan → apply.
+
+Public API (stable from 0.2.0, semver guaranteed)::
+
+    from redeploy import MigrationSpec, Planner, Executor
+    from redeploy import InfraState, TargetConfig, DeployStrategy
+
+Everything not listed in ``__all__`` is internal and may change without notice.
+"""
+__version__ = "0.2.4"
+
+# ── Core models ───────────────────────────────────────────────────────────────
+from .models import (  # noqa: F401
+    ConflictSeverity,
+    DeployStrategy,
+    InfraSpec,
+    InfraState,
+    MigrationPlan,
+    MigrationSpec,
+    MigrationStep,
+    StepAction,
+    StepStatus,
+    TargetConfig,
+)
+
+# ── Pipeline ──────────────────────────────────────────────────────────────────
+from .detect import Detector          # noqa: F401
+from .plan import Planner             # noqa: F401
+from .apply import Executor           # noqa: F401
+
+# ── SSH primitives ────────────────────────────────────────────────────────────
+from .ssh import SshClient, SshResult  # noqa: F401
+
+# ── Fleet / registry (first-class from 0.2.0) ────────────────────────────────
+from .models import DeviceRegistry, KnownDevice  # noqa: F401
+from .fleet import (  # noqa: F401
+    DeviceArch,
+    DeviceExpectation,
+    Fleet,
+    FleetConfig,
+    FleetDevice,
+    Stage,
+    STAGE_DEFAULT_EXPECTATIONS,
+)
+from .steps import StepLibrary  # noqa: F401
+
+# ── Deploy patterns (first-class from 0.2.0) ──────────────────────────────────
+from .patterns import (  # noqa: F401
+    DeployPattern,
+    BlueGreenPattern,
+    CanaryPattern,
+    RollbackOnFailurePattern,
+    get_pattern,
+    list_patterns,
+    pattern_registry,
+)
+
+# ── Observability (first-class from 0.2.0) ────────────────────────────────────
+from .observe import (  # noqa: F401
+    AuditEntry,
+    DeployAuditLog,
+    DeployReport,
+)
+
+# ── IaC parsers (first-class from 0.3.0) ──────────────────────────────────────
+from .iac import (  # noqa: F401
+    ParsedSpec,
+    Parser,
+    ParserRegistry,
+    PortInfo,
+    ServiceInfo,
+    VolumeInfo,
+    ConversionWarning,
+    parse_file,
+    parse_dir,
+    parser_registry,
+)
+
+# ── Plugin system (first-class from 0.2.2) ────────────────────────────────────
+from .plugins import (  # noqa: F401
+    PluginContext,
+    PluginRegistry,
+    register_plugin,
+    load_user_plugins,
+    registry as plugin_registry,
+)
+
+__all__ = [
+    # version
+    "__version__",
+    # models
+    "ConflictSeverity",
+    "DeployStrategy",
+    "InfraSpec",
+    "InfraState",
+    "MigrationPlan",
+    "MigrationSpec",
+    "MigrationStep",
+    "StepAction",
+    "StepStatus",
+    "TargetConfig",
+    # pipeline
+    "Detector",
+    "Planner",
+    "Executor",
+    # SSH
+    "SshClient",
+    "SshResult",
+    # fleet / registry
+    "DeviceRegistry",
+    "KnownDevice",
+    "Fleet",
+    "DeviceArch",
+    "DeviceExpectation",
+    "FleetConfig",
+    "FleetDevice",
+    "Stage",
+    "STAGE_DEFAULT_EXPECTATIONS",
+    "StepLibrary",
+    # patterns
+    "DeployPattern",
+    "BlueGreenPattern",
+    "CanaryPattern",
+    "RollbackOnFailurePattern",
+    "get_pattern",
+    "list_patterns",
+    "pattern_registry",
+    # observability
+    "AuditEntry",
+    "DeployAuditLog",
+    "DeployReport",
+    # iac parsers
+    "ParsedSpec",
+    "Parser",
+    "ParserRegistry",
+    "PortInfo",
+    "ServiceInfo",
+    "VolumeInfo",
+    "ConversionWarning",
+    "parse_file",
+    "parse_dir",
+    "parser_registry",
+    # plugin system
+    "PluginContext",
+    "PluginRegistry",
+    "register_plugin",
+    "load_user_plugins",
+    "plugin_registry",
+]