arize-phoenix 2.11.1__tar.gz → 3.0.1__tar.gz

{arize_phoenix-2.11.1 → arize_phoenix-3.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: arize-phoenix
-Version: 2.11.1
+Version: 3.0.1
 Summary: ML Observability in your notebook
 Project-URL: Documentation, https://docs.arize.com/phoenix/
 Project-URL: Issues, https://github.com/Arize-ai/phoenix/issues
@@ -20,6 +20,10 @@ Requires-Dist: ddsketch
 Requires-Dist: hdbscan<1.0.0,>=0.8.33
 Requires-Dist: jinja2
 Requires-Dist: numpy
+Requires-Dist: openinference-instrumentation-langchain
+Requires-Dist: openinference-instrumentation-llama-index
+Requires-Dist: openinference-instrumentation-openai
+Requires-Dist: opentelemetry-exporter-otlp
 Requires-Dist: opentelemetry-proto
 Requires-Dist: opentelemetry-sdk
 Requires-Dist: pandas
@@ -50,10 +54,10 @@ Requires-Dist: llama-index>=0.9.14; extra == 'dev'
 Requires-Dist: nbqa; extra == 'dev'
 Requires-Dist: pandas-stubs<=2.0.2.230605; extra == 'dev'
 Requires-Dist: pre-commit; extra == 'dev'
-Requires-Dist: pytest; extra == 'dev'
 Requires-Dist: pytest-asyncio; extra == 'dev'
 Requires-Dist: pytest-cov; extra == 'dev'
 Requires-Dist: pytest-lazy-fixture; extra == 'dev'
+Requires-Dist: pytest==7.4.4; extra == 'dev'
 Requires-Dist: ruff==0.1.5; extra == 'dev'
 Requires-Dist: strawberry-graphql[debug-server]==0.208.2; extra == 'dev'
 Provides-Extra: experimental
@@ -103,22 +107,22 @@ Phoenix provides MLOps and LLMOps insights at lightning speed with zero-config o
 
 **Table of Contents**
 
-- [Installation](#installation)
-- [LLM Traces](#llm-traces)
-  - [Tracing with LlamaIndex](#tracing-with-llamaindex)
-  - [Tracing with LangChain](#tracing-with-langchain)
-- [LLM Evals](#llm-evals)
-- [Embedding Analysis](#embedding-analysis)
-  - [UMAP-based Exploratory Data Analysis](#umap-based-exploratory-data-analysis)
-  - [Cluster-driven Drift and Performance Analysis](#cluster-driven-drift-and-performance-analysis)
-  - [Exportable Clusters](#exportable-clusters)
-- [Retrieval-Augmented Generation Analysis](#retrieval-augmented-generation-analysis)
-- [Structured Data Analysis](#structured-data-analysis)
-- [Deploying Phoenix](#deploying-phoenix)
-- [Breaking Changes](#breaking-changes)
-- [Community](#community)
-- [Thanks](#thanks)
-- [Copyright, Patent, and License](#copyright-patent-and-license)
+-   [Installation](#installation)
+-   [LLM Traces](#llm-traces)
+    -   [Tracing with LlamaIndex](#tracing-with-llamaindex)
+    -   [Tracing with LangChain](#tracing-with-langchain)
+-   [LLM Evals](#llm-evals)
+-   [Embedding Analysis](#embedding-analysis)
+    -   [UMAP-based Exploratory Data Analysis](#umap-based-exploratory-data-analysis)
+    -   [Cluster-driven Drift and Performance Analysis](#cluster-driven-drift-and-performance-analysis)
+    -   [Exportable Clusters](#exportable-clusters)
+-   [Retrieval-Augmented Generation Analysis](#retrieval-augmented-generation-analysis)
+-   [Structured Data Analysis](#structured-data-analysis)
+-   [Deploying Phoenix](#deploying-phoenix)
+-   [Breaking Changes](#breaking-changes)
+-   [Community](#community)
+-   [Thanks](#thanks)
+-   [Copyright, Patent, and License](#copyright-patent-and-license)
 
 ## Installation
 
@@ -219,9 +223,8 @@ session = px.launch_app()
 
 from phoenix.trace.langchain import OpenInferenceTracer, LangChainInstrumentor
 
-# If no exporter is specified, the tracer will export to the locally running Phoenix server
-tracer = OpenInferenceTracer()
-LangChainInstrumentor(tracer).instrument()
+# By default, the traces will be exported to the locally running Phoenix server.
+LangChainInstrumentor().instrument()
 
 # Initialize your LangChain application
 from langchain.chains import RetrievalQA
@@ -456,7 +459,7 @@ For more information on deploying Phoenix, see the [Phoenix Deployment Guide](ht
 
 ## Breaking Changes
 
--   **v1.0.0** - Phoenix now exclusively supports the `openai>=1.0.0` sdk. If you are using an older version of the OpenAI SDK, you can continue to use `arize-phoenix==0.1.1`. However, we recommend upgrading to the latest version of the OpenAI SDK as it contains many improvements. If you are using Phoenix with LlamaIndex and and LangChain, you will have to upgrade to the versions of these packages that support the OpenAI `1.0.0` SDK as well (`llama-index>=0.8.64`, `langchain>=0.0.334`)
+see the [migration guide](./MIGRATION.md) for a list of breaking changes.
 
 ## Community
 

{arize_phoenix-2.11.1 → arize_phoenix-3.0.1}/README.md

@@ -39,22 +39,22 @@ Phoenix provides MLOps and LLMOps insights at lightning speed with zero-config o
 
 **Table of Contents**
 
-- [Installation](#installation)
-- [LLM Traces](#llm-traces)
-  - [Tracing with LlamaIndex](#tracing-with-llamaindex)
-  - [Tracing with LangChain](#tracing-with-langchain)
-- [LLM Evals](#llm-evals)
-- [Embedding Analysis](#embedding-analysis)
-  - [UMAP-based Exploratory Data Analysis](#umap-based-exploratory-data-analysis)
-  - [Cluster-driven Drift and Performance Analysis](#cluster-driven-drift-and-performance-analysis)
-  - [Exportable Clusters](#exportable-clusters)
-- [Retrieval-Augmented Generation Analysis](#retrieval-augmented-generation-analysis)
-- [Structured Data Analysis](#structured-data-analysis)
-- [Deploying Phoenix](#deploying-phoenix)
-- [Breaking Changes](#breaking-changes)
-- [Community](#community)
-- [Thanks](#thanks)
-- [Copyright, Patent, and License](#copyright-patent-and-license)
+-   [Installation](#installation)
+-   [LLM Traces](#llm-traces)
+    -   [Tracing with LlamaIndex](#tracing-with-llamaindex)
+    -   [Tracing with LangChain](#tracing-with-langchain)
+-   [LLM Evals](#llm-evals)
+-   [Embedding Analysis](#embedding-analysis)
+    -   [UMAP-based Exploratory Data Analysis](#umap-based-exploratory-data-analysis)
+    -   [Cluster-driven Drift and Performance Analysis](#cluster-driven-drift-and-performance-analysis)
+    -   [Exportable Clusters](#exportable-clusters)
+-   [Retrieval-Augmented Generation Analysis](#retrieval-augmented-generation-analysis)
+-   [Structured Data Analysis](#structured-data-analysis)
+-   [Deploying Phoenix](#deploying-phoenix)
+-   [Breaking Changes](#breaking-changes)
+-   [Community](#community)
+-   [Thanks](#thanks)
+-   [Copyright, Patent, and License](#copyright-patent-and-license)
 
 ## Installation
 
@@ -155,9 +155,8 @@ session = px.launch_app()
 
 from phoenix.trace.langchain import OpenInferenceTracer, LangChainInstrumentor
 
-# If no exporter is specified, the tracer will export to the locally running Phoenix server
-tracer = OpenInferenceTracer()
-LangChainInstrumentor(tracer).instrument()
+# By default, the traces will be exported to the locally running Phoenix server.
+LangChainInstrumentor().instrument()
 
 # Initialize your LangChain application
 from langchain.chains import RetrievalQA
@@ -392,7 +391,7 @@ For more information on deploying Phoenix, see the [Phoenix Deployment Guide](ht
 
 ## Breaking Changes
 
--   **v1.0.0** - Phoenix now exclusively supports the `openai>=1.0.0` sdk. If you are using an older version of the OpenAI SDK, you can continue to use `arize-phoenix==0.1.1`. However, we recommend upgrading to the latest version of the OpenAI SDK as it contains many improvements. If you are using Phoenix with LlamaIndex and and LangChain, you will have to upgrade to the versions of these packages that support the OpenAI `1.0.0` SDK as well (`llama-index>=0.8.64`, `langchain>=0.0.334`)
+see the [migration guide](./MIGRATION.md) for a list of breaking changes.
 
 ## Community
 

{arize_phoenix-2.11.1 → arize_phoenix-3.0.1}/pyproject.toml

@@ -42,6 +42,10 @@ dependencies = [
   "requests",
   "opentelemetry-sdk",
   "opentelemetry-proto",
+  "opentelemetry-exporter-otlp",
+  "openinference-instrumentation-langchain",
+  "openinference-instrumentation-llama-index",
+  "openinference-instrumentation-openai",
 ]
 dynamic = ["version"]
 
@@ -53,7 +57,7 @@ dev = [
   "nbqa",
   "ruff==0.1.5",
   "pandas-stubs<=2.0.2.230605",  # version 2.0.3.230814 is causing a dependency conflict.
-  "pytest",
+  "pytest==7.4.4",
   "pytest-asyncio",
   "pytest-cov",
   "pytest-lazy-fixture",
@@ -98,7 +102,7 @@ artifacts = ["src/phoenix/server/static"]
 [tool.hatch.envs.default]
 dependencies = [
   "pandas==1.4.0",
-  "pytest",
+  "pytest==7.4.4",
   "pytest-asyncio",
   "pytest-cov",
   "pytest-lazy-fixture",

{arize_phoenix-2.11.1 → arize_phoenix-3.0.1}/src/phoenix/config.py

@@ -12,7 +12,7 @@ ENV_PHOENIX_COLLECTOR_ENDPOINT = "PHOENIX_COLLECTOR_ENDPOINT"
 The endpoint traces and evals are sent to. This must be set if the Phoenix
 server is running on a remote instance.
 """
-ENV_WORKING_DIR = "PHOENIX_WORKING_DIR"
+ENV_PHOENIX_WORKING_DIR = "PHOENIX_WORKING_DIR"
 """
 The directory in which to save, load, and export datasets. This directory must
 be accessible by both the Phoenix server and the notebook environment.
@@ -45,7 +45,7 @@ def get_working_dir() -> Path:
     """
     Get the working directory for saving, loading, and exporting datasets.
     """
-    working_dir_str = os.getenv(ENV_WORKING_DIR)
+    working_dir_str = os.getenv(ENV_PHOENIX_WORKING_DIR)
     if working_dir_str is not None:
         return Path(working_dir_str)
     # Fall back to ~/.phoenix if PHOENIX_WORKING_DIR is not set
@@ -77,7 +77,9 @@ except Exception as e:
         f"⚠️ Failed to initialize the working directory at {WORKING_DIR} due to an error: {str(e)}"
     )
     print("⚠️ While phoenix will still run, you will not be able to save, load, or export data")
-    print("ℹ️ To change, set the `{ENV_WORKING_DIR}` environment variable before importing phoenix.")
+    print(
+        f"ℹ️ To change, set the `{ENV_PHOENIX_WORKING_DIR}` environment variable before importing phoenix."  # noqa: E501
+    )
 
 
 def get_exported_files(directory: Path) -> List[Path]:

{arize_phoenix-2.11.1 → arize_phoenix-3.0.1}/src/phoenix/trace/exporter.py

@@ -9,6 +9,7 @@ from urllib.parse import urljoin
 
 import opentelemetry.proto.trace.v1.trace_pb2 as otlp
 import requests
+from opentelemetry.exporter.otlp.proto.http.trace_exporter import OTLPSpanExporter
 from requests import Session
 from typing_extensions import TypeAlias, assert_never
 
@@ -30,6 +31,19 @@ class NoOpExporter:
         pass
 
 
+class _OpenInferenceExporter(OTLPSpanExporter):
+    def __init__(self) -> None:
+        host = get_env_host()
+        if host == "0.0.0.0":
+            host = "127.0.0.1"
+        endpoint = urljoin(
+            get_env_collector_endpoint() or f"http://{host}:{get_env_port()}",
+            "/v1/traces",
+        )
+        _warn_if_phoenix_is_not_running(endpoint)
+        super().__init__(endpoint)
+
+
 class HttpExporter:
     def __init__(
         self,
@@ -62,7 +76,7 @@ class HttpExporter:
             or get_env_collector_endpoint()
             or f"http://{'127.0.0.1' if self._host == '0.0.0.0' else self._host}:{self._port}"
         )
-        self._warn_if_phoenix_is_not_running()
+        _warn_if_phoenix_is_not_running(self._base_url)
         self._session = Session()
         weakref.finalize(self, self._session.close)
         self._session.headers.update(
@@ -114,11 +128,12 @@ class HttpExporter:
         logger.exception(f"unrecognized message type: {type(message)}")
         assert_never(message)
 
-    def _warn_if_phoenix_is_not_running(self) -> None:
-        try:
-            requests.get(urljoin(self._base_url, "arize_phoenix_version")).raise_for_status()
-        except Exception:
-            logger.warning(
-                f"Arize Phoenix is not running on {self._base_url}. Launch Phoenix "
-                f"with `import phoenix as px; px.launch_app()`"
-            )
+
+def _warn_if_phoenix_is_not_running(endpoint: str) -> None:
+    try:
+        requests.get(urljoin(endpoint, "/arize_phoenix_version")).raise_for_status()
+    except Exception:
+        logger.warning(
+            f"Arize Phoenix is not running on {endpoint}. Launch Phoenix "
+            f"with `import phoenix as px; px.launch_app()`"
+        )

arize_phoenix-3.0.1/src/phoenix/trace/langchain/__init__.py

@@ -0,0 +1,26 @@
+import sys
+from typing import Any
+
+import phoenix.trace.langchain.instrumentor as _instrumentor
+import phoenix.trace.langchain.tracer as _tracer
+
+_DUMMY = "OpenInferenceTracer"
+
+
+class _Deprecation:
+    __all__ = ("LangChainInstrumentor", _DUMMY)
+
+    def __getattr__(self, name: str) -> Any:
+        if name == "tracer":
+            return _tracer
+        if name == "instrumentor":
+            return _instrumentor
+        if name == _DUMMY:
+            return getattr(_tracer, name)
+        if name == "LangChainInstrumentor":
+            return _instrumentor.LangChainInstrumentor
+        raise AttributeError(f"module {__name__} has no attribute {name}")
+
+
+# See e.g. https://stackoverflow.com/a/7668273
+sys.modules[__name__] = _Deprecation()  # type: ignore

arize_phoenix-3.0.1/src/phoenix/trace/langchain/instrumentor.py

@@ -0,0 +1,31 @@
+import logging
+from importlib.metadata import PackageNotFoundError
+from importlib.util import find_spec
+from typing import Any
+
+from openinference.instrumentation.langchain import LangChainInstrumentor as Instrumentor
+from opentelemetry.sdk import trace as trace_sdk
+from opentelemetry.sdk.trace.export import SimpleSpanProcessor
+
+from phoenix.trace.exporter import _OpenInferenceExporter
+from phoenix.trace.tracer import _show_deprecation_warnings
+
+logger = logging.getLogger(__name__)
+
+
+__all__ = ("LangChainInstrumentor",)
+
+
+class LangChainInstrumentor(Instrumentor):
+    def __init__(self, *args: Any, **kwargs: Any) -> None:
+        _show_deprecation_warnings(self, *args, **kwargs)
+        if find_spec("langchain_core") is None:
+            raise PackageNotFoundError(
+                "Missing `langchain-core`. Install with `pip install langchain-core`."
+            )
+        super().__init__()
+
+    def instrument(self) -> None:
+        tracer_provider = trace_sdk.TracerProvider()
+        tracer_provider.add_span_processor(SimpleSpanProcessor(_OpenInferenceExporter()))
+        super().instrument(skip_dep_check=True, tracer_provider=tracer_provider)

arize_phoenix-3.0.1/src/phoenix/trace/langchain/tracer.py

@@ -0,0 +1,46 @@
+"""
+This module is defunct and will be removed in the future. It's currently
+maintaining a dummy class to avoid breaking any import code.
+"""
+import logging
+import sys
+from typing import Any, Iterator
+
+from phoenix.trace.schemas import Span
+
+logger = logging.getLogger(__name__)
+
+_DUMMY = "OpenInferenceTracer"
+_DEPRECATION_MESSAGE = (
+    f"`{__name__}.{_DUMMY}` is a defunct class in the current version of Phoenix, "
+    "and will be removed in the future. For a migration guide, see "
+    "https://github.com/Arize-ai/phoenix/blob/main/MIGRATION.md"
+)
+
+
+class _DummyObject:
+    def __init__(self, *_: Any, **__: Any) -> None:
+        logger.warning(_DEPRECATION_MESSAGE)
+
+    def get_spans(self) -> Iterator[Span]:
+        logger.warning(_DEPRECATION_MESSAGE)
+        logger.warning(
+            "`.get_spans()` is a defunct method that does nothing, and will be removed "
+            "in the future. For a migration guide, see "
+            "https://github.com/Arize-ai/phoenix/blob/main/MIGRATION.md"
+        )
+        return iter(())
+
+
+class _DefunctModule:
+    __all__ = (_DUMMY,)
+
+    def __getattr__(self, name: str) -> Any:
+        if name == _DUMMY:
+            logger.warning(_DEPRECATION_MESSAGE)
+            return _DummyObject
+        raise AttributeError(f"module {__name__} has no attribute {name}")
+
+
+# See e.g. https://stackoverflow.com/a/7668273
+sys.modules[__name__] = _DefunctModule()  # type: ignore

arize_phoenix-3.0.1/src/phoenix/trace/llama_index/callback.py

@@ -0,0 +1,42 @@
+import logging
+from importlib.metadata import PackageNotFoundError
+from importlib.util import find_spec
+from typing import (
+    Any,
+)
+
+from openinference.instrumentation.llama_index._callback import (
+    OpenInferenceTraceCallbackHandler as _OpenInferenceTraceCallbackHandler,
+)
+from openinference.instrumentation.llama_index.version import (
+    __version__,
+)
+from opentelemetry import trace as trace_api
+from opentelemetry.sdk import trace as trace_sdk
+from opentelemetry.sdk.trace.export import SimpleSpanProcessor
+
+from phoenix.trace.exporter import _OpenInferenceExporter
+from phoenix.trace.tracer import _show_deprecation_warnings
+
+logger = logging.getLogger(__name__)
+
+
+class OpenInferenceTraceCallbackHandler(_OpenInferenceTraceCallbackHandler):
+    """Callback handler for storing LLM application trace data in OpenInference format.
+    OpenInference is an open standard for capturing and storing AI model
+    inferences. It enables production LLMapp servers to seamlessly integrate
+    with LLM observability solutions such as Arize and Phoenix.
+
+    For more information on the specification, see
+    https://github.com/Arize-ai/openinference
+    """
+
+    def __init__(self, *args: Any, **kwargs: Any) -> None:
+        _show_deprecation_warnings(self, *args, **kwargs)
+        if find_spec("llama_index") is None:
+            raise PackageNotFoundError(
+                "Missing `llama-index`. Install with `pip install llama-index`."
+            )
+        tracer_provider = trace_sdk.TracerProvider()
+        tracer_provider.add_span_processor(SimpleSpanProcessor(_OpenInferenceExporter()))
+        super().__init__(trace_api.get_tracer(__name__, __version__, tracer_provider))

arize_phoenix-3.0.1/src/phoenix/trace/openai/instrumentor.py

@@ -0,0 +1,26 @@
+import logging
+from importlib.metadata import PackageNotFoundError
+from importlib.util import find_spec
+from typing import Any
+
+from openinference.instrumentation.openai import OpenAIInstrumentor as Instrumentor
+from opentelemetry.sdk import trace as trace_sdk
+from opentelemetry.sdk.trace.export import SimpleSpanProcessor
+
+from phoenix.trace.exporter import _OpenInferenceExporter
+from phoenix.trace.tracer import _show_deprecation_warnings
+
+logger = logging.getLogger(__name__)
+
+
+class OpenAIInstrumentor(Instrumentor):
+    def __init__(self, *args: Any, **kwargs: Any) -> None:
+        _show_deprecation_warnings(self, *args, **kwargs)
+        if find_spec("openai") is None:
+            raise PackageNotFoundError("Missing `openai`. Install with `pip install openai`.")
+        super().__init__()
+
+    def instrument(self) -> None:
+        tracer_provider = trace_sdk.TracerProvider()
+        tracer_provider.add_span_processor(SimpleSpanProcessor(_OpenInferenceExporter()))
+        super().instrument(skip_dep_check=True, tracer_provider=tracer_provider)

{arize_phoenix-2.11.1 → arize_phoenix-3.0.1}/src/phoenix/trace/otel.py

@@ -19,6 +19,7 @@ from typing import (
     cast,
 )
 
+import numpy as np
 import opentelemetry.proto.trace.v1.trace_pb2 as otlp
 from opentelemetry.proto.common.v1.common_pb2 import AnyValue, ArrayValue, KeyValue
 from opentelemetry.util.types import Attributes, AttributeValue
@@ -320,7 +321,11 @@ def encode(span: Span) -> otlp.Span:
                 attributes[key] = json.dumps(value)
             else:
                 attributes.update(_flatten_mapping(value, key))
-        elif not isinstance(value, str) and isinstance(value, Sequence) and _has_mapping(value):
+        elif (
+            not isinstance(value, str)
+            and (isinstance(value, Sequence) or isinstance(value, np.ndarray))
+            and _has_mapping(value)
+        ):
             attributes.pop(key, None)
             attributes.update(_flatten_sequence(value, key))
 
@@ -413,6 +418,8 @@ def _encode_attributes(attributes: Attributes) -> Iterator[KeyValue]:
     if not attributes:
         return
     for key, value in attributes.items():
+        if isinstance(value, np.ndarray):
+            value = value.tolist()
         yield KeyValue(key=key, value=_encode_value(value))
 
 

arize_phoenix-3.0.1/src/phoenix/trace/tracer.py

@@ -0,0 +1,99 @@
+"""
+This module is defunct and will be removed in the future. It's currently
+maintaining a dummy class to avoid breaking any import code.
+"""
+import logging
+import sys
+from typing import Any, Iterator, Protocol
+
+from phoenix.trace.exporter import HttpExporter
+
+logger = logging.getLogger(__name__)
+
+
+class SpanExporter(Protocol):
+    def export(self, _: Any) -> None:
+        ...
+
+
+_DEFUNCT_MSG = (
+    "`phoenix.trace.tracer.Tracer` is defunct in the current version of Phoenix, "
+    "and will be removed in the future. For a migration guide, see "
+    "https://github.com/Arize-ai/phoenix/blob/main/MIGRATION.md"
+)
+
+_USE_ENV_MSG = """
+Setting the Phoenix endpoint via HttpExporter() is no longer supported.
+Please use environment variables instead:
+  - os.environ["PHOENIX_HOST"] = "127.0.0.1"
+  - os.environ["PHOENIX_PORT"] = "54321"
+  - os.environ["PHOENIX_COLLECTOR_ENDPOINT"] = "http://127.0.0.1:54321
+For a migration guide, see https://github.com/Arize-ai/phoenix/blob/main/MIGRATION.md
+"""
+
+_ON_APPEND_DEPRECATION_MSG = (
+    "OpenInference has been updated for full OpenTelemetry compliance. The ability to set "
+    "`on_append` callbacks are removed. For a migration guide, see "
+    "https://github.com/Arize-ai/phoenix/blob/main/MIGRATION.md"
+)
+
+
+def _show_deprecation_warnings(obj: object, *args: Any, **kwargs: Any) -> None:
+    if args or kwargs:
+        logger.warning(
+            f"{obj.__class__.__name__}() no longer takes any arguments. "
+            "The arguments provided has been ignored. For a migration guide, "
+            "see https://github.com/Arize-ai/phoenix/blob/main/MIGRATION.md"
+        )
+        if any(callable(arg) for arg in args) or "callback" in kwargs:
+            logger.warning(
+                "The `callback` argument is defunct and no longer has any effect. "
+                "If you need access to spans for processing, some options include "
+                "exporting spans from Phoenix or adding a SpanProcessor to the "
+                "OpenTelemetry TracerProvider. For a migration guide, "
+                "see https://github.com/Arize-ai/phoenix/blob/main/MIGRATION.md"
+            )
+        if any(isinstance(arg, HttpExporter) for arg in args):
+            logger.warning(_USE_ENV_MSG)
+
+
+class Tracer:
+    _exporter: Any
+
+    def __init__(self, exporter: Any = None, on_append: Any = None) -> None:
+        logger.warning(_DEFUNCT_MSG)
+        if exporter is not None:
+            logger.warning(_USE_ENV_MSG)
+        if on_append is not None:
+            logger.warning(_ON_APPEND_DEPRECATION_MSG)
+
+    def create_span(self, *_: Any, **__: Any) -> Any:
+        logger.warning(_DEFUNCT_MSG)
+
+    def get_spans(self) -> Iterator[Any]:
+        logger.warning(_DEFUNCT_MSG)
+        logger.warning(
+            ".get_spans() is a defunct method that does nothing. "
+            "It will be removed in the future. For a migration guide, "
+            "see https://github.com/Arize-ai/phoenix/blob/main/MIGRATION.md"
+        )
+        return iter(())
+
+
+class _DefunctModule:
+    __all__ = ("Tracer", "SpanExporter")
+
+    def __getattr__(self, name: str) -> Any:
+        if name == "Tracer":
+            logger.warning(_DEFUNCT_MSG)
+            return Tracer
+        if name == "SpanExporter":
+            logger.warning("`SpanExporter` is defunct and will be removed in the future.")
+            return SpanExporter
+        if name == "_show_deprecation_warnings":
+            return _show_deprecation_warnings
+        raise AttributeError(f"module {__name__} has no attribute {name}")
+
+
+# See e.g. https://stackoverflow.com/a/7668273
+sys.modules[__name__] = _DefunctModule()  # type: ignore

arize_phoenix-3.0.1/src/phoenix/version.py

@@ -0,0 +1 @@
+__version__ = "3.0.1"

arize_phoenix-2.11.1/src/phoenix/trace/langchain/__init__.py

@@ -1,4 +0,0 @@
-from .instrumentor import LangChainInstrumentor
-from .tracer import OpenInferenceTracer
-
-__all__ = ["OpenInferenceTracer", "LangChainInstrumentor"]

arize_phoenix-2.11.1/src/phoenix/trace/langchain/instrumentor.py

@@ -1,37 +0,0 @@
-from typing import Any, Optional
-
-from .tracer import OpenInferenceTracer
-
-
-class LangChainInstrumentor:
-    """
-    Instruments the OpenInferenceTracer for LangChain automatically by patching the
-    BaseCallbackManager in LangChain.
-    """
-
-    def __init__(self, tracer: Optional[OpenInferenceTracer] = None) -> None:
-        self._tracer = tracer if tracer is not None else OpenInferenceTracer()
-
-    def instrument(self) -> None:
-        try:
-            from langchain.callbacks.base import BaseCallbackManager
-        except ImportError:
-            # Raise a cleaner error if LangChain is not installed
-            raise ImportError(
-                "LangChain is not installed. Please install LangChain first to use the instrumentor"
-            )
-
-        source_init = BaseCallbackManager.__init__
-
-        # Keep track of the source init so we can tell if the patching occurred
-        self._source_callback_manager_init = source_init
-
-        tracer = self._tracer
-
-        # Patch the init method of the BaseCallbackManager to add the tracer
-        # to all callback managers
-        def patched_init(self: BaseCallbackManager, *args: Any, **kwargs: Any) -> None:
-            source_init(self, *args, **kwargs)
-            self.add_handler(tracer, True)
-
-        BaseCallbackManager.__init__ = patched_init