fallbacks3 0.1.0__tar.gz → 0.2.0__tar.gz

{fallbacks3-0.1.0 → fallbacks3-0.2.0}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: fallbacks3
-Version: 0.1.0
+Version: 0.2.0
 Summary: S3-compatible storage library with automatic fallback support
 Author-email: Mila de Oliveira <mila.oliveira@palver.com.br>
 Project-URL: Homepage, https://github.com/palverdata/fallbacks3
 Project-URL: Repository, https://github.com/palverdata/fallbacks3
 Project-URL: Issues, https://github.com/palverdata/fallbacks3/issues
-Requires-Python: >=3.8
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 Requires-Dist: boto3>=1.26.0
 Requires-Dist: pydantic-settings>=2.0.0
@@ -85,6 +85,12 @@ stored_file_uri = storage.upload_file(
 )
 print(uri)  # "ps3://palver-whatsapp/audio.mp3"
 
+# Async upload (for async environments)
+stored_file_uri = await storage.upload_file_async(
+    remote_file_uri="ps3://palver-whatsapp/audio.mp3",
+    local_file_path="/local/path/audio.mp3"
+)
+
 # Download a file
 downloaded_file_path = storage.download_file(
     remote_file_uri="ps3://palver-whatsapp/audio.mp3",
@@ -115,6 +121,28 @@ stored_file_path = storage.upload_file(
 
 Raises an exception if both primary and fallback providers fail.
 
+#### Async Upload
+
+For async environments, use `upload_file_async()`:
+
+```python
+import asyncio
+from fallbacks3 import Storage
+
+storage = Storage()
+
+async def upload():
+    stored_file_uri = await storage.upload_file_async(
+        remote_file_uri="ps3://palver-whatsapp/audio.mp3",
+        local_file_path="/local/path/audio.mp3"
+    )
+    print(stored_file_uri)  # "ps3://palver-whatsapp/audio.mp3"
+
+asyncio.run(upload())
+```
+
+The async method also supports automatic fallback, just like the synchronous version.
+
 ### Download and Signed URLs
 
 Download and signed URL generation use the provider specified in the remote file URI.

{fallbacks3-0.1.0 → fallbacks3-0.2.0}/README.md

@@ -64,6 +64,12 @@ stored_file_uri = storage.upload_file(
 )
 print(uri)  # "ps3://palver-whatsapp/audio.mp3"
 
+# Async upload (for async environments)
+stored_file_uri = await storage.upload_file_async(
+    remote_file_uri="ps3://palver-whatsapp/audio.mp3",
+    local_file_path="/local/path/audio.mp3"
+)
+
 # Download a file
 downloaded_file_path = storage.download_file(
     remote_file_uri="ps3://palver-whatsapp/audio.mp3",
@@ -94,6 +100,28 @@ stored_file_path = storage.upload_file(
 
 Raises an exception if both primary and fallback providers fail.
 
+#### Async Upload
+
+For async environments, use `upload_file_async()`:
+
+```python
+import asyncio
+from fallbacks3 import Storage
+
+storage = Storage()
+
+async def upload():
+    stored_file_uri = await storage.upload_file_async(
+        remote_file_uri="ps3://palver-whatsapp/audio.mp3",
+        local_file_path="/local/path/audio.mp3"
+    )
+    print(stored_file_uri)  # "ps3://palver-whatsapp/audio.mp3"
+
+asyncio.run(upload())
+```
+
+The async method also supports automatic fallback, just like the synchronous version.
+
 ### Download and Signed URLs
 
 Download and signed URL generation use the provider specified in the remote file URI.

{fallbacks3-0.1.0 → fallbacks3-0.2.0}/fallbacks3/storage.py

@@ -1,7 +1,7 @@
+import asyncio
 from fallbacks3.config import config
 from fallbacks3.provider import S3Provider
 from fallbacks3.utils.uri import build_provider_credentials, parse_uri
-from typing import Dict, Tuple
 from urllib.parse import ParseResult
 
 
@@ -27,7 +27,7 @@ class Storage:
         Raises:
             ValueError: If fallback_provider not found in providers
         """
-        self.providers: Dict[str, S3Provider] = {}
+        self.providers: dict[str, S3Provider] = {}
 
         # Parse and initialize all providers
         for provider in providers.split(","):
@@ -89,6 +89,27 @@ class Storage:
                     )
             raise
 
+    async def upload_file_async(
+        self, remote_file_uri: str, local_file_path: str
+    ) -> str:
+        """Upload a file asynchronously with automatic fallback on failure.
+
+        Args:
+            remote_file_uri: Remote file URI in format <provider>://<bucket>/<file_path>
+                Example: "ps3://palver-whatsapp/file.mp4"
+            local_file_path: Local path to the file to upload
+
+        Returns:
+            URI of uploaded file in format: <provider>://<bucket>/<file_path>
+
+        Raises:
+            ValueError: If provider is not configured
+            Exception: If upload fails on both primary and fallback providers
+        """
+        return await asyncio.to_thread(
+            self.upload_file, remote_file_uri, local_file_path
+        )
+
     def download_file(self, remote_file_uri: str, local_file_path: str) -> str:
         """Download a file from storage.
 
@@ -133,7 +154,7 @@ class Storage:
             expiration=expiration,
         )
 
-    def _resolve_uri(self, uri: str) -> Tuple[ParseResult, S3Provider]:
+    def _resolve_uri(self, uri: str) -> tuple[ParseResult, S3Provider]:
         """Parse and validate URI, then return parsed URI and provider.
 
         Args:

{fallbacks3-0.1.0 → fallbacks3-0.2.0}/fallbacks3.egg-info/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: fallbacks3
-Version: 0.1.0
+Version: 0.2.0
 Summary: S3-compatible storage library with automatic fallback support
 Author-email: Mila de Oliveira <mila.oliveira@palver.com.br>
 Project-URL: Homepage, https://github.com/palverdata/fallbacks3
 Project-URL: Repository, https://github.com/palverdata/fallbacks3
 Project-URL: Issues, https://github.com/palverdata/fallbacks3/issues
-Requires-Python: >=3.8
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 Requires-Dist: boto3>=1.26.0
 Requires-Dist: pydantic-settings>=2.0.0
@@ -85,6 +85,12 @@ stored_file_uri = storage.upload_file(
 )
 print(uri)  # "ps3://palver-whatsapp/audio.mp3"
 
+# Async upload (for async environments)
+stored_file_uri = await storage.upload_file_async(
+    remote_file_uri="ps3://palver-whatsapp/audio.mp3",
+    local_file_path="/local/path/audio.mp3"
+)
+
 # Download a file
 downloaded_file_path = storage.download_file(
     remote_file_uri="ps3://palver-whatsapp/audio.mp3",
@@ -115,6 +121,28 @@ stored_file_path = storage.upload_file(
 
 Raises an exception if both primary and fallback providers fail.
 
+#### Async Upload
+
+For async environments, use `upload_file_async()`:
+
+```python
+import asyncio
+from fallbacks3 import Storage
+
+storage = Storage()
+
+async def upload():
+    stored_file_uri = await storage.upload_file_async(
+        remote_file_uri="ps3://palver-whatsapp/audio.mp3",
+        local_file_path="/local/path/audio.mp3"
+    )
+    print(stored_file_uri)  # "ps3://palver-whatsapp/audio.mp3"
+
+asyncio.run(upload())
+```
+
+The async method also supports automatic fallback, just like the synchronous version.
+
 ### Download and Signed URLs
 
 Download and signed URL generation use the provider specified in the remote file URI.

{fallbacks3-0.1.0 → fallbacks3-0.2.0}/pyproject.toml

@@ -4,10 +4,10 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "fallbacks3"
-version = "0.1.0"
+version = "0.2.0"
 description = "S3-compatible storage library with automatic fallback support"
 readme = "README.md"
-requires-python = ">=3.8"
+requires-python = ">=3.9"
 authors = [
     {name = "Mila de Oliveira", email = "mila.oliveira@palver.com.br"}
 ]
@@ -45,8 +45,8 @@ python_functions = ["test_*"]
 
 [tool.black]
 line-length = 88
-target-version = ["py38"]
+target-version = ["py39"]
 
 [tool.ruff]
 line-length = 88
-target-version = "py38"
+target-version = "py39"