langchain-core 0.3.79__py3-none-any.whl → 1.0.0__py3-none-any.whl

langchain_core/embeddings/fake.py

@@ -18,40 +18,38 @@ class FakeEmbeddings(Embeddings, BaseModel):
 
     This embedding model creates embeddings by sampling from a normal distribution.
 
-    Do not use this outside of testing, as it is not a real embedding model.
+    !!! warning
+        Do not use this outside of testing, as it is not a real embedding model.
 
     Instantiate:
-        .. code-block:: python
+        ```python
+        from langchain_core.embeddings import FakeEmbeddings
 
-            from langchain_core.embeddings import FakeEmbeddings
-
-            embed = FakeEmbeddings(size=100)
+        embed = FakeEmbeddings(size=100)
+        ```
 
     Embed single text:
-        .. code-block:: python
-
-            input_text = "The meaning of life is 42"
-            vector = embed.embed_query(input_text)
-            print(vector[:3])
-
-        .. code-block:: python
-
-            [-0.700234640213188, -0.581266257710429, -1.1328482266445354]
+        ```python
+        input_text = "The meaning of life is 42"
+        vector = embed.embed_query(input_text)
+        print(vector[:3])
+        ```
+        ```python
+        [-0.700234640213188, -0.581266257710429, -1.1328482266445354]
+        ```
 
     Embed multiple texts:
-        .. code-block:: python
-
-            input_texts = ["Document 1...", "Document 2..."]
-            vectors = embed.embed_documents(input_texts)
-            print(len(vectors))
-            # The first 3 coordinates for the first vector
-            print(vectors[0][:3])
-
-        .. code-block:: python
-
-            2
-            [-0.5670477847544458, -0.31403828652395727, -0.5840547508955257]
-
+        ```python
+        input_texts = ["Document 1...", "Document 2..."]
+        vectors = embed.embed_documents(input_texts)
+        print(len(vectors))
+        # The first 3 coordinates for the first vector
+        print(vectors[0][:3])
+        ```
+        ```python
+        2
+        [-0.5670477847544458, -0.31403828652395727, -0.5840547508955257]
+        ```
     """
 
     size: int
@@ -75,40 +73,38 @@ class DeterministicFakeEmbedding(Embeddings, BaseModel):
     This embedding model creates embeddings by sampling from a normal distribution
     with a seed based on the hash of the text.
 
-    Do not use this outside of testing, as it is not a real embedding model.
+    !!! warning
+        Do not use this outside of testing, as it is not a real embedding model.
 
     Instantiate:
-        .. code-block:: python
+        ```python
+        from langchain_core.embeddings import DeterministicFakeEmbedding
 
-            from langchain_core.embeddings import DeterministicFakeEmbedding
-
-            embed = DeterministicFakeEmbedding(size=100)
+        embed = DeterministicFakeEmbedding(size=100)
+        ```
 
     Embed single text:
-        .. code-block:: python
-
-            input_text = "The meaning of life is 42"
-            vector = embed.embed_query(input_text)
-            print(vector[:3])
-
-        .. code-block:: python
-
-            [-0.700234640213188, -0.581266257710429, -1.1328482266445354]
+        ```python
+        input_text = "The meaning of life is 42"
+        vector = embed.embed_query(input_text)
+        print(vector[:3])
+        ```
+        ```python
+        [-0.700234640213188, -0.581266257710429, -1.1328482266445354]
+        ```
 
     Embed multiple texts:
-        .. code-block:: python
-
-            input_texts = ["Document 1...", "Document 2..."]
-            vectors = embed.embed_documents(input_texts)
-            print(len(vectors))
-            # The first 3 coordinates for the first vector
-            print(vectors[0][:3])
-
-        .. code-block:: python
-
-            2
-            [-0.5670477847544458, -0.31403828652395727, -0.5840547508955257]
-
+        ```python
+        input_texts = ["Document 1...", "Document 2..."]
+        vectors = embed.embed_documents(input_texts)
+        print(len(vectors))
+        # The first 3 coordinates for the first vector
+        print(vectors[0][:3])
+        ```
+        ```python
+        2
+        [-0.5670477847544458, -0.31403828652395727, -0.5840547508955257]
+        ```
     """
 
     size: int

