log-foundry 0.10.2.dev8__tar.gz → 0.10.2.dev9__tar.gz

{log_foundry-0.10.2.dev8 → log_foundry-0.10.2.dev9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: log-foundry
-Version: 0.10.2.dev8
+Version: 0.10.2.dev9
 Summary: Generate logs for your console and JSON events for downstream consumption.
 License-Expression: MIT
 License-File: LICENSE

{log_foundry-0.10.2.dev8 → log_foundry-0.10.2.dev9}/pyproject.toml

@@ -20,7 +20,7 @@ dependencies = [
 ]
 
 # Optional features. Install with: pip install log-foundry[aws]
-version = "0.10.2.dev8"
+version = "0.10.2.dev9"
 
 [project.optional-dependencies]
 aws = ["boto3>=1.43.61"]              # SQSSink, SNSSink, KinesisSink, FirehoseSink

{log_foundry-0.10.2.dev8 → log_foundry-0.10.2.dev9}/src/log_foundry/api.py

@@ -12,7 +12,7 @@ the sink via the normal path.
 
 from __future__ import annotations
 
-from log_foundry import context
+from log_foundry import _diag, context
 from log_foundry.config import _ensure_sink
 from log_foundry.console import ConsoleWriter
 from log_foundry.context import set_baggage
@@ -40,9 +40,16 @@ def _log(level: str, message: str, echo: bool, fields: dict[str, object]) -> Non
     With no active span (orphan) it becomes a standalone one-event span — fresh ``trace_id``,
     ``parent_span_id=None`` — flushed directly so nothing is dropped (FR-004). ``echo`` writes
     the same event as a human-readable console line, additively.
+
+    The orphan branch is the one that reaches the sink **on the caller's own thread**, with no
+    worker between them to absorb a failure, so it is guarded end to end (SPEC-025 FR-003): a
+    bare ``log_foundry.info(...)`` must not hand the application a ``ConnectionError`` from a
+    destination the application never chose to talk to. The in-span branch is deliberately left
+    untouched — it only appends to a list, and FR-003 requires no behaviour change there.
     """
     baggage = context.get_baggage()
     span = context.current_span()
+    event: dict[str, object] | None = None
     if span is not None:
         event = build_event(span, level, message, fields=fields, baggage=baggage)
         span.events.append(event)
@@ -51,17 +58,29 @@ def _log(level: str, message: str, echo: bool, fields: dict[str, object]) -> Non
         # log is recorded, not silently dropped. Resolve the sink via _ensure_sink (as the
         # decorator does) so a zero-config orphan log falls back to StdoutSink instead of
         # crashing. SPEC-004's worker will later own this direct handoff.
-        orphan = Span(
-            trace_id=new_trace_id(),
-            span_id=new_span_id(),
-            parent_span_id=None,
-            name=message,
-            start_ts=0.0,
-        )
-        event = build_event(orphan, level, message, fields=fields, baggage=baggage)
-        _ensure_sink().emit([event])
-    if echo:
-        _console.write(event)
+        try:
+            orphan = Span(
+                trace_id=new_trace_id(),
+                span_id=new_span_id(),
+                parent_span_id=None,
+                name=message,
+                start_ts=0.0,
+            )
+            event = build_event(orphan, level, message, fields=fields, baggage=baggage)
+            _ensure_sink().emit([event])
+        except Exception as exc:
+            # The whole branch, not just `emit`: `_ensure_sink` constructs the sink on first
+            # use, so a sink that fails to *build* raises here too — and that is the shape the
+            # spec's own motivating case takes.
+            _diag.absorbed("emitting an orphan log", exc, "the event was lost")
+    if echo and event is not None:
+        try:
+            _console.write(event)
+        except Exception as exc:
+            # An echo is a diagnostic convenience and must not outrank the caller: the stream
+            # may be closed, redirected, or gone at interpreter shutdown. It runs *after* the
+            # emit, so a broken console never costs the event itself.
+            _diag.absorbed("echoing to the console", exc)
 
 
 def debug(message: str, *, echo: bool = False, **fields: object) -> None: