Release v3.14.0 (#999)

Author: alexmojaki

CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release Notes
 
+## [v3.14.0] (2025-04-11)
+
+* Experimental functions for recording feedback annotations
+
 ## [v3.13.1] (2025-04-10)
 
 * Upgrade to OpenTelemetry SDK 1.32.0 by @alexmojaki in [#991](https://github.com/pydantic/logfire/pull/991)
@@ -668,3 +672,4 @@ First release from new repo!
 [v3.12.0]: https://github.com/pydantic/logfire/compare/v3.11.0...v3.12.0
 [v3.13.0]: https://github.com/pydantic/logfire/compare/v3.12.0...v3.13.0
 [v3.13.1]: https://github.com/pydantic/logfire/compare/v3.13.0...v3.13.1
+[v3.14.0]: https://github.com/pydantic/logfire/compare/v3.13.1...v3.14.0

logfire-api/logfire_api/experimental/annotations.pyi

@@ -0,0 +1,29 @@
+import logfire
+from _typeshed import Incomplete
+from logfire._internal.constants import ATTRIBUTES_MESSAGE_KEY as ATTRIBUTES_MESSAGE_KEY, ATTRIBUTES_SPAN_TYPE_KEY as ATTRIBUTES_SPAN_TYPE_KEY, DISABLE_CONSOLE_KEY as DISABLE_CONSOLE_KEY
+from logfire.propagate import attach_context as attach_context
+from opentelemetry.trace import Span
+from typing import Any
+
+TRACEPARENT_PROPAGATOR: Incomplete
+TRACEPARENT_NAME: str
+feedback_logfire: Incomplete
+
+def get_traceparent(span: Span | logfire.LogfireSpan) -> str:
+    """Get a string representing the span context to use for annotating spans."""
+def raw_annotate_span(traceparent: str, span_name: str, message: str, attributes: dict[str, Any]) -> None:
+    """Create a span of kind 'annotation' as a child of the span with the given traceparent."""
+def record_feedback(traceparent: str, name: str, value: int | float | bool | str, comment: str | None = None, extra: dict[str, Any] | None = None) -> None:
+    """Attach feedback to a span.
+
+    This is a more structured version of `raw_annotate_span`
+    with special attributes recognized by the Logfire UI.
+
+    Args:
+        traceparent: The traceparent string.
+        name: The name of the evaluation.
+        value: The value of the evaluation.
+            Numbers are interpreted as scores, strings as labels, and booleans as assertions.
+        comment: An optional reason for the evaluation.
+        extra: Optional additional attributes to include in the span.
+    """

logfire-api/logfire_api/propagate.pyi

@@ -37,7 +37,7 @@ def get_context() -> ContextCarrier:
     ...
     ```
     """
-def attach_context(carrier: ContextCarrier, *, third_party: bool = False) -> Iterator[None]:
+def attach_context(carrier: ContextCarrier, *, third_party: bool = False, propagator: TextMapPropagator | None = None) -> Iterator[None]:
     """Attach a context as generated by [`get_context`][logfire.propagate.get_context] to the current execution context.
 
     Since `attach_context` is a context manager, it restores the previous context when exiting.

logfire-api/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "logfire-api"
-version = "3.13.1"
+version = "3.14.0"
 description = "Shim for the Logfire SDK which does nothing unless Logfire is installed"
 authors = [
     { name = "Pydantic Team", email = "[email protected]" },

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "logfire"
-version = "3.13.1"
+version = "3.14.0"
 description = "The best Python observability tool! 🪵🔥"
 requires-python = ">=3.8"
 authors = [