lmnr 0.6.20__tar.gz → 0.7.0__tar.gz

{lmnr-0.6.20 → lmnr-0.7.0}/PKG-INFO

@@ -1,32 +1,38 @@
 Metadata-Version: 2.4
 Name: lmnr
-Version: 0.6.20
+Version: 0.7.0
 Summary: Python SDK for Laminar
 Author: lmnr.ai
 Author-email: lmnr.ai <founders@lmnr.ai>
 License-Expression: Apache-2.0
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Requires-Dist: pydantic>=2.0.3,<3.0.0
 Requires-Dist: python-dotenv>=1.0
 Requires-Dist: opentelemetry-api>=1.33.0
 Requires-Dist: opentelemetry-sdk>=1.33.0
 Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.33.0
 Requires-Dist: opentelemetry-exporter-otlp-proto-grpc>=1.33.0
+Requires-Dist: opentelemetry-instrumentation>=0.54b0
 Requires-Dist: opentelemetry-semantic-conventions>=0.54b0
 Requires-Dist: opentelemetry-semantic-conventions-ai>=0.4.9
 Requires-Dist: tqdm>=4.0
 Requires-Dist: tenacity>=8.0
 Requires-Dist: grpcio>=1
 Requires-Dist: httpx>=0.25.0
-Requires-Dist: opentelemetry-instrumentation-threading>=0.54b0
+Requires-Dist: orjson>=3.10.18
+Requires-Dist: packaging>=22.0
 Requires-Dist: opentelemetry-instrumentation-alephalpha>=0.40.12 ; extra == 'alephalpha'
 Requires-Dist: opentelemetry-instrumentation-alephalpha>=0.40.12 ; extra == 'all'
-Requires-Dist: opentelemetry-instrumentation-anthropic>=0.40.12 ; extra == 'all'
 Requires-Dist: opentelemetry-instrumentation-bedrock>=0.40.12 ; extra == 'all'
 Requires-Dist: opentelemetry-instrumentation-chromadb>=0.40.12 ; extra == 'all'
 Requires-Dist: opentelemetry-instrumentation-cohere>=0.40.12 ; extra == 'all'
 Requires-Dist: opentelemetry-instrumentation-crewai>=0.40.12 ; extra == 'all'
 Requires-Dist: opentelemetry-instrumentation-google-generativeai<0.40.10 ; extra == 'all'
-Requires-Dist: opentelemetry-instrumentation-groq>=0.40.12 ; extra == 'all'
 Requires-Dist: opentelemetry-instrumentation-haystack>=0.40.12 ; extra == 'all'
 Requires-Dist: opentelemetry-instrumentation-lancedb>=0.40.12 ; extra == 'all'
 Requires-Dist: opentelemetry-instrumentation-langchain>=0.40.12 ; extra == 'all'
@@ -45,13 +51,11 @@ Requires-Dist: opentelemetry-instrumentation-transformers>=0.40.12 ; extra == 'a
 Requires-Dist: opentelemetry-instrumentation-vertexai>=0.40.12 ; extra == 'all'
 Requires-Dist: opentelemetry-instrumentation-watsonx>=0.40.12 ; extra == 'all'
 Requires-Dist: opentelemetry-instrumentation-weaviate>=0.40.12 ; extra == 'all'
-Requires-Dist: opentelemetry-instrumentation-anthropic>=0.40.12 ; extra == 'anthropic'
 Requires-Dist: opentelemetry-instrumentation-bedrock>=0.40.12 ; extra == 'bedrock'
 Requires-Dist: opentelemetry-instrumentation-chromadb>=0.40.12 ; extra == 'chromadb'
 Requires-Dist: opentelemetry-instrumentation-cohere>=0.40.12 ; extra == 'cohere'
 Requires-Dist: opentelemetry-instrumentation-crewai>=0.40.12 ; extra == 'crewai'
 Requires-Dist: opentelemetry-instrumentation-google-generativeai<0.40.10 ; extra == 'google-generativeai'
