lumera 0.9.7__tar.gz → 0.9.8__tar.gz

{lumera-0.9.7 → lumera-0.9.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lumera
-Version: 0.9.7
+Version: 0.9.8
 Summary: SDK for building on Lumera platform
 Requires-Python: >=3.11
 Requires-Dist: requests

{lumera-0.9.7 → lumera-0.9.8}/lumera/storage.py

@@ -23,7 +23,15 @@ Example:
     >>> print(result["url"])
 """
 
-__all__ = ["upload", "upload_file", "download_url", "list_files", "UploadResult"]
+__all__ = [
+    "upload",
+    "upload_file",
+    "download_url",
+    "list_files",
+    "UploadResult",
+    "get_download_url",
+    "download",
+]
 
 import mimetypes
 import os
@@ -268,3 +276,76 @@ def list_files(prefix: str | None = None) -> list[dict[str, Any]]:
         files = [f for f in files if f.get("name", "").startswith(prefix)]
 
     return files
+
+
+def get_download_url(object_key: str) -> str:
+    """Get a presigned download URL for a file by its object_key.
+
+    Use this to get download URLs for files stored in lumera_file fields on records.
+    The object_key is found in the file descriptor (e.g., record["file"]["object_key"]).
+
+    Args:
+        object_key: The storage object key from a lumera_file field descriptor
+
+    Returns:
+        Presigned download URL (valid for ~15 minutes)
+
+    Raises:
+        ValueError: If object_key is empty
+        requests.HTTPError: If the file doesn't exist or request fails
+
+    Example:
+        >>> record = pb.get("documents", "rec_123")
+        >>> url = storage.get_download_url(record["file"]["object_key"])
+        >>> # Use url to download the file
+    """
+    if not object_key or not object_key.strip():
+        raise ValueError("object_key is required and cannot be empty")
+
+    token = get_lumera_token()
+    headers = {"Authorization": f"token {token}", "Content-Type": "application/json"}
+
+    resp = requests.post(
+        f"{API_BASE}/pb/uploads/download",
+        json={"object_key": object_key.strip()},
+        headers=headers,
+        timeout=30,
+    )
+    resp.raise_for_status()
+
+    data = resp.json()
+    url = data.get("download_url")
+    if not url:
+        raise RuntimeError("uploads/download response missing download_url")
+
+    return url
+
+
+def download(object_key: str) -> bytes:
+    """Download file content by its object_key.
+
+    Use this to download files stored in lumera_file fields on records.
+    The object_key is found in the file descriptor (e.g., record["file"]["object_key"]).
+
+    Args:
+        object_key: The storage object key from a lumera_file field descriptor
+
+    Returns:
+        File content as bytes
+
+    Raises:
+        ValueError: If object_key is empty
+        requests.HTTPError: If the file doesn't exist or download fails
+
+    Example:
+        >>> record = pb.get("documents", "rec_123")
+        >>> content = storage.download(record["file"]["object_key"])
+        >>> with open("local_copy.pdf", "wb") as f:
+        ...     f.write(content)
+    """
+    url = get_download_url(object_key)
+
+    response = requests.get(url, timeout=300)
+    response.raise_for_status()
+
+    return response.content

{lumera-0.9.7 → lumera-0.9.8}/lumera.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lumera
-Version: 0.9.7
+Version: 0.9.8
 Summary: SDK for building on Lumera platform
 Requires-Python: >=3.11
 Requires-Dist: requests

{lumera-0.9.7 → lumera-0.9.8}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "lumera"
-version = "0.9.7"
+version = "0.9.8"
 description = "SDK for building on Lumera platform"
 requires-python = ">=3.11"
 dependencies = [