Initial Commit 🚀 🚀

api/services/filesystem/base.py

@@ -0,0 +1,60 @@
+from abc import ABC, abstractmethod
+from typing import Any, BinaryIO, Dict, Optional
+
+
+class BaseFileSystem(ABC):
+    """Abstract base class for filesystem operations."""
+
+    @abstractmethod
+    async def acreate_file(self, file_path: str, content: BinaryIO) -> bool:
+        """Create a new file with the given content.
+
+        Args:
+            file_path: Path where the file should be created
+            content: File content as a binary stream
+
+        Returns:
+            bool: True if file was created successfully, False otherwise
+        """
+        pass
+
+    @abstractmethod
+    async def aupload_file(self, local_path: str, destination_path: str) -> bool:
+        """Upload a file from local path to destination.
+
+        Args:
+            local_path: Path to the local file
+            destination_path: Path where the file should be uploaded
+
+        Returns:
+            bool: True if file was uploaded successfully, False otherwise
+        """
+        pass
+
+    @abstractmethod
+    async def aget_signed_url(
+        self, file_path: str, expiration: int = 3600
+    ) -> Optional[str]:
+        """Generate a signed URL for temporary access to a file.
+
+        Args:
+            file_path: Path to the file
+            expiration: URL expiration time in seconds (default: 1 hour)
+
+        Returns:
+            Optional[str]: Signed URL if successful, None otherwise
+        """
+        pass
+
+    @abstractmethod
+    async def aget_file_metadata(self, file_path: str) -> Optional[Dict[str, Any]]:
+        """Get metadata for a file.
+
+        Args:
+            file_path: Path to the file
+
+        Returns:
+            Optional[Dict[str, Any]]: File metadata if successful, None otherwise
+            Contains: size, created_at, modified_at, etag, etc.
+        """
+        pass