hippius 0.2.4__py3-none-any.whl → 0.2.6__py3-none-any.whl

hippius_sdk/cli_rich.py

@@ -6,8 +6,14 @@ from typing import Any, Dict, List, Optional, Union
 
 from rich.console import Console
 from rich.panel import Panel
-from rich.progress import (BarColumn, Progress, SpinnerColumn, TextColumn,
-                           TimeElapsedColumn, TimeRemainingColumn)
+from rich.progress import (
+    BarColumn,
+    Progress,
+    SpinnerColumn,
+    TextColumn,
+    TimeElapsedColumn,
+    TimeRemainingColumn,
+)
 from rich.table import Table
 from rich.text import Text
 

hippius_sdk/client.py

@@ -148,10 +148,11 @@ class HippiusClient:
     ) -> Dict[str, Any]:
         """
         Download a file from IPFS with optional decryption.
+        Supports downloading directories - in that case, a directory structure will be created.
 
         Args:
             cid: Content Identifier (CID) of the file to download
-            output_path: Path where the downloaded file will be saved
+            output_path: Path where the downloaded file/directory will be saved
             decrypt: Whether to decrypt the file (overrides default)
 
         Returns:
@@ -162,6 +163,7 @@ class HippiusClient:
                 - size_formatted: Human-readable file size
                 - elapsed_seconds: Time taken for the download
                 - decrypted: Whether the file was decrypted
+                - is_directory: Whether the download was a directory
 
         Raises:
             requests.RequestException: If the download fails
@@ -436,7 +438,7 @@ class HippiusClient:
         metadata_cid: str,
         cancel_from_blockchain: bool = True,
         parallel_limit: int = 20,
-    ) -> Dict[str, Any]:
+    ) -> bool:
         """
         Delete an erasure-coded file, including all its chunks in parallel.
 
@@ -446,7 +448,7 @@ class HippiusClient:
             parallel_limit: Maximum number of concurrent deletion operations
 
         Returns:
-            Dict containing the result of the operation
+            True or false if failed.
 
         Raises:
             RuntimeError: If deletion fails completely

hippius_sdk/errors.py

@@ -0,0 +1,77 @@
+"""
+Custom exceptions for the Hippius SDK.
+"""
+
+
+class HippiusError(Exception):
+    """Base exception for all Hippius-specific errors."""
+
+    pass
+
+
+class HippiusSubstrateError(HippiusError):
+    """Base exception for Substrate-related errors."""
+
+    pass
+
+
+class HippiusIPFSError(HippiusError):
+    """Base exception for IPFS-related errors."""
+
+    pass
+
+
+# Specific blockchain errors
+class HippiusNotFoundError(HippiusSubstrateError):
+    """Raised when a resource is not found on the blockchain."""
+
+    pass
+
+
+class HippiusAlreadyDeletedError(HippiusSubstrateError):
+    """Raised when trying to delete a file that's already deleted from the blockchain."""
+
+    pass
+
+
+class HippiusSubstrateConnectionError(HippiusSubstrateError):
+    """Raised when there's an issue connecting to the Substrate node."""
+
+    pass
+
+
+class HippiusSubstrateAuthError(HippiusSubstrateError):
+    """Raised when there's an authentication issue with the Substrate client."""
+
+    pass
+
+
+class HippiusFailedSubstrateDelete(HippiusSubstrateError):
+    """Raised when deletion from blockchain storage fails."""
+
+    pass
+
+
+# IPFS-specific errors
+class HippiusIPFSConnectionError(HippiusIPFSError):
+    """Raised when there's an issue connecting to IPFS."""
+
+    pass
+
+
+class HippiusFailedIPFSUnpin(HippiusIPFSError):
+    """Raised when unpinning from IPFS fails."""
+
+    pass
+
+
+class HippiusMetadataError(HippiusIPFSError):
+    """Raised when there's an issue with the metadata file."""
+
+    pass
+
+
+class HippiusInvalidCIDError(HippiusIPFSError):
+    """Raised when an invalid CID is provided."""
+
+    pass