langchain_core/example_selectors/length_based.py

@@ -1,7 +1,7 @@
 """Select examples based on length."""
 
 import re
-from typing import Callable
+from collections.abc import Callable
 
 from pydantic import BaseModel, Field, model_validator
 from typing_extensions import Self

langchain_core/example_selectors/semantic_similarity.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 
 from abc import ABC
-from typing import TYPE_CHECKING, Any, Optional
+from typing import TYPE_CHECKING, Any
 
 from pydantic import BaseModel, ConfigDict
 
@@ -35,12 +35,12 @@ class _VectorStoreExampleSelector(BaseExampleSelector, BaseModel, ABC):
     """VectorStore that contains information about examples."""
     k: int = 4
     """Number of examples to select."""
-    example_keys: Optional[list[str]] = None
+    example_keys: list[str] | None = None
     """Optional keys to filter examples to."""
-    input_keys: Optional[list[str]] = None
+    input_keys: list[str] | None = None
     """Optional keys to filter input to. If provided, the search is based on
     the input variables instead of all variables."""
-    vectorstore_kwargs: Optional[dict[str, Any]] = None
+    vectorstore_kwargs: dict[str, Any] | None = None
     """Extra arguments passed to similarity_search function of the vectorstore."""
 
     model_config = ConfigDict(
@@ -49,9 +49,7 @@ class _VectorStoreExampleSelector(BaseExampleSelector, BaseModel, ABC):
     )
 
     @staticmethod
-    def _example_to_text(
-        example: dict[str, str], input_keys: Optional[list[str]]
-    ) -> str:
+    def _example_to_text(example: dict[str, str], input_keys: list[str] | None) -> str:
         if input_keys:
             return " ".join(sorted_values({key: example[key] for key in input_keys}))
         return " ".join(sorted_values(example))
@@ -142,10 +140,10 @@ class SemanticSimilarityExampleSelector(_VectorStoreExampleSelector):
         embeddings: Embeddings,
         vectorstore_cls: type[VectorStore],
         k: int = 4,
-        input_keys: Optional[list[str]] = None,
+        input_keys: list[str] | None = None,
         *,
-        example_keys: Optional[list[str]] = None,
-        vectorstore_kwargs: Optional[dict] = None,
+        example_keys: list[str] | None = None,
+        vectorstore_kwargs: dict | None = None,
         **vectorstore_cls_kwargs: Any,
     ) -> SemanticSimilarityExampleSelector:
         """Create k-shot example selector using example list and embeddings.
@@ -156,7 +154,7 @@ class SemanticSimilarityExampleSelector(_VectorStoreExampleSelector):
             examples: List of examples to use in the prompt.
             embeddings: An initialized embedding API interface, e.g. OpenAIEmbeddings().
             vectorstore_cls: A vector store DB interface class, e.g. FAISS.
-            k: Number of examples to select. Default is 4.
+            k: Number of examples to select.
             input_keys: If provided, the search is based on the input variables
                 instead of all variables.
             example_keys: If provided, keys to filter examples to.
@@ -186,10 +184,10 @@ class SemanticSimilarityExampleSelector(_VectorStoreExampleSelector):
         embeddings: Embeddings,
         vectorstore_cls: type[VectorStore],
         k: int = 4,
-        input_keys: Optional[list[str]] = None,
+        input_keys: list[str] | None = None,
         *,
-        example_keys: Optional[list[str]] = None,
-        vectorstore_kwargs: Optional[dict] = None,
+        example_keys: list[str] | None = None,
+        vectorstore_kwargs: dict | None = None,
         **vectorstore_cls_kwargs: Any,
     ) -> SemanticSimilarityExampleSelector:
         """Async create k-shot example selector using example list and embeddings.
@@ -200,7 +198,7 @@ class SemanticSimilarityExampleSelector(_VectorStoreExampleSelector):
             examples: List of examples to use in the prompt.
             embeddings: An initialized embedding API interface, e.g. OpenAIEmbeddings().
             vectorstore_cls: A vector store DB interface class, e.g. FAISS.
-            k: Number of examples to select. Default is 4.
+            k: Number of examples to select.
             input_keys: If provided, the search is based on the input variables
                 instead of all variables.
             example_keys: If provided, keys to filter examples to.
@@ -273,10 +271,10 @@ class MaxMarginalRelevanceExampleSelector(_VectorStoreExampleSelector):
         embeddings: Embeddings,
         vectorstore_cls: type[VectorStore],
         k: int = 4,
-        input_keys: Optional[list[str]] = None,
+        input_keys: list[str] | None = None,
         fetch_k: int = 20,
-        example_keys: Optional[list[str]] = None,
-        vectorstore_kwargs: Optional[dict] = None,
+        example_keys: list[str] | None = None,
+        vectorstore_kwargs: dict | None = None,
         **vectorstore_cls_kwargs: Any,
     ) -> MaxMarginalRelevanceExampleSelector:
         """Create k-shot example selector using example list and embeddings.
@@ -287,9 +285,8 @@ class MaxMarginalRelevanceExampleSelector(_VectorStoreExampleSelector):
             examples: List of examples to use in the prompt.
             embeddings: An initialized embedding API interface, e.g. OpenAIEmbeddings().
             vectorstore_cls: A vector store DB interface class, e.g. FAISS.
-            k: Number of examples to select. Default is 4.
+            k: Number of examples to select.
             fetch_k: Number of Documents to fetch to pass to MMR algorithm.
-                Default is 20.
             input_keys: If provided, the search is based on the input variables
                 instead of all variables.
             example_keys: If provided, keys to filter examples to.
@@ -321,10 +318,10 @@ class MaxMarginalRelevanceExampleSelector(_VectorStoreExampleSelector):
         vectorstore_cls: type[VectorStore],
         *,
         k: int = 4,
-        input_keys: Optional[list[str]] = None,
+        input_keys: list[str] | None = None,
         fetch_k: int = 20,
-        example_keys: Optional[list[str]] = None,
-        vectorstore_kwargs: Optional[dict] = None,
+        example_keys: list[str] | None = None,
+        vectorstore_kwargs: dict | None = None,
         **vectorstore_cls_kwargs: Any,
     ) -> MaxMarginalRelevanceExampleSelector:
         """Create k-shot example selector using example list and embeddings.
@@ -335,9 +332,8 @@ class MaxMarginalRelevanceExampleSelector(_VectorStoreExampleSelector):
             examples: List of examples to use in the prompt.
             embeddings: An initialized embedding API interface, e.g. OpenAIEmbeddings().
             vectorstore_cls: A vector store DB interface class, e.g. FAISS.
-            k: Number of examples to select. Default is 4.
+            k: Number of examples to select.
             fetch_k: Number of Documents to fetch to pass to MMR algorithm.
-                Default is 20.
             input_keys: If provided, the search is based on the input variables
                 instead of all variables.
             example_keys: If provided, keys to filter examples to.

langchain_core/exceptions.py

@@ -1,7 +1,7 @@
 """Custom **exceptions** for LangChain."""
 
 from enum import Enum
-from typing import Any, Optional
+from typing import Any
 
 
 class LangChainException(Exception):  # noqa: N818
@@ -16,7 +16,7 @@ class OutputParserException(ValueError, LangChainException):  # noqa: N818
     """Exception that output parsers should raise to signify a parsing error.
 
     This exists to differentiate parsing errors from other code or execution errors
-    that also may arise inside the output parser. OutputParserExceptions will be
+    that also may arise inside the output parser. `OutputParserException` will be
     available to catch and handle in ways to fix the parsing error, while other
     errors will be raised.
     """
@@ -24,28 +24,27 @@ class OutputParserException(ValueError, LangChainException):  # noqa: N818
     def __init__(
         self,
         error: Any,
-        observation: Optional[str] = None,
-        llm_output: Optional[str] = None,
+        observation: str | None = None,
+        llm_output: str | None = None,
         send_to_llm: bool = False,  # noqa: FBT001,FBT002
     ):
-        """Create an OutputParserException.
+        """Create an `OutputParserException`.
 
         Args:
             error: The error that's being re-raised or an error message.
             observation: String explanation of error which can be passed to a
-                model to try and remediate the issue. Defaults to None.
+                model to try and remediate the issue.
             llm_output: String model output which is error-ing.
-                Defaults to None.
+
             send_to_llm: Whether to send the observation and llm_output back to an Agent
