lmnr 0.4.37__py3-none-any.whl → 0.4.39__py3-none-any.whl

lmnr/sdk/decorators.py

@@ -20,7 +20,6 @@ R = TypeVar("R")
 def observe(
     *,
     name: Optional[str] = None,
-    user_id: Optional[str] = None,
     session_id: Optional[str] = None,
 ) -> Callable[[Callable[P, R]], Callable[P, R]]:
     """The main decorator entrypoint for Laminar. This is used to wrap
@@ -30,9 +29,6 @@ def observe(
         name (Optional[str], optional): Name of the span. Function
                         name is used if not specified.
                         Defaults to None.
-        user_id (Optional[str], optional): User ID to associate
-                        with the span and the following context.
-                        Defaults to None.
         session_id (Optional[str], optional): Session ID to associate with the
                         span and the following context. Defaults to None.
 
@@ -49,13 +45,9 @@ def observe(
         if current_span != INVALID_SPAN:
             if session_id is not None:
                 current_span.set_attribute(SESSION_ID, session_id)
-            if user_id is not None:
-                current_span.set_attribute(USER_ID, user_id)
         association_properties = {}
         if session_id is not None:
             association_properties["session_id"] = session_id
-        if user_id is not None:
-            association_properties["user_id"] = user_id
         update_association_properties(association_properties)
         return (
             aentity_method(name=name)(func)

lmnr/sdk/laminar.py

@@ -36,7 +36,6 @@ from lmnr.openllmetry_sdk.tracing.attributes import (
     SPAN_OUTPUT,
     SPAN_PATH,
     TRACE_TYPE,
-    USER_ID,
 )
 from lmnr.openllmetry_sdk.tracing.tracing import (
     get_span_path,
@@ -588,7 +587,6 @@ class Laminar:
     def set_session(
         cls,
         session_id: Optional[str] = None,
-        user_id: Optional[str] = None,
     ):
         """Set the session and user id for the current span and the context
         (i.e. any children spans created from the current span in the current
@@ -599,29 +597,18 @@ class Laminar:
                             Useful to debug and group long-running\
                             sessions/conversations.
                             Defaults to None.
-            user_id (Optional[str], optional). Deprecated.\
-                            Use `Laminar.set_metadata` instead.\
-                            Custom user id.\
-                            Useful for grouping spans or traces by user.\
-                            Defaults to None.
         """
         association_properties = {}
         if session_id is not None:
             association_properties[SESSION_ID] = session_id
-        if user_id is not None:
-            cls.__logger.warning(
-                "User ID in set_session is deprecated and will be removed soon. "
-                "Please use `Laminar.set_metadata` instead."
-            )
-            association_properties["metadata." + USER_ID] = user_id
         update_association_properties(association_properties)
 
     @classmethod
-    def set_metadata(cls, metadata: dict[str, Any]):
+    def set_metadata(cls, metadata: dict[str, str]):
         """Set the metadata for the current trace.
 
         Args:
-            metadata (dict[str, Any]): Metadata to set for the trace. Willl be\
+            metadata (dict[str, str]): Metadata to set for the trace. Willl be\
                 sent as attributes, so must be json serializable.
         """
         props = {f"metadata.{k}": json_dumps(v) for k, v in metadata.items()}

{lmnr-0.4.37.dist-info → lmnr-0.4.39.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: lmnr
-Version: 0.4.37
+Version: 0.4.39
 Summary: Python SDK for Laminar AI
 License: Apache-2.0
 Author: lmnr.ai
@@ -12,6 +12,32 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Provides-Extra: alephalpha
+Provides-Extra: all
+Provides-Extra: anthropic
+Provides-Extra: bedrock
+Provides-Extra: chromadb
+Provides-Extra: cohere
+Provides-Extra: google-generativeai
+Provides-Extra: groq
+Provides-Extra: haystack
+Provides-Extra: lancedb
+Provides-Extra: langchain
+Provides-Extra: llamaindex
+Provides-Extra: marqo
+Provides-Extra: milvus
+Provides-Extra: mistralai
+Provides-Extra: ollama
+Provides-Extra: openai
+Provides-Extra: pinecone
+Provides-Extra: qdrant
+Provides-Extra: replicate
+Provides-Extra: sagemaker
+Provides-Extra: together
+Provides-Extra: transformers
+Provides-Extra: vertexai
+Provides-Extra: watsonx
+Provides-Extra: weaviate
 Requires-Dist: argparse (>=1.0,<2.0)
 Requires-Dist: backoff (>=2.0,<3.0)
 Requires-Dist: deprecated (>=1.0,<2.0)
@@ -19,35 +45,35 @@ Requires-Dist: jinja2 (>=3.0,<4.0)
 Requires-Dist: opentelemetry-api (>=1.28.0)
 Requires-Dist: opentelemetry-exporter-otlp-proto-grpc (>=1.28.0)
 Requires-Dist: opentelemetry-exporter-otlp-proto-http (>=1.28.0)
-Requires-Dist: opentelemetry-instrumentation-alephalpha (>=0.33.10)
-Requires-Dist: opentelemetry-instrumentation-anthropic (>=0.33.10)
-Requires-Dist: opentelemetry-instrumentation-bedrock (>=0.33.10)
-Requires-Dist: opentelemetry-instrumentation-chromadb (>=0.33.10)
-Requires-Dist: opentelemetry-instrumentation-cohere (>=0.33.10)
-Requires-Dist: opentelemetry-instrumentation-google-generativeai (>=0.33.10)
-Requires-Dist: opentelemetry-instrumentation-groq (>=0.33.10)
-Requires-Dist: opentelemetry-instrumentation-haystack (>=0.33.10)
-Requires-Dist: opentelemetry-instrumentation-lancedb (>=0.33.10)
-Requires-Dist: opentelemetry-instrumentation-langchain (>=0.33.10)
-Requires-Dist: opentelemetry-instrumentation-llamaindex (>=0.33.10)
-Requires-Dist: opentelemetry-instrumentation-marqo (>=0.33.10)
-Requires-Dist: opentelemetry-instrumentation-milvus (>=0.33.10)
-Requires-Dist: opentelemetry-instrumentation-mistralai (>=0.33.10)
-Requires-Dist: opentelemetry-instrumentation-ollama (>=0.33.10)
-Requires-Dist: opentelemetry-instrumentation-openai (>=0.33.10)
-Requires-Dist: opentelemetry-instrumentation-pinecone (>=0.33.10)
-Requires-Dist: opentelemetry-instrumentation-qdrant (>=0.33.10)
-Requires-Dist: opentelemetry-instrumentation-replicate (>=0.33.10)
+Requires-Dist: opentelemetry-instrumentation-alephalpha (>=0.33.12) ; extra == "all" or extra == "alephalpha"
+Requires-Dist: opentelemetry-instrumentation-anthropic (>=0.33.12) ; extra == "all" or extra == "anthropic"
+Requires-Dist: opentelemetry-instrumentation-bedrock (>=0.33.12) ; extra == "all" or extra == "bedrock"
+Requires-Dist: opentelemetry-instrumentation-chromadb (>=0.33.12) ; extra == "all" or extra == "chromadb"
+Requires-Dist: opentelemetry-instrumentation-cohere (>=0.33.12) ; extra == "all" or extra == "cohere"
+Requires-Dist: opentelemetry-instrumentation-google-generativeai (>=0.33.12) ; extra == "all" or extra == "google-generativeai"
+Requires-Dist: opentelemetry-instrumentation-groq (>=0.33.12) ; extra == "all" or extra == "groq"
+Requires-Dist: opentelemetry-instrumentation-haystack (>=0.33.12) ; extra == "all" or extra == "haystack"
+Requires-Dist: opentelemetry-instrumentation-lancedb (>=0.33.12) ; extra == "all" or extra == "lancedb"
+Requires-Dist: opentelemetry-instrumentation-langchain (>=0.33.12) ; extra == "all" or extra == "langchain"
+Requires-Dist: opentelemetry-instrumentation-llamaindex (>=0.33.12) ; extra == "all" or extra == "llamaindex"
+Requires-Dist: opentelemetry-instrumentation-marqo (>=0.33.12) ; extra == "all" or extra == "marqo"
+Requires-Dist: opentelemetry-instrumentation-milvus (>=0.33.12) ; extra == "all" or extra == "milvus"
+Requires-Dist: opentelemetry-instrumentation-mistralai (>=0.33.12) ; extra == "all" or extra == "mistralai"
+Requires-Dist: opentelemetry-instrumentation-ollama (>=0.33.12) ; extra == "all" or extra == "ollama"
+Requires-Dist: opentelemetry-instrumentation-openai (>=0.33.12) ; extra == "all" or extra == "openai"
+Requires-Dist: opentelemetry-instrumentation-pinecone (>=0.33.12) ; extra == "all" or extra == "pinecone"
+Requires-Dist: opentelemetry-instrumentation-qdrant (>=0.33.12) ; extra == "all" or extra == "qdrant"
+Requires-Dist: opentelemetry-instrumentation-replicate (>=0.33.12) ; extra == "all" or extra == "replicate"
 Requires-Dist: opentelemetry-instrumentation-requests (>=0.49b0,<0.50)
-Requires-Dist: opentelemetry-instrumentation-sagemaker (>=0.33.10)
+Requires-Dist: opentelemetry-instrumentation-sagemaker (>=0.33.12) ; extra == "all" or extra == "sagemaker"
 Requires-Dist: opentelemetry-instrumentation-sqlalchemy (>=0.49b0,<0.50)
 Requires-Dist: opentelemetry-instrumentation-threading (>=0.49b0,<0.50)
-Requires-Dist: opentelemetry-instrumentation-together (>=0.33.10)
-Requires-Dist: opentelemetry-instrumentation-transformers (>=0.33.10)
+Requires-Dist: opentelemetry-instrumentation-together (>=0.33.12) ; extra == "all" or extra == "together"
+Requires-Dist: opentelemetry-instrumentation-transformers (>=0.33.12) ; extra == "all" or extra == "transformers"
 Requires-Dist: opentelemetry-instrumentation-urllib3 (>=0.49b0,<0.50)
-Requires-Dist: opentelemetry-instrumentation-vertexai (>=0.33.10)
-Requires-Dist: opentelemetry-instrumentation-watsonx (>=0.33.10)
-Requires-Dist: opentelemetry-instrumentation-weaviate (>=0.33.10)
+Requires-Dist: opentelemetry-instrumentation-vertexai (>=0.33.12) ; extra == "all" or extra == "vertexai"
+Requires-Dist: opentelemetry-instrumentation-watsonx (>=0.33.12) ; extra == "all" or extra == "watsonx"
+Requires-Dist: opentelemetry-instrumentation-weaviate (>=0.33.12) ; extra == "all" or extra == "weaviate"
 Requires-Dist: opentelemetry-sdk (>=1.28.0)
 Requires-Dist: opentelemetry-semantic-conventions-ai (==0.4.2)
 Requires-Dist: pydantic (>=2.7,<3.0)
@@ -72,23 +98,28 @@ Check our [open-source repo](https://github.com/lmnr-ai/lmnr) and don't forget t
 
 ## Quickstart
 
-First, install the package:
+First, install the package, specifying the instrumentations you want to use.
+
+For example, to install the package with OpenAI and Anthropic instrumentations:
 
 ```sh
-pip install lmnr
+pip install 'lmnr[anthropic,openai]'
 ```
 
-And then in the code
+To install all possible instrumentations, use the following command:
+
+```sh
+pip install 'lmnr[all]'
+```
+
+Initialize Laminar in your code:
 
 ```python
-from lmnr import Laminar as L
+from lmnr import Laminar
 
-L.initialize(project_api_key="<PROJECT_API_KEY>")
+Laminar.initialize(project_api_key="<PROJECT_API_KEY>")
 ```
 
-This will automatically instrument most of the LLM, Vector DB, and related
-calls with OpenTelemetry-compatible instrumentation.
-
 Note that you need to only initialize Laminar once in your application.
 
 ## Instrumentation
@@ -101,9 +132,9 @@ This can be useful if you want to trace a request handler or a function which co
 ```python
 import os
 from openai import OpenAI
-from lmnr import Laminar as L, Instruments
+from lmnr import Laminar
 
-L.initialize(project_api_key=os.environ["LMNR_PROJECT_API_KEY"])
+Laminar.initialize(project_api_key=os.environ["LMNR_PROJECT_API_KEY"])
 
 client = OpenAI(api_key=os.environ["OPENAI_API_KEY"])
 
@@ -126,9 +157,7 @@ def poem_writer(topic: str):
 @observe()
 def generate_poems():
     poem1 = poem_writer(topic="laminar flow")
-    L.event("is_poem_generated", True)
     poem2 = poem_writer(topic="turbulence")
-    L.event("is_poem_generated", True)
     poems = f"{poem1}\n\n---\n\n{poem2}"
     return poems
 ```
@@ -137,18 +166,10 @@ Also, you can use `Laminar.start_as_current_span` if you want to record a chunk
 
 ```python
 def handle_user_request(topic: str):
-    with L.start_as_current_span(name="poem_writer", input=topic):
-        ...
-
+    with Laminar.start_as_current_span(name="poem_writer", input=topic):
         poem = poem_writer(topic=topic)
-        
-        ...
-        
-        # while within the span, you can attach laminar events to it
-        L.event("is_poem_generated", True)
-
         # Use set_span_output to record the output of the span
-        L.set_span_output(poem)
+        Laminar.set_span_output(poem)
 ```
 
 ### Automatic instrumentation
@@ -163,9 +184,9 @@ calls with OpenTelemetry-compatible instrumentation, then pass the appropriate i
 For example, if you want to only instrument OpenAI and Anthropic, then do the following:
 
 ```python
-from lmnr import Laminar as L, Instruments
+from lmnr import Laminar, Instruments
 
-L.initialize(project_api_key=os.environ["LMNR_PROJECT_API_KEY"], instruments={Instruments.OPENAI, Instruments.ANTHROPIC})
+Laminar.initialize(project_api_key=os.environ["LMNR_PROJECT_API_KEY"], instruments={Instruments.OPENAI, Instruments.ANTHROPIC})
 ```
 
 If you want to fully disable any kind of autoinstrumentation, pass an empty set as `instruments=set()` to `.initialize()`. 
@@ -246,11 +267,11 @@ Once your pipeline target is set, you can call it from Python in just a few line
 Example use:
 
 ```python
-from lmnr import Laminar as L
+from lmnr import Laminar
 
-L.initialize('<YOUR_PROJECT_API_KEY>', instruments=set())
+Laminar.initialize('<YOUR_PROJECT_API_KEY>', instruments=set())
 
-result = l.run(
+result = Laminar.run(
     pipeline = 'my_pipeline_name',
     inputs = {'input_node_name': 'some_value'},
     # all environment variables

{lmnr-0.4.37.dist-info → lmnr-0.4.39.dist-info}/RECORD

@@ -19,14 +19,14 @@ lmnr/openllmetry_sdk/utils/package_check.py,sha256=Ki74WZME-ASF0fx7RXSIMsULGYUzI
 lmnr/openllmetry_sdk/version.py,sha256=OlatFEFA4ttqSSIiV8jdE-sq3KG5zu2hnC4B4mzWF3s,23
 lmnr/sdk/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 lmnr/sdk/datasets.py,sha256=w8U9E6fvetAo65Cb2CbYzlfhY8CfXAR-VysrakG6-4I,1591
-lmnr/sdk/decorators.py,sha256=kH7wNmxahNYu8DieodQrf3DyNtzEoxt0XB7LErGkn8k,2256
+lmnr/sdk/decorators.py,sha256=6F2Z9ElNe_-9Y3PxRmKK5LKCHWfzTgMSNR3RFLAsg6c,1865
 lmnr/sdk/evaluations.py,sha256=rz92RKam5bWTj-w-c2ZTdsK6Bl7KSxW5UarBjG472Mc,16268
-lmnr/sdk/laminar.py,sha256=k5vxPdS4IN48M-k-JqGK2VPuAD6kvzhOLjEZcOuW8b8,27443
+lmnr/sdk/laminar.py,sha256=0wZE0gDq8eEx4zOTNuLuD--tY9DNSBGldo8158cfxmY,26810
 lmnr/sdk/log.py,sha256=cZBeUoSK39LMEV-X4-eEhTWOciULRfHaKfRK8YqIM8I,1532
 lmnr/sdk/types.py,sha256=qGD1tkGszd-_sZJaZ_Zx9U_CdUYzoDkUeN2g-o48Gls,5588
 lmnr/sdk/utils.py,sha256=Uk8y15x-sd5tP2ERONahElLDJVEy_3dA_1_5g9A6auY,3358
-lmnr-0.4.37.dist-info/LICENSE,sha256=67b_wJHVV1CBaWkrKFWU1wyqTPSdzH77Ls-59631COg,10411
-lmnr-0.4.37.dist-info/METADATA,sha256=pvk3QWPbv584qCSV8M30cozvymsaBz-4wG5CXDG9PvU,10372
-lmnr-0.4.37.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
-lmnr-0.4.37.dist-info/entry_points.txt,sha256=K1jE20ww4jzHNZLnsfWBvU3YKDGBgbOiYG5Y7ivQcq4,37
-lmnr-0.4.37.dist-info/RECORD,,
+lmnr-0.4.39.dist-info/LICENSE,sha256=67b_wJHVV1CBaWkrKFWU1wyqTPSdzH77Ls-59631COg,10411
+lmnr-0.4.39.dist-info/METADATA,sha256=gmRAMfYV6a9AaafaoM2cIt0Gcsi0IevZGUltuSTjbOs,11938
+lmnr-0.4.39.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
+lmnr-0.4.39.dist-info/entry_points.txt,sha256=K1jE20ww4jzHNZLnsfWBvU3YKDGBgbOiYG5Y7ivQcq4,37
+lmnr-0.4.39.dist-info/RECORD,,