clonebox 1.1.3__py3-none-any.whl → 1.1.5__py3-none-any.whl

clonebox/snapshots/models.py

@@ -0,0 +1,183 @@
+#!/usr/bin/env python3
+"""Data models for snapshot management."""
+
+from dataclasses import dataclass, field
+from datetime import datetime, timedelta
+from enum import Enum
+from pathlib import Path
+from typing import Any, Dict, List, Optional
+
+
+class SnapshotType(Enum):
+    """Type of snapshot."""
+
+    DISK_ONLY = "disk"  # Only disk state (offline)
+    FULL = "full"  # Disk + memory + device state (online)
+    EXTERNAL = "external"  # External snapshot file
+
+
+class SnapshotState(Enum):
+    """State of snapshot operation."""
+
+    CREATING = "creating"
+    READY = "ready"
+    REVERTING = "reverting"
+    DELETING = "deleting"
+    FAILED = "failed"
+
+
+@dataclass
+class Snapshot:
+    """Represents a VM snapshot."""
+
+    name: str
+    vm_name: str
+    snapshot_type: SnapshotType
+    state: SnapshotState
+    created_at: datetime
+
+    description: Optional[str] = None
+
+    # Snapshot hierarchy
+    parent_name: Optional[str] = None
+    children: List[str] = field(default_factory=list)
+
+    # Storage info
+    disk_path: Optional[Path] = None
+    memory_path: Optional[Path] = None
+    size_bytes: int = 0
+
+    # Metadata
+    metadata: Dict[str, Any] = field(default_factory=dict)
+    tags: List[str] = field(default_factory=list)
+
+    # Auto-snapshot info
+    auto_created: bool = False
+    auto_policy: Optional[str] = None
+    expires_at: Optional[datetime] = None
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Convert to dictionary for serialization."""
+        return {
+            "name": self.name,
+            "vm_name": self.vm_name,
+            "type": self.snapshot_type.value,
+            "state": self.state.value,
+            "created_at": self.created_at.isoformat(),
+            "description": self.description,
+            "parent_name": self.parent_name,
+            "children": self.children,
+            "disk_path": str(self.disk_path) if self.disk_path else None,
+            "memory_path": str(self.memory_path) if self.memory_path else None,
+            "size_bytes": self.size_bytes,
+            "metadata": self.metadata,
+            "tags": self.tags,
+            "auto_created": self.auto_created,
+            "auto_policy": self.auto_policy,
+            "expires_at": self.expires_at.isoformat() if self.expires_at else None,
+        }
+
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any]) -> "Snapshot":
+        """Create from dictionary."""
+        return cls(
+            name=data["name"],
+            vm_name=data["vm_name"],
+            snapshot_type=SnapshotType(data["type"]),
+            state=SnapshotState(data["state"]),
+            created_at=datetime.fromisoformat(data["created_at"]),
+            description=data.get("description"),
+            parent_name=data.get("parent_name"),
+            children=data.get("children", []),
+            disk_path=Path(data["disk_path"]) if data.get("disk_path") else None,
+            memory_path=Path(data["memory_path"]) if data.get("memory_path") else None,
+            size_bytes=data.get("size_bytes", 0),
+            metadata=data.get("metadata", {}),
+            tags=data.get("tags", []),
+            auto_created=data.get("auto_created", False),
+            auto_policy=data.get("auto_policy"),
+            expires_at=(
+                datetime.fromisoformat(data["expires_at"]) if data.get("expires_at") else None
+            ),
+        )
+
+    @property
+    def is_expired(self) -> bool:
+        """Check if snapshot has expired."""
+        if self.expires_at is None:
+            return False
+        return datetime.now() > self.expires_at
+
+    @property
+    def age(self) -> timedelta:
+        """Get snapshot age."""
+        return datetime.now() - self.created_at
+
+
+@dataclass
+class SnapshotPolicy:
+    """Policy for automatic snapshots."""
+
+    name: str
+    enabled: bool = True
+
+    # Retention settings
+    max_snapshots: int = 10
+    max_age_days: int = 30
+    min_snapshots: int = 1  # Keep at least N snapshots
+
+    # Auto-snapshot triggers
+    before_operations: List[str] = field(
+        default_factory=lambda: ["upgrade", "resize", "config-change"]
+    )
+    scheduled_interval_hours: Optional[int] = None  # e.g., 24 for daily
+
+    # Naming
+    name_prefix: str = "auto-"
+    include_timestamp: bool = True
+
+    # Cleanup
+    auto_cleanup: bool = True
+    cleanup_on_success: bool = False  # Remove pre-operation snapshot if op succeeds
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Convert to dictionary."""
+        return {
+            "name": self.name,
+            "enabled": self.enabled,
+            "max_snapshots": self.max_snapshots,
+            "max_age_days": self.max_age_days,
+            "min_snapshots": self.min_snapshots,
+            "before_operations": self.before_operations,
+            "scheduled_interval_hours": self.scheduled_interval_hours,
+            "name_prefix": self.name_prefix,
+            "include_timestamp": self.include_timestamp,
+            "auto_cleanup": self.auto_cleanup,
+            "cleanup_on_success": self.cleanup_on_success,
+        }
+
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any]) -> "SnapshotPolicy":
+        """Create from dictionary."""
+        return cls(
+            name=data["name"],
+            enabled=data.get("enabled", True),
+            max_snapshots=data.get("max_snapshots", 10),
+            max_age_days=data.get("max_age_days", 30),
+            min_snapshots=data.get("min_snapshots", 1),
+            before_operations=data.get("before_operations", ["upgrade", "resize", "config-change"]),
+            scheduled_interval_hours=data.get("scheduled_interval_hours"),
+            name_prefix=data.get("name_prefix", "auto-"),
+            include_timestamp=data.get("include_timestamp", True),
+            auto_cleanup=data.get("auto_cleanup", True),
+            cleanup_on_success=data.get("cleanup_on_success", False),
+        )
+
+    def generate_snapshot_name(self, operation: Optional[str] = None) -> str:
+        """Generate snapshot name based on policy."""
+        parts = [self.name_prefix]
+        if operation:
+            parts.append(operation)
+        if self.include_timestamp:
+            parts.append(datetime.now().strftime("%Y%m%d-%H%M%S"))
+        return "-".join(parts)