-                after an OutputParserException has been raised.
+                after an `OutputParserException` has been raised.
                 This gives the underlying model driving the agent the context that the
                 previous output was improperly structured, in the hopes that it will
                 update the output to the correct format.
-                Defaults to False.
 
         Raises:
-            ValueError: If ``send_to_llm`` is True but either observation or
-                ``llm_output`` are not provided.
+            ValueError: If `send_to_llm` is True but either observation or
+                `llm_output` are not provided.
         """
         if isinstance(error, str):
             error = create_message(

langchain_core/globals.py

@@ -1,18 +1,10 @@
 """Global values and configuration that apply to all of LangChain."""
 
-import warnings
 from typing import TYPE_CHECKING, Optional
 
 if TYPE_CHECKING:
     from langchain_core.caches import BaseCache
 
-try:
-    import langchain  # type: ignore[import-not-found]
-
-    _HAS_LANGCHAIN = True
-except ImportError:
-    _HAS_LANGCHAIN = False
-
 
 # DO NOT USE THESE VALUES DIRECTLY!
 # Use them only via `get_<X>()` and `set_<X>()` below,
@@ -29,26 +21,6 @@ def set_verbose(value: bool) -> None:  # noqa: FBT001
     Args:
         value: The new value for the `verbose` global setting.
     """
-    if _HAS_LANGCHAIN:
-        # We're about to run some deprecated code, don't report warnings from it.
-        # The user called the correct (non-deprecated) code path and shouldn't get
-        # warnings.
-        with warnings.catch_warnings():
-            warnings.filterwarnings(
-                "ignore",
-                message=(
-                    "Importing verbose from langchain root module "
-                    "is no longer supported"
-                ),
-            )
-            # N.B.: This is a workaround for an unfortunate quirk of Python's
-            #       module-level `__getattr__()` implementation:
-            # https://github.com/langchain-ai/langchain/pull/11311#issuecomment-1743780004
-            #
-            # Remove it once `langchain.verbose` is no longer supported, and once all
-            # users have migrated to using `set_verbose()` here.
-            langchain.verbose = value
-
     global _verbose  # noqa: PLW0603
     _verbose = value
 
@@ -59,35 +31,7 @@ def get_verbose() -> bool:
     Returns:
         The value of the `verbose` global setting.
     """
-    if _HAS_LANGCHAIN:
-        # We're about to run some deprecated code, don't report warnings from it.
-        # The user called the correct (non-deprecated) code path and shouldn't get
-        # warnings.
-        with warnings.catch_warnings():
-            warnings.filterwarnings(
-                "ignore",
-                message=(
-                    ".*Importing verbose from langchain root module "
-                    "is no longer supported"
-                ),
-            )
-            # N.B.: This is a workaround for an unfortunate quirk of Python's
-            #       module-level `__getattr__()` implementation:
-            # https://github.com/langchain-ai/langchain/pull/11311#issuecomment-1743780004
-            #
-            # Remove it once `langchain.verbose` is no longer supported, and once all
-            # users have migrated to using `set_verbose()` here.
-            #
-            # In the meantime, the `verbose` setting is considered True if either the
-            # old or the new value are True. This accommodates users who haven't
-            # migrated to using `set_verbose()` yet. Those users are getting
-            # deprecation warnings directing them to use `set_verbose()` when they
-            # import `langchain.verbose`.
-            old_verbose = langchain.verbose
-    else:
-        old_verbose = False
-
-    return _verbose or old_verbose
+    return _verbose
 
 
 def set_debug(value: bool) -> None:  # noqa: FBT001
@@ -96,24 +40,6 @@ def set_debug(value: bool) -> None:  # noqa: FBT001
     Args:
         value: The new value for the `debug` global setting.
     """
-    if _HAS_LANGCHAIN:
-        # We're about to run some deprecated code, don't report warnings from it.
-        # The user called the correct (non-deprecated) code path and shouldn't get
-        # warnings.
-        with warnings.catch_warnings():
-            warnings.filterwarnings(
-                "ignore",
-                message="Importing debug from langchain root module "
-                "is no longer supported",
-            )
-            # N.B.: This is a workaround for an unfortunate quirk of Python's
-            #       module-level `__getattr__()` implementation:
-            # https://github.com/langchain-ai/langchain/pull/11311#issuecomment-1743780004
-            #
-            # Remove it once `langchain.debug` is no longer supported, and once all
-            # users have migrated to using `set_debug()` here.
-            langchain.debug = value
-
     global _debug  # noqa: PLW0603
     _debug = value
 
