((feat:fs_abstact) base

application/storage/base.py

@@ -0,0 +1,73 @@
+"""Base storage class for file system abstraction."""
+from abc import ABC, abstractmethod
+from typing import BinaryIO, List
+
+
+class BaseStorage(ABC):
+    """Abstract base class for storage implementations."""
+
+    @abstractmethod
+    def save_file(self, file_data: BinaryIO, path: str) -> str:
+        """
+        Save a file to storage.
+        
+        Args:
+            file_data: File-like object containing the data
+            path: Path where the file should be stored
+            
+        Returns:
+            str: The complete path where the file was saved
+        """
+        pass
+    
+    @abstractmethod
+    def get_file(self, path: str) -> BinaryIO:
+        """
+        Retrieve a file from storage.
+        
+        Args:
+            path: Path to the file
+            
+        Returns:
+            BinaryIO: File-like object containing the file data
+        """
+        pass
+    
+    @abstractmethod
+    def delete_file(self, path: str) -> bool:
+        """
+        Delete a file from storage.
+        
+        Args:
+            path: Path to the file
+            
+        Returns:
+            bool: True if deletion was successful
+        """
+        pass
+    
+    @abstractmethod
+    def file_exists(self, path: str) -> bool:
+        """
+        Check if a file exists.
+        
+        Args:
+            path: Path to the file
+            
+        Returns:
+            bool: True if the file exists
+        """
+        pass
+    
+    @abstractmethod
+    def list_files(self, directory: str) -> List[str]:
+        """
+        List all files in a directory.
+        
+        Args:
+            directory: Directory path to list
+            
+        Returns:
+            List[str]: List of file paths
+        """
+        pass