{clonebox-1.1.3.dist-info → clonebox-1.1.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clonebox
-Version: 1.1.3
+Version: 1.1.5
 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,7 @@ 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
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
@@ -114,6 +115,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 +144,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.5.dist-info/RECORD

@@ -0,0 +1,42 @@
+clonebox/__init__.py,sha256=CyfHVVq6KqBr4CNERBpXk_O6Q5B35q03YpdQbokVvvI,408
+clonebox/__main__.py,sha256=Fcoyzwwyz5-eC_sBlQk5a5RbKx8uodQz5sKJ190U0NU,135
+clonebox/cli.py,sha256=m2WBz1SDTgpeDvX-dc93bDp4CKp7AcEI17vXWx3D4os,136109
+clonebox/cloner.py,sha256=aH7BwmLgPITHzyHn_n_AKqtEADDm_aUXiRG-nB2rxMQ,90063
+clonebox/container.py,sha256=tiYK1ZB-DhdD6A2FuMA0h_sRNkUI7KfYcJ0tFOcdyeM,6105
+clonebox/dashboard.py,sha256=dMY6odvPq3j6FronhRRsX7aY3qdCwznB-aCWKEmHDNw,5768
+clonebox/detector.py,sha256=vS65cvFNPmUBCX1Y_TMTnSRljw6r1Ae9dlVtACs5XFc,23075
+clonebox/di.py,sha256=feFMXP5ff-7gwrIqgnoCpk1ivaiZA_lv2wcpkCSKiew,5648
+clonebox/exporter.py,sha256=WIzVvmA0z_jjrpyXxvnXoLp9oaW6fKS7k0PGwzx_PIM,5629
+clonebox/importer.py,sha256=Q9Uk1IOA41mgGhU4ynW2k-h9GEoGxRKI3c9wWE4uxcA,7097
+clonebox/logging.py,sha256=jD_WgkHmt_h99EmX82QWK7D0OKWyxqcLwgT4UDQFp2g,3675
+clonebox/models.py,sha256=zwejkNtEEO_aPy_Q5UzXG5tszU-c7lkqh9LQus9eWMo,8307
+clonebox/monitor.py,sha256=zlIarNf8w_i34XI8hZGxxrg5PVZK_Yxm6FQnkhLavRI,9181
+clonebox/p2p.py,sha256=6o0JnscKqF9-BftQhW5fF1W6YY1wXshY9LEklNcHGJc,5913
+clonebox/profiles.py,sha256=UP37fX_rhrG_O9ehNFJBUcULPmUtN1A8KsJ6cM44oK0,1986
+clonebox/resource_monitor.py,sha256=lDR9KyPbVtImeeOkOBPPVP-5yCgoL5hsVFPZ_UqsY0w,5286
+clonebox/resources.py,sha256=IkuM4OdSDV4qhyc0eIynwbAHBTv0aVSxxW-gghsnCAs,6815
+clonebox/rollback.py,sha256=hpwO-8Ehe1pW0wHuZvJkC_qxZ6yEo9otCJRhGIUArCo,5711
+clonebox/secrets.py,sha256=QtGMIjhTKq14qQRGy-pX0TU3vKLiZt7CMloAlF2GmzQ,10515
+clonebox/validator.py,sha256=CF4hMlY69-AGRH5HdG8HAA9_LNCwDKD4xPlYQPWJ9Rw,36647
+clonebox/backends/libvirt_backend.py,sha256=sIHFIvFO1hIOXEFR_foSkOGBgIzaJVQs-njOU8GdafA,7170
+clonebox/backends/qemu_disk.py,sha256=YsGjYX5sbEf35Y4yjTpNkZat73a4RGBxY-KTVzJhqIs,1687
+clonebox/backends/subprocess_runner.py,sha256=c-IyaMxM1cmUu64h654oAvulm83K5Mu-VQxXJ_0BOds,1506
+clonebox/health/__init__.py,sha256=aKJJPQwJLnoCY728QuKUxYx1TZyooGEnyUVOegZ58Ok,422
+clonebox/health/manager.py,sha256=6nn0a8QtxeEuuafDbn5ZBqHQdaJ2qg7yTstyAGPJWP0,9987
+clonebox/health/models.py,sha256=sPumwj8S-88KgzSGw1Kq9bBbPVRd2RR0R87Z8hKJ_28,6001
+clonebox/health/probes.py,sha256=CkiGcayqRRysqaBJst-YpSrvUzMdwsqD4TiQSluLt3Y,11305
+clonebox/interfaces/disk.py,sha256=F7Xzj2dq5UTZ2KGCuThDM8bwTps6chFbquOUmfLREjI,985
+clonebox/interfaces/hypervisor.py,sha256=8ms4kZLA-5Ba1e_n68mCucwP_K9mufbmTBlo7XzURn4,1991
+clonebox/interfaces/network.py,sha256=YPIquxEB7sZHczbpuopcZpffTjWYI6cKmAu3wAEFllk,853
+clonebox/interfaces/process.py,sha256=njvAIZw_TCjw01KpyVQKIDoRvhTwl0FfVGbQ6mxTROk,1024
+clonebox/snapshots/__init__.py,sha256=ndlrIavPAiA8z4Ep3-D_EPhOcjNKYFnP3rIpEKaGdb8,273
+clonebox/snapshots/manager.py,sha256=hGzM8V6ZJPXjTqj47c4Kr8idlE-c1Q3gPUvuw1HvS1A,11393
+clonebox/snapshots/models.py,sha256=sRnn3OZE8JG9FZJlRuA3ihO-JXoPCQ3nD3SQytflAao,6206
+clonebox/templates/profiles/ml-dev.yaml,sha256=w07MToGh31xtxpjbeXTBk9BkpAN8A3gv8HeA3ESKG9M,461
+clonebox/templates/profiles/web-stack.yaml,sha256=EBnnGMzML5vAjXmIUbCpbTCwmRaNJiuWd3EcL43DOK8,485
+clonebox-1.1.5.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+clonebox-1.1.5.dist-info/METADATA,sha256=0sp9wPpm969pIM4iwq3m22B3uxh0vC694mJSIRjrUoc,48882
+clonebox-1.1.5.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+clonebox-1.1.5.dist-info/entry_points.txt,sha256=FES95Vi3btfViLEEoHdb8nikNxTqzaooi9ehZw9ZfWI,47
+clonebox-1.1.5.dist-info/top_level.txt,sha256=LdMo2cvCrEcRGH2M8JgQNVsCoszLV0xug6kx1JnaRjo,9
+clonebox-1.1.5.dist-info/RECORD,,

clonebox-1.1.3.dist-info/RECORD

@@ -1,21 +0,0 @@
-clonebox/__init__.py,sha256=CyfHVVq6KqBr4CNERBpXk_O6Q5B35q03YpdQbokVvvI,408
-clonebox/__main__.py,sha256=Fcoyzwwyz5-eC_sBlQk5a5RbKx8uodQz5sKJ190U0NU,135
-clonebox/cli.py,sha256=iPc2DWEDZaqBMXRJqpWKubmka9ZuJbAvs6mkMMEHAlw,122910
-clonebox/cloner.py,sha256=2YQO4SHCv0xOsU1hL9IqdgmxxJN-2j75X9pe-LpTpJE,82696
-clonebox/container.py,sha256=tiYK1ZB-DhdD6A2FuMA0h_sRNkUI7KfYcJ0tFOcdyeM,6105
-clonebox/dashboard.py,sha256=dMY6odvPq3j6FronhRRsX7aY3qdCwznB-aCWKEmHDNw,5768
-clonebox/detector.py,sha256=vS65cvFNPmUBCX1Y_TMTnSRljw6r1Ae9dlVtACs5XFc,23075
-clonebox/exporter.py,sha256=WIzVvmA0z_jjrpyXxvnXoLp9oaW6fKS7k0PGwzx_PIM,5629
-clonebox/importer.py,sha256=Q9Uk1IOA41mgGhU4ynW2k-h9GEoGxRKI3c9wWE4uxcA,7097
-clonebox/models.py,sha256=zwejkNtEEO_aPy_Q5UzXG5tszU-c7lkqh9LQus9eWMo,8307
-clonebox/p2p.py,sha256=LPQQ7wNO84yDnpVrGkaRU-FDUzqmC4URdZXVeHsNOew,5889
-clonebox/profiles.py,sha256=UP37fX_rhrG_O9ehNFJBUcULPmUtN1A8KsJ6cM44oK0,1986
-clonebox/validator.py,sha256=CF4hMlY69-AGRH5HdG8HAA9_LNCwDKD4xPlYQPWJ9Rw,36647
-clonebox/templates/profiles/ml-dev.yaml,sha256=w07MToGh31xtxpjbeXTBk9BkpAN8A3gv8HeA3ESKG9M,461
-clonebox/templates/profiles/web-stack.yaml,sha256=EBnnGMzML5vAjXmIUbCpbTCwmRaNJiuWd3EcL43DOK8,485
-clonebox-1.1.3.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-clonebox-1.1.3.dist-info/METADATA,sha256=16ilGCqzzvMBvEXxLZ-JlTyNxaI0u6ws74zM121Sw5o,47947
-clonebox-1.1.3.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-clonebox-1.1.3.dist-info/entry_points.txt,sha256=FES95Vi3btfViLEEoHdb8nikNxTqzaooi9ehZw9ZfWI,47
-clonebox-1.1.3.dist-info/top_level.txt,sha256=LdMo2cvCrEcRGH2M8JgQNVsCoszLV0xug6kx1JnaRjo,9
-clonebox-1.1.3.dist-info/RECORD,,