clonebox 1.1.4__tar.gz → 1.1.6__tar.gz

{clonebox-1.1.4/src/clonebox.egg-info → clonebox-1.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clonebox
-Version: 1.1.4
+Version: 1.1.6
 Summary: Clone your workstation environment to an isolated VM with selective apps, paths and services
 Author: CloneBox Team
 License: Apache-2.0
@@ -32,6 +32,8 @@ Requires-Dist: psutil>=5.9.0
 Requires-Dist: pyyaml>=6.0
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: cryptography>=42.0.0
+Requires-Dist: structlog>=24.0.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
@@ -114,6 +116,8 @@ CloneBox excels in scenarios where developers need:
 | 🎛️ Profiles System (`ml-dev`, `web-stack`) | ✅ Stable |
 | 🔍 Auto-detection (services, apps, paths) | ✅ Stable |
 | 🔒 P2P Secure Transfer (AES-256) | ✅ **NEW** |
+| 📸 Snapshot Management | ✅ **NEW** |
+| 🏥 Health Check System | ✅ **NEW** |
 | 🧪 95%+ Test Coverage | ✅ |
 
 ### P2P Secure VM Sharing
@@ -141,9 +145,55 @@ clonebox sync-key user@hostB  # Sync encryption key
 clonebox list-remote user@hostB  # List remote VMs
 ```
 
+### Snapshot Management
+
+Save and restore VM states:
+
+```bash
+# Create snapshot before risky operation
+clonebox snapshot create my-vm --name "before-upgrade" --user
+
+# List all snapshots
+clonebox snapshot list my-vm --user
+
+# Restore to previous state
+clonebox snapshot restore my-vm --name "before-upgrade" --user
+
+# Delete old snapshot
+clonebox snapshot delete my-vm --name "before-upgrade" --user
+```
+
+### Health Checks
+
+Configure health probes in `.clonebox.yaml`:
+
+```yaml
+health_checks:
+  - name: nginx
+    type: http
+    url: http://localhost:80/health
+    expected_status: 200
+    
+  - name: postgres
+    type: tcp
+    host: localhost
+    port: 5432
+    
+  - name: redis
+    type: command
+    exec: "redis-cli ping"
+    expected_output: "PONG"
+```
+
+Run health checks:
+
+```bash
+clonebox health my-vm --user
+```
+
 ### Roadmap
 
-- **v1.2.0**: `clonebox exec` command, VM snapshots, snapshot restore
+- **v1.2.0**: Resource limits, progress bars, secrets isolation
 - **v1.3.0**: Multi-VM orchestration, cluster mode
 - **v2.0.0**: Cloud provider support (AWS, GCP, Azure), Windows WSL2 support
 

{clonebox-1.1.4 → clonebox-1.1.6}/README.md

@@ -63,6 +63,8 @@ CloneBox excels in scenarios where developers need:
 | 🎛️ Profiles System (`ml-dev`, `web-stack`) | ✅ Stable |
 | 🔍 Auto-detection (services, apps, paths) | ✅ Stable |
 | 🔒 P2P Secure Transfer (AES-256) | ✅ **NEW** |
+| 📸 Snapshot Management | ✅ **NEW** |
+| 🏥 Health Check System | ✅ **NEW** |
 | 🧪 95%+ Test Coverage | ✅ |
 
 ### P2P Secure VM Sharing
@@ -90,9 +92,55 @@ clonebox sync-key user@hostB  # Sync encryption key
 clonebox list-remote user@hostB  # List remote VMs
 ```
 
+### Snapshot Management
+
+Save and restore VM states:
+
+```bash
+# Create snapshot before risky operation
+clonebox snapshot create my-vm --name "before-upgrade" --user
+
+# List all snapshots
+clonebox snapshot list my-vm --user
+
+# Restore to previous state
+clonebox snapshot restore my-vm --name "before-upgrade" --user
+
+# Delete old snapshot
+clonebox snapshot delete my-vm --name "before-upgrade" --user
+```
+
+### Health Checks
+
+Configure health probes in `.clonebox.yaml`:
+
+```yaml
+health_checks:
+  - name: nginx
+    type: http
+    url: http://localhost:80/health
+    expected_status: 200
+    
+  - name: postgres
+    type: tcp
+    host: localhost
+    port: 5432
+    
+  - name: redis
+    type: command
+    exec: "redis-cli ping"
+    expected_output: "PONG"
+```
+
+Run health checks:
+
+```bash
+clonebox health my-vm --user
+```
+
 ### Roadmap
 
-- **v1.2.0**: `clonebox exec` command, VM snapshots, snapshot restore
+- **v1.2.0**: Resource limits, progress bars, secrets isolation
 - **v1.3.0**: Multi-VM orchestration, cluster mode
 - **v2.0.0**: Cloud provider support (AWS, GCP, Azure), Windows WSL2 support
 

{clonebox-1.1.4 → clonebox-1.1.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "clonebox"
-version = "1.1.4"
+version = "1.1.6"
 description = "Clone your workstation environment to an isolated VM with selective apps, paths and services"
 readme = "README.md"
 license = {text = "Apache-2.0"}
@@ -38,6 +38,8 @@ dependencies = [
     "pyyaml>=6.0",
     "pydantic>=2.0.0",
     "python-dotenv>=1.0.0",
+    "cryptography>=42.0.0",
+    "structlog>=24.0.0",
 ]
 
 [project.optional-dependencies]

clonebox-1.1.6/src/clonebox/backends/libvirt_backend.py

@@ -0,0 +1,217 @@
+"""libvirt hypervisor backend implementation."""
+
+import base64
+import json
+import time
+from typing import Any, Dict, List, Optional
+
+try:
+    import libvirt
+except ImportError:
+    libvirt = None
+
+from ..interfaces.hypervisor import HypervisorBackend, VMInfo
+
+
+class LibvirtBackend(HypervisorBackend):
+    """libvirt hypervisor backend."""
+
+    name = "libvirt"
+
+    def __init__(
+        self,
+        uri: Optional[str] = None,
+        user_session: bool = False,
+    ):
+        self.uri = uri or ("qemu:///session" if user_session else "qemu:///system")
+        self._conn: Optional[libvirt.virConnect] = None
+
+    def connect(self) -> None:
+        """Establish connection to libvirt."""
+        if self._conn is not None:
+            try:
+                if self._conn.isAlive():
+                    return
+            except libvirt.libvirtError:
+                pass
+
+        try:
+            self._conn = libvirt.open(self.uri)
+        except libvirt.libvirtError as e:
+            raise ConnectionError(f"Failed to connect to libvirt at {self.uri}: {e}")
+
+    def disconnect(self) -> None:
+        """Close connection."""
+        if self._conn:
+            try:
+                self._conn.close()
+            except libvirt.libvirtError:
+                pass
+            self._conn = None
+
+    @property
+    def conn(self) -> libvirt.virConnect:
+        """Get active libvirt connection."""
+        if self._conn is None:
+            self.connect()
+        return self._conn
+
+    def define_vm(self, config: Any) -> str:
+        """Define a new VM. Returns VM name."""
+        # This normally takes XML, but for DI we might want to pass config
+        # and let the backend handle XML generation if it's backend-specific.
+        # For now, we assume the caller provides the XML via config.xml or similar
+        # if they want to use this generic interface, or we refactor cloner to use backend.
+        if hasattr(config, "xml"):
+            domain = self.conn.defineXML(config.xml)
+            return domain.name()
+        raise ValueError("Config must provide XML for libvirt backend")
+
+    def undefine_vm(self, name: str) -> None:
+        """Remove VM definition."""
+        try:
+            domain = self.conn.lookupByName(name)
+            if domain.isActive():
+                domain.destroy()
+            domain.undefine()
+        except libvirt.libvirtError as e:
+            if "not found" not in str(e).lower():
+                raise
+
+    def start_vm(self, name: str) -> None:
+        """Start a VM."""
+        domain = self.conn.lookupByName(name)
+        if not domain.isActive():
+            domain.create()
+
+    def stop_vm(self, name: str, force: bool = False) -> None:
+        """Stop a VM."""
+        domain = self.conn.lookupByName(name)
+        if domain.isActive():
+            if force:
+                domain.destroy()
+            else:
+                domain.shutdown()
+
+    def get_vm_info(self, name: str) -> Optional[VMInfo]:
+        """Get VM information."""
+        try:
+            domain = self.conn.lookupByName(name)
+        except libvirt.libvirtError:
+            return None
+
+        info = domain.info()
+        state_map = {
+            libvirt.VIR_DOMAIN_RUNNING: "running",
+            libvirt.VIR_DOMAIN_BLOCKED: "blocked",
+            libvirt.VIR_DOMAIN_PAUSED: "paused",
+            libvirt.VIR_DOMAIN_SHUTDOWN: "shutdown",
+            libvirt.VIR_DOMAIN_SHUTOFF: "shutoff",
+            libvirt.VIR_DOMAIN_CRASHED: "crashed",
+            libvirt.VIR_DOMAIN_PMSUSPENDED: "pmsuspended",
+        }
+
+        return VMInfo(
+            name=domain.name(),
+            state=state_map.get(info[0], "unknown"),
+            uuid=domain.UUIDString(),
+            memory_mb=info[1] // 1024,
+            vcpus=info[3],
+            ip_addresses=self._get_ip_addresses(domain),
+        )
+
+    def list_vms(self) -> List[VMInfo]:
+        """List all VMs."""
+        vms = []
+        try:
+            # List all domains (running and defined)
+            for domain in self.conn.listAllDomains():
+                info = self.get_vm_info(domain.name())
+                if info:
+                    vms.append(info)
+        except libvirt.libvirtError:
+            pass
+        return vms
+
+    def vm_exists(self, name: str) -> bool:
+        """Check if VM exists."""
+        try:
+            self.conn.lookupByName(name)
+            return True
+        except libvirt.libvirtError:
+            return False
+
+    def is_running(self, name: str) -> bool:
+        """Check if VM is running."""
+        try:
+            domain = self.conn.lookupByName(name)
+            return domain.isActive() == 1
+        except libvirt.libvirtError:
+            return False
+
+    def execute_command(
+        self,
+        name: str,
+        command: str,
+        timeout: int = 30,
+    ) -> Optional[str]:
+        """Execute command in VM via QEMU Guest Agent."""
+        domain = self.conn.lookupByName(name)
+
+        # Build QGA guest-exec command
+        qga_cmd = {
+            "execute": "guest-exec",
+            "arguments": {
+                "path": "/bin/bash",
+                "arg": ["-c", command],
+                "capture-output": True,
+            },
+        }
+
+        try:
+            result_json = domain.qemuAgentCommand(json.dumps(qga_cmd), timeout)
+            result_data = json.loads(result_json)
+            pid = result_data["return"]["pid"]
+
+            # Poll for completion
+            status_cmd = {"execute": "guest-exec-status", "arguments": {"pid": pid}}
+            start_time = time.time()
+            while time.time() - start_time < timeout:
+                status_json = domain.qemuAgentCommand(json.dumps(status_cmd), timeout)
+                status_data = json.loads(status_json)
+
+                if status_data["return"]["exited"]:
+                    if "out-data" in status_data["return"]:
+                        return base64.b64decode(status_data["return"]["out-data"]).decode(
+                            "utf-8", errors="replace"
+                        )
+                    return ""
+
+                time.sleep(0.5)
+
+            return None  # Timeout
+
+        except Exception:
+            return None
+
+    def _get_ip_addresses(self, domain) -> List[str]:
+        """Get IP addresses from domain via guest agent or lease."""
+        ips = []
+        try:
+            # Try guest agent first (more accurate)
+            ifaces = domain.interfaceAddresses(libvirt.VIR_DOMAIN_INTERFACE_ADDRESSES_SRC_AGENT)
+            for iface_data in ifaces.values():
+                for addr in iface_data.get("addrs", []):
+                    if addr["type"] == 0:  # IPv4
+                        ips.append(addr["addr"])
+        except libvirt.libvirtError:
+            # Fallback to network leases
+            try:
+                ifaces = domain.interfaceAddresses(libvirt.VIR_DOMAIN_INTERFACE_ADDRESSES_SRC_LEASE)
+                for iface_data in ifaces.values():
+                    for addr in iface_data.get("addrs", []):
+                        if addr["type"] == 0:
+                            ips.append(addr["addr"])
+            except libvirt.libvirtError:
+                pass
+        return ips

clonebox-1.1.6/src/clonebox/backends/qemu_disk.py

@@ -0,0 +1,52 @@
+"""QEMU disk manager implementation."""
+
+import subprocess
+from pathlib import Path
+from typing import Any, Dict, Optional
+
+from ..interfaces.disk import DiskManager
+
+
+class QemuDiskManager(DiskManager):
+    """Manage VM disks using qemu-img."""
+
+    def create_disk(
+        self,
+        path: Path,
+        size_gb: int,
+        format: str = "qcow2",
+        backing_file: Optional[Path] = None,
+    ) -> Path:
+        """Create a disk image."""
+        cmd = ["qemu-img", "create", "-f", format]
+        
+        if backing_file:
+            cmd.extend(["-b", str(backing_file), "-F", format])
+            
+        cmd.extend([str(path), f"{size_gb}G"])
+        
+        subprocess.run(cmd, check=True, capture_output=True)
+        return path
+
+    def resize_disk(self, path: Path, new_size_gb: int) -> None:
+        """Resize a disk image."""
+        cmd = ["qemu-img", "resize", str(path), f"{new_size_gb}G"]
+        subprocess.run(cmd, check=True, capture_output=True)
+
+    def get_disk_info(self, path: Path) -> Dict[str, Any]:
+        """Get disk image information."""
+        import json
+        cmd = ["qemu-img", "info", "--output=json", str(path)]
+        result = subprocess.run(cmd, check=True, capture_output=True, text=True)
+        return json.loads(result.stdout)
+
+    def create_snapshot(self, path: Path, snapshot_name: str) -> Path:
+        """Create internal disk snapshot."""
+        cmd = ["qemu-img", "snapshot", "-c", snapshot_name, str(path)]
+        subprocess.run(cmd, check=True, capture_output=True)
+        return path
+
+    def delete_disk(self, path: Path) -> None:
+        """Delete disk image."""
+        if path.exists():
+            path.unlink()

clonebox-1.1.6/src/clonebox/backends/subprocess_runner.py

@@ -0,0 +1,56 @@
+"""Subprocess process runner implementation."""
+
+import subprocess
+from pathlib import Path
+from typing import Dict, List, Optional
+
+from ..interfaces.process import ProcessResult, ProcessRunner
+
+
+class SubprocessRunner(ProcessRunner):
+    """Run processes using the subprocess module."""
+
+    def run(
+        self,
+        command: List[str],
+        capture_output: bool = True,
+        timeout: Optional[int] = None,
+        check: bool = True,
+        cwd: Optional[Path] = None,
+        env: Optional[Dict[str, str]] = None,
+    ) -> ProcessResult:
+        """Run a command."""
+        result = subprocess.run(
+            command,
+            capture_output=capture_output,
+            timeout=timeout,
+            check=check,
+            cwd=str(cwd) if cwd else None,
+            env=env,
+            text=True,
+        )
+        return ProcessResult(
+            returncode=result.returncode,
+            stdout=result.stdout,
+            stderr=result.stderr,
+        )
+
+    def run_shell(
+        self,
+        command: str,
+        capture_output: bool = True,
+        timeout: Optional[int] = None,
+    ) -> ProcessResult:
+        """Run a shell command."""
+        result = subprocess.run(
+            command,
+            shell=True,
+            capture_output=capture_output,
+            timeout=timeout,
+            text=True,
+        )
+        return ProcessResult(
+            returncode=result.returncode,
+            stdout=result.stdout,
+            stderr=result.stderr,
+        )