-Requires-Dist: opentelemetry-instrumentation-groq>=0.40.12 ; extra == 'groq'
 Requires-Dist: opentelemetry-instrumentation-haystack>=0.40.12 ; extra == 'haystack'
 Requires-Dist: opentelemetry-instrumentation-lancedb>=0.40.12 ; extra == 'lancedb'
 Requires-Dist: opentelemetry-instrumentation-langchain>=0.40.12 ; extra == 'langchain'
@@ -73,13 +77,11 @@ Requires-Dist: opentelemetry-instrumentation-weaviate>=0.40.12 ; extra == 'weavi
 Requires-Python: >=3.10, <4
 Provides-Extra: alephalpha
 Provides-Extra: all
-Provides-Extra: anthropic
 Provides-Extra: bedrock
 Provides-Extra: chromadb
 Provides-Extra: cohere
 Provides-Extra: crewai
 Provides-Extra: google-generativeai
-Provides-Extra: groq
 Provides-Extra: haystack
 Provides-Extra: lancedb
 Provides-Extra: langchain

{lmnr-0.6.20 → lmnr-0.7.0}/pyproject.toml

@@ -6,7 +6,7 @@
 
 [project]
 name = "lmnr"
-version = "0.6.20"
+version = "0.7.0"
 description = "Python SDK for Laminar"
 authors = [
   { name = "lmnr.ai", email = "founders@lmnr.ai" }
@@ -21,6 +21,7 @@ dependencies = [
   "opentelemetry-sdk (>=1.33.0)",
   "opentelemetry-exporter-otlp-proto-http (>=1.33.0)",
   "opentelemetry-exporter-otlp-proto-grpc (>=1.33.0)",
+  "opentelemetry-instrumentation (>=0.54b0)",
   "opentelemetry-semantic-conventions (>=0.54b0)",
   "opentelemetry-semantic-conventions-ai (>=0.4.9)",
   "tqdm (>=4.0)",
@@ -36,7 +37,18 @@ dependencies = [
   # https://github.com/grpc/grpc/issues/38490
   "grpcio>=1",
   "httpx>=0.25.0",
-  "opentelemetry-instrumentation-threading>=0.54b0",
+  "orjson>=3.10.18",
+  "packaging>=22.0",
+]
+# poetry would auto-generate these based on requires-python, but other build
+# systems don't, so we need to specify them manually.
+classifiers = [
+  "License :: OSI Approved :: Apache Software License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
 ]
 
 [project.scripts]
@@ -51,7 +63,6 @@ lmnr = "lmnr.cli:cli"
 # `poetry add 'lmnr[anthropic,groq]'`
 
 alephalpha=["opentelemetry-instrumentation-alephalpha>=0.40.12"]
-anthropic=["opentelemetry-instrumentation-anthropic>=0.40.12"]
 bedrock=["opentelemetry-instrumentation-bedrock>=0.40.12"]
 chromadb=["opentelemetry-instrumentation-chromadb>=0.40.12"]
 cohere=["opentelemetry-instrumentation-cohere>=0.40.12"]
@@ -63,7 +74,6 @@ crewai=["opentelemetry-instrumentation-crewai>=0.40.12"]
 # wrapping google-genai.
 # https://github.com/traceloop/openllmetry/pull/3014
 google-generativeai=["opentelemetry-instrumentation-google-generativeai<0.40.10"]
-groq=["opentelemetry-instrumentation-groq>=0.40.12"]
 haystack=["opentelemetry-instrumentation-haystack>=0.40.12"]
 lancedb=["opentelemetry-instrumentation-lancedb>=0.40.12"]
 langchain=["opentelemetry-instrumentation-langchain>=0.40.12"]
@@ -88,14 +98,12 @@ weaviate=["opentelemetry-instrumentation-weaviate>=0.40.12"]
 # like `uv add lmnr --all-extras`
 all = [
   "opentelemetry-instrumentation-alephalpha>=0.40.12",
-  "opentelemetry-instrumentation-anthropic>=0.40.12",
   "opentelemetry-instrumentation-bedrock>=0.40.12",
   "opentelemetry-instrumentation-chromadb>=0.40.12",
   "opentelemetry-instrumentation-cohere>=0.40.12",
   "opentelemetry-instrumentation-crewai>=0.40.12",
   # See comment above on the google-generativeai extra.
   "opentelemetry-instrumentation-google-generativeai<0.40.10",
-  "opentelemetry-instrumentation-groq>=0.40.12",
   "opentelemetry-instrumentation-haystack>=0.40.12",
   "opentelemetry-instrumentation-lancedb>=0.40.12",
   "opentelemetry-instrumentation-langchain>=0.40.12",
@@ -133,10 +141,12 @@ dev = [
   "langchain-core>=0.3.64",
   "langchain>=0.3.25",
   "litellm>=1.72.6",
+  "groq>=0.30.0",
+  "anthropic>=0.57.1",
 ]
 
 [build-system]
-requires = ["uv_build>=0.7.19,<0.8"]
+requires = ["uv_build>=0.7.21,<0.8"]
 build-backend = "uv_build"
 
 [tool.uv.workspace]

{lmnr-0.6.20 → lmnr-0.7.0}/src/lmnr/__init__.py

@@ -9,7 +9,6 @@ from .sdk.types import (
     HumanEvaluator,
     RunAgentResponseChunk,
     StepChunkContent,
-    TracingLevel,
 )
 from .sdk.decorators import observe
 from .sdk.types import LaminarSpanContext
@@ -18,7 +17,6 @@ from .opentelemetry_lib.tracing.attributes import Attributes
 from .opentelemetry_lib.tracing.instruments import Instruments
 from .opentelemetry_lib.tracing.processor import LaminarSpanProcessor
 from .opentelemetry_lib.tracing.tracer import get_laminar_tracer_provider, get_tracer
-from opentelemetry.trace import use_span
 
 __all__ = [
     "AgentOutput",
@@ -36,10 +34,8 @@ __all__ = [
     "LaminarSpanProcessor",
     "RunAgentResponseChunk",
     "StepChunkContent",
-    "TracingLevel",
     "get_laminar_tracer_provider",
     "get_tracer",
     "evaluate",
     "observe",
-    "use_span",
 ]

lmnr-0.7.0/src/lmnr/opentelemetry_lib/decorators/__init__.py

@@ -0,0 +1,291 @@
+from functools import wraps
+import logging
+import pydantic
+import orjson
+import types
+from typing import Any, AsyncGenerator, Callable, Generator, Literal
+
+from opentelemetry import context as context_api
+from opentelemetry.trace import Span
+
+from lmnr.sdk.utils import get_input_from_func_args, is_method
+from lmnr.opentelemetry_lib import MAX_MANUAL_SPAN_PAYLOAD_SIZE
+from lmnr.opentelemetry_lib.tracing.tracer import get_tracer_with_context
+from lmnr.opentelemetry_lib.tracing.attributes import (
+    ASSOCIATION_PROPERTIES,
+    SPAN_INPUT,
+    SPAN_OUTPUT,
+    SPAN_TYPE,
+)
+from lmnr.opentelemetry_lib.tracing import TracerWrapper
+from lmnr.sdk.log import get_default_logger
+
+logger = get_default_logger(__name__)
+
+DEFAULT_PLACEHOLDER = {}
+
+
+def default_json(o):
+    if isinstance(o, pydantic.BaseModel):
+        return o.model_dump()
+
+    # Handle various sequence types, but not strings or bytes
+    if isinstance(o, (list, tuple, set, frozenset)):
+        return list(o)
+
+    try:
+        return str(o)
+    except Exception:
+        logger.debug("Failed to serialize data to JSON, inner type: %s", type(o))
+        pass
+    return DEFAULT_PLACEHOLDER
+
+
+def json_dumps(data: dict) -> str:
+    try:
+        return orjson.dumps(
+            data,
+            default=default_json,
+            option=orjson.OPT_SERIALIZE_DATACLASS
+            | orjson.OPT_SERIALIZE_UUID
+            | orjson.OPT_UTC_Z
+            | orjson.OPT_NON_STR_KEYS,
+        ).decode("utf-8")
+    except Exception:
+        # Log the exception and return a placeholder if serialization completely fails
+        logging.warning("Failed to serialize data to JSON, type: %s", type(data))
+        return "{}"  # Return an empty JSON object as a fallback
+
+
+def _setup_span(
+    span_name: str, span_type: str, association_properties: dict[str, Any] | None
+):
+    """Set up a span with the given name, type, and association properties."""
+    with get_tracer_with_context() as (tracer, isolated_context):
+        # Create span in isolated context
+        span = tracer.start_span(
+            span_name,
+            context=isolated_context,
+            attributes={SPAN_TYPE: span_type},
+        )
+
+        if association_properties is not None:
+            for key, value in association_properties.items():
+                span.set_attribute(f"{ASSOCIATION_PROPERTIES}.{key}", value)
+
+        return span
+
+
+def _process_input(
+    span: Span,
+    fn: Callable,
+    args: tuple,
+    kwargs: dict,
+    ignore_input: bool,
+    ignore_inputs: list[str] | None,
+    input_formatter: Callable[..., str] | None,
+):
+    """Process and set input attributes on the span."""
+    if ignore_input:
+        return
+
+    try:
+        if input_formatter is not None:
+            inp = input_formatter(*args, **kwargs)
+            if not isinstance(inp, str):
+                inp = json_dumps(inp)
+        else:
+            inp = json_dumps(
+                get_input_from_func_args(
+                    fn,
+                    is_method=is_method(fn),
+                    func_args=args,
+                    func_kwargs=kwargs,
+                    ignore_inputs=ignore_inputs,
+                )
+            )
+
+        if len(inp) > MAX_MANUAL_SPAN_PAYLOAD_SIZE:
+            span.set_attribute(SPAN_INPUT, "Laminar: input too large to record")
+        else:
+            span.set_attribute(SPAN_INPUT, inp)
+    except Exception:
+        msg = "Failed to process input, ignoring"
+        if input_formatter is not None:
+            # Only warn the user if they provided an input formatter
+            # because it's their responsibility to make sure it works.
+            logger.warning(msg, exc_info=True)
+        else:
+            logger.debug(msg, exc_info=True)
+        pass
+
+
+def _process_output(
+    span: Span,
+    result: Any,
+    ignore_output: bool,
+    output_formatter: Callable[..., str] | None,
+):
+    """Process and set output attributes on the span."""
+    if ignore_output:
+        return
+
+    try:
+        if output_formatter is not None:
+            output = output_formatter(result)
+            if not isinstance(output, str):
+                output = json_dumps(output)
+        else:
+            output = json_dumps(result)
+
+        if len(output) > MAX_MANUAL_SPAN_PAYLOAD_SIZE:
+            span.set_attribute(SPAN_OUTPUT, "Laminar: output too large to record")
+        else:
+            span.set_attribute(SPAN_OUTPUT, output)
+    except Exception:
+        msg = "Failed to process output, ignoring"
+        if output_formatter is not None:
+            # Only warn the user if they provided an output formatter
+            # because it's their responsibility to make sure it works.
+            logger.warning(msg, exc_info=True)
+        else:
+            logger.debug(msg, exc_info=True)
+        pass
+
+
+def _cleanup_span(span: Span, wrapper: TracerWrapper):
+    """Clean up span and context."""
+    span.end()
+    wrapper.pop_span_context()
+
+
+def observe_base(
+    name: str | None = None,
+    ignore_input: bool = False,
+    ignore_inputs: list[str] | None = None,
+    ignore_output: bool = False,
+    span_type: Literal["DEFAULT", "LLM", "TOOL"] = "DEFAULT",
+    association_properties: dict[str, Any] | None = None,
+    input_formatter: Callable[..., str] | None = None,
+    output_formatter: Callable[..., str] | None = None,
+):
+    def decorate(fn):
+        @wraps(fn)
+        def wrap(*args, **kwargs):
+            if not TracerWrapper.verify_initialized():
+                return fn(*args, **kwargs)
+
+            span_name = name or fn.__name__
+            wrapper = TracerWrapper()
+
+            span = _setup_span(span_name, span_type, association_properties)
+            new_context = wrapper.push_span_context(span)
+            ctx_token = context_api.attach(new_context)
+
+            _process_input(
+                span, fn, args, kwargs, ignore_input, ignore_inputs, input_formatter
+            )
+
+            try:
+                res = fn(*args, **kwargs)
+            except Exception as e:
+                _process_exception(span, e)
+                _cleanup_span(span, wrapper)
+                raise e
+            finally:
+                # Always restore global context
+                context_api.detach(ctx_token)
+
+            # span will be ended in the generator
+            if isinstance(res, types.GeneratorType):
+                return _handle_generator(span, ctx_token, res)
+            if isinstance(res, types.AsyncGeneratorType):
+                # async def foo() -> AsyncGenerator[int, None]:
+                # is not considered async in a classical sense in Python,
+                # so we handle this inside the sync wrapper.
+                # In particular, CO_COROUTINE is different from CO_ASYNC_GENERATOR.
+                # Flags are listed from LSB here:
+                # https://docs.python.org/3/library/inspect.html#inspect-module-co-flags
+                # See also: https://groups.google.com/g/python-tulip/c/6rWweGXLutU?pli=1
+                return _ahandle_generator(span, ctx_token, res)
+
+            _process_output(span, res, ignore_output, output_formatter)
+            _cleanup_span(span, wrapper)
+            return res
+
+        return wrap
+
+    return decorate
+
+
+# Async Decorators
+def async_observe_base(
+    name: str | None = None,
+    ignore_input: bool = False,
+    ignore_inputs: list[str] | None = None,
+    ignore_output: bool = False,
+    span_type: Literal["DEFAULT", "LLM", "TOOL"] = "DEFAULT",
+    association_properties: dict[str, Any] | None = None,
+    input_formatter: Callable[..., str] | None = None,
+    output_formatter: Callable[..., str] | None = None,
+):
+    def decorate(fn):
+        @wraps(fn)
+        async def wrap(*args, **kwargs):
+            if not TracerWrapper.verify_initialized():
+                return await fn(*args, **kwargs)
+
+            span_name = name or fn.__name__
+            wrapper = TracerWrapper()
+
+            span = _setup_span(span_name, span_type, association_properties)
+            new_context = wrapper.push_span_context(span)
+            ctx_token = context_api.attach(new_context)
+
+            _process_input(
+                span, fn, args, kwargs, ignore_input, ignore_inputs, input_formatter
+            )
+
+            try:
+                res = await fn(*args, **kwargs)
+            except Exception as e:
+                _process_exception(span, e)
+                _cleanup_span(span, wrapper)
+                raise e
+            finally:
+                # Always restore global context
+                context_api.detach(ctx_token)
+
+            # span will be ended in the generator
+            if isinstance(res, types.AsyncGeneratorType):
+                # probably unreachable, read the comment in the similar
+                # part of the sync wrapper.
+                return await _ahandle_generator(span, ctx_token, res)
+
+            _process_output(span, res, ignore_output, output_formatter)
+            _cleanup_span(span, wrapper)
+            return res
+
+        return wrap
+
+    return decorate
+
+
+def _handle_generator(span: Span, wrapper: TracerWrapper, res: Generator):
+    try:
+        yield from res
+    finally:
+        _cleanup_span(span, wrapper)
+
+
+async def _ahandle_generator(span: Span, wrapper: TracerWrapper, res: AsyncGenerator):
+    try:
+        async for part in res:
+            yield part
+    finally:
+        _cleanup_span(span, wrapper)
+
+
+def _process_exception(span: Span, e: Exception):
+    # Note that this `escaped` is sent as a StringValue("True"), not a boolean.
+    span.record_exception(e, escaped=True)