lumera 0.9.6__tar.gz → 0.9.8__tar.gz

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

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

{lumera-0.9.6 → lumera-0.9.8}/lumera/_utils.py

@@ -19,6 +19,8 @@ from dotenv import load_dotenv
 TOKEN_ENV = "LUMERA_TOKEN"
 BASE_URL_ENV = "LUMERA_BASE_URL"
 ENV_PATH = "/root/.env"
+LOCAL_CREDS_PATH = ".lumera/credentials.json"
+GLOBAL_CREDS_PATH = os.path.join(os.path.expanduser("~"), ".config", "lumera", "credentials.json")
 
 load_dotenv(override=False)
 load_dotenv(ENV_PATH, override=False)
@@ -56,12 +58,47 @@ def _get_session() -> requests.Session:
     return _http_session
 
 
+def _read_token_from_creds_file(path: str) -> str | None:
+    """Read token from a credentials.json file."""
+    try:
+        if os.path.exists(path):
+            with open(path, "r") as f:
+                creds = json.load(f)
+                return creds.get("token")
+    except (json.JSONDecodeError, IOError):
+        pass
+    return None
+
+
 def get_lumera_token() -> str:
+    """Get Lumera API token from environment or credentials files.
+
+    Priority:
+    1. LUMERA_TOKEN environment variable
+    2. .lumera/credentials.json (project-local, from CLI login --local)
+    3. ~/.config/lumera/credentials.json (global, from CLI login)
+    4. /root/.env (legacy, for automations in sandbox)
+    """
+    # 1. Check environment variable (highest priority)
     token = os.getenv(TOKEN_ENV)
     if token:
         return token
+
+    # 2. Check project-local credentials
+    token = _read_token_from_creds_file(LOCAL_CREDS_PATH)
+    if token:
+        return token
+
+    # 3. Check global credentials
+    token = _read_token_from_creds_file(GLOBAL_CREDS_PATH)
+    if token:
+        return token
+
+    # 4. /root/.env is already loaded via dotenv at module load time
+    # so if we get here, no token was found anywhere
     raise RuntimeError(
-        f"{TOKEN_ENV} environment variable not set (checked environment and {ENV_PATH})"
+        f"{TOKEN_ENV} not found. Checked: environment, {LOCAL_CREDS_PATH}, {GLOBAL_CREDS_PATH}, {ENV_PATH}. "
+        f"Run `lumera login` to authenticate."
     )
 
 

{lumera-0.9.6 → 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.6 → lumera-0.9.8}/lumera.egg-info/PKG-INFO

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

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

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