lumera 0.10.0__tar.gz → 0.10.1__tar.gz

{lumera-0.10.0 → lumera-0.10.1}/PKG-INFO

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

{lumera-0.10.0 → lumera-0.10.1}/lumera/automations.py

@@ -64,6 +64,7 @@ __all__ = [
     # Classes
     "Run",
     "Automation",
+    "LogEntry",
     "LogsResponse",
 ]
 
@@ -71,6 +72,67 @@ from ._utils import LumeraAPIError, _api_request
 from .sdk import get_automation_run as _get_automation_run
 from .sdk import run_automation as _run_automation
 
+# ============================================================================
+# LogEntry Class
+# ============================================================================
+
+
+class LogEntry:
+    """A single log entry from an automation run.
+
+    Attributes:
+        content: The log message content.
+        type: Log type ("stream_stdout", "stream_stderr", "warning", "image_png", "image_jpeg").
+        timestamp: ISO timestamp when the log was emitted.
+        error: True if this is an error entry.
+    """
+
+    def __init__(self, data: dict[str, Any]) -> None:
+        self._data = data
+
+    @property
+    def content(self) -> str:
+        return self._data.get("content", "")
+
+    @property
+    def type(self) -> str:
+        return self._data.get("type", "")
+
+    @property
+    def timestamp(self) -> str | None:
+        return self._data.get("timestamp")
+
+    @property
+    def error(self) -> bool:
+        return self._data.get("error", False)
+
+    @property
+    def is_image(self) -> bool:
+        """True if this entry contains image data (base64 encoded in content)."""
+        return self.type in ("image_png", "image_jpeg")
+
+    def __repr__(self) -> str:
+        preview = self.content[:50] + "..." if len(self.content) > 50 else self.content
+        return f"LogEntry(type={self.type!r}, content={preview!r})"
+
+
+def _parse_ndjson_entries(data: str) -> list[LogEntry]:
+    """Parse NDJSON log data into LogEntry objects."""
+    entries = []
+    for line in data.splitlines():
+        line = line.strip()
+        if not line:
+            continue
+        try:
+            parsed = json.loads(line)
+            if isinstance(parsed, dict):
+                entries.append(LogEntry(parsed))
+        except (json.JSONDecodeError, ValueError):
+            # Skip malformed lines or lines with huge numbers
+            pass
+    return entries
+
+
 # ============================================================================
 # LogsResponse Class
 # ============================================================================
@@ -81,6 +143,7 @@ class LogsResponse:
 
     Attributes:
         data: Raw log content as a string (NDJSON format).
+        entries: Parsed log entries as LogEntry objects.
         offset: Byte offset where this chunk starts.
         size: Number of bytes in this chunk.
         total_size: Total size of the log file.
@@ -91,11 +154,20 @@ class LogsResponse:
 
     def __init__(self, data: dict[str, Any]) -> None:
         self._data = data
+        self._entries: list[LogEntry] | None = None
 
     @property
     def data(self) -> str:
+        """Raw NDJSON log content."""
         return self._data.get("data", "")
 
+    @property
+    def entries(self) -> list[LogEntry]:
+        """Parsed log entries. Lazily parsed from NDJSON data."""
+        if self._entries is None:
+            self._entries = _parse_ndjson_entries(self.data)
+        return self._entries
+
     @property
     def offset(self) -> int:
         return self._data.get("offset", 0)
@@ -342,7 +414,7 @@ class Run:
             raise ValueError("Cannot fetch logs without run id")
         return get_logs(self.id, offset=offset, limit=limit, all=all)
 
-    def stream_logs(self, *, timeout: float = 30) -> Iterator[str]:
+    def stream_logs(self, *, timeout: float = 30) -> Iterator[LogEntry]:
         """Stream logs from this run.
 
         Works for both live (running) and archived (completed) runs.
@@ -353,12 +425,12 @@ class Run:
             timeout: HTTP connection timeout in seconds.
 
         Yields:
-            Log lines as strings (raw NDJSON lines).
+            LogEntry objects with content, type, timestamp, and error fields.
 
         Example:
             >>> run = automations.run("automation_id", inputs={})
-            >>> for line in run.stream_logs():
-            ...     print(line)
+            >>> for entry in run.stream_logs():
+            ...     print(f"[{entry.type}] {entry.content}")
         """
         if not self.id:
             raise ValueError("Cannot stream logs without run id")
@@ -912,11 +984,11 @@ def delete(automation_id: str) -> None:
 # ============================================================================
 
 
-def stream_logs(run_id: str, *, timeout: float = 30) -> Iterator[str]:
+def stream_logs(run_id: str, *, timeout: float = 30) -> Iterator[LogEntry]:
     """Stream logs from an automation run.
 
     Works for both live (running) and archived (completed) runs.
-    Connects to the server-sent events endpoint and yields log lines
+    Connects to the server-sent events endpoint and yields LogEntry objects
     as they arrive. For live runs, streams in real-time. For archived
     runs, streams the entire log from storage.
 
@@ -925,11 +997,11 @@ def stream_logs(run_id: str, *, timeout: float = 30) -> Iterator[str]:
         timeout: HTTP connection timeout in seconds.
 
     Yields:
-        Log lines as strings (raw NDJSON lines).
+        LogEntry objects with content, type, timestamp, and error fields.
 
     Example:
-        >>> for line in automations.stream_logs("run_id"):
-        ...     print(line)
+        >>> for entry in automations.stream_logs("run_id"):
+        ...     print(f"[{entry.type}] {entry.content}")
     """
     import base64
     import os
@@ -971,10 +1043,20 @@ def stream_logs(run_id: str, *, timeout: float = 30) -> Iterator[str]:
                     try:
                         data = json.loads(current_data)
                         if "data" in data:
-                            # Data is base64-encoded
+                            # Data is base64-encoded NDJSON
                             raw = base64.b64decode(data["data"])
                             decoded = raw.decode("utf-8", errors="replace")
-                            yield from decoded.splitlines()
+                            for ndjson_line in decoded.splitlines():
+                                ndjson_line = ndjson_line.strip()
+                                if not ndjson_line:
+                                    continue
+                                try:
+                                    entry_data = json.loads(ndjson_line)
+                                    if isinstance(entry_data, dict):
+                                        yield LogEntry(entry_data)
+                                except (json.JSONDecodeError, ValueError):
+                                    # Skip malformed lines or lines with huge numbers
+                                    pass
                     except (json.JSONDecodeError, KeyError):
                         pass
                 elif current_event == "complete":

{lumera-0.10.0 → lumera-0.10.1}/lumera.egg-info/PKG-INFO

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

{lumera-0.10.0 → lumera-0.10.1}/pyproject.toml

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