@@ -124,32 +50,7 @@ def get_debug() -> bool:
     Returns:
         The value of the `debug` global setting.
     """
-    if _HAS_LANGCHAIN:
-        # We're about to run some deprecated code, don't report warnings from it.
-        # The user called the correct (non-deprecated) code path and shouldn't get
-        # warnings.
-        with warnings.catch_warnings():
-            warnings.filterwarnings(
-                "ignore",
-                message="Importing debug from langchain root module "
-                "is no longer supported",
-            )
-            # N.B.: This is a workaround for an unfortunate quirk of Python's
-            #       module-level `__getattr__()` implementation:
-            # https://github.com/langchain-ai/langchain/pull/11311#issuecomment-1743780004
-            #
-            # Remove it once `langchain.debug` is no longer supported, and once all
-            # users have migrated to using `set_debug()` here.
-            #
-            # In the meantime, the `debug` setting is considered True if either the old
-            # or the new value are True. This accommodates users who haven't migrated
-            # to using `set_debug()` yet. Those users are getting deprecation warnings
-            # directing them to use `set_debug()` when they import `langchain.debug`.
-            old_debug = langchain.debug
-    else:
-        old_debug = False
-
-    return _debug or old_debug
+    return _debug
 
 
 def set_llm_cache(value: Optional["BaseCache"]) -> None:
@@ -158,26 +59,6 @@ def set_llm_cache(value: Optional["BaseCache"]) -> None:
     Args:
         value: The new LLM cache to use. If `None`, the LLM cache is disabled.
     """
-    if _HAS_LANGCHAIN:
-        # We're about to run some deprecated code, don't report warnings from it.
-        # The user called the correct (non-deprecated) code path and shouldn't get
-        # warnings.
-        with warnings.catch_warnings():
-            warnings.filterwarnings(
-                "ignore",
-                message=(
-                    "Importing llm_cache from langchain root module "
-                    "is no longer supported"
-                ),
-            )
-            # N.B.: This is a workaround for an unfortunate quirk of Python's
-            #       module-level `__getattr__()` implementation:
-            # https://github.com/langchain-ai/langchain/pull/11311#issuecomment-1743780004
-            #
-            # Remove it once `langchain.llm_cache` is no longer supported, and
-            # once all users have migrated to using `set_llm_cache()` here.
-            langchain.llm_cache = value
-
     global _llm_cache  # noqa: PLW0603
     _llm_cache = value
 
@@ -188,33 +69,4 @@ def get_llm_cache() -> Optional["BaseCache"]:
     Returns:
         The value of the `llm_cache` global setting.
     """
-    if _HAS_LANGCHAIN:
-        # We're about to run some deprecated code, don't report warnings from it.
-        # The user called the correct (non-deprecated) code path and shouldn't get
-        # warnings.
-        with warnings.catch_warnings():
-            warnings.filterwarnings(
-                "ignore",
-                message=(
-                    "Importing llm_cache from langchain root module "
-                    "is no longer supported"
-                ),
-            )
-            # N.B.: This is a workaround for an unfortunate quirk of Python's
-            #       module-level `__getattr__()` implementation:
-            # https://github.com/langchain-ai/langchain/pull/11311#issuecomment-1743780004
-            #
-            # Remove it once `langchain.llm_cache` is no longer supported, and
-            # once all users have migrated to using `set_llm_cache()` here.
-            #
-            # In the meantime, the `llm_cache` setting returns whichever of
-            # its two backing sources is truthy (not `None` and non-empty),
-            # or the old value if both are falsy. This accommodates users
-            # who haven't migrated to using `set_llm_cache()` yet.
-            # Those users are getting deprecation warnings directing them
-            # to use `set_llm_cache()` when they import `langchain.llm_cache`.
-            old_llm_cache = langchain.llm_cache
-    else:
-        old_llm_cache = None
-
-    return _llm_cache or old_llm_cache
+    return _llm_cache