langchain 1.0.4__py3-none-any.whl → 1.2.3__py3-none-any.whl

langchain/embeddings/base.py

@@ -1,26 +1,90 @@
 """Factory functions for embeddings."""
 
 import functools
-from importlib import util
+import importlib
+from collections.abc import Callable
 from typing import Any
 
 from langchain_core.embeddings import Embeddings
 
-_SUPPORTED_PROVIDERS = {
-    "azure_openai": "langchain_openai",
-    "bedrock": "langchain_aws",
-    "cohere": "langchain_cohere",
-    "google_vertexai": "langchain_google_vertexai",
-    "huggingface": "langchain_huggingface",
-    "mistralai": "langchain_mistralai",
-    "ollama": "langchain_ollama",
-    "openai": "langchain_openai",
+
+def _call(cls: type[Embeddings], **kwargs: Any) -> Embeddings:
+    return cls(**kwargs)
+
+
+_SUPPORTED_PROVIDERS: dict[str, tuple[str, str, Callable[..., Embeddings]]] = {
+    "azure_openai": ("langchain_openai", "AzureOpenAIEmbeddings", _call),
+    "bedrock": (
+        "langchain_aws",
+        "BedrockEmbeddings",
+        lambda cls, model, **kwargs: cls(model_id=model, **kwargs),
+    ),
+    "cohere": ("langchain_cohere", "CohereEmbeddings", _call),
+    "google_genai": ("langchain_google_genai", "GoogleGenerativeAIEmbeddings", _call),
+    "google_vertexai": ("langchain_google_vertexai", "VertexAIEmbeddings", _call),
+    "huggingface": (
+        "langchain_huggingface",
+        "HuggingFaceEmbeddings",
+        lambda cls, model, **kwargs: cls(model_name=model, **kwargs),
+    ),
+    "mistralai": ("langchain_mistralai", "MistralAIEmbeddings", _call),
+    "ollama": ("langchain_ollama", "OllamaEmbeddings", _call),
+    "openai": ("langchain_openai", "OpenAIEmbeddings", _call),
 }
+"""Registry mapping provider names to their import configuration.
+
+Each entry maps a provider key to a tuple of:
+
+- `module_path`: The Python module path containing the embeddings class.
+- `class_name`: The name of the embeddings class to import.
+- `creator_func`: A callable that instantiates the class with provided kwargs.
+"""
+
+
+@functools.lru_cache(maxsize=len(_SUPPORTED_PROVIDERS))
+def _get_embeddings_class_creator(provider: str) -> Callable[..., Embeddings]:
+    """Return a factory function that creates an embeddings model for the given provider.
+
+    This function is cached to avoid repeated module imports.
+
+    Args:
+        provider: The name of the model provider (e.g., `'openai'`, `'cohere'`).
+
+            Must be a key in `_SUPPORTED_PROVIDERS`.
+
+    Returns:
+        A callable that accepts model kwargs and returns an `Embeddings` instance for
+            the specified provider.
+
+    Raises:
+        ValueError: If the provider is not in `_SUPPORTED_PROVIDERS`.
+        ImportError: If the provider's integration package is not installed.
+    """
+    if provider not in _SUPPORTED_PROVIDERS:
+        msg = (
+            f"Provider '{provider}' is not supported.\n"
+            f"Supported providers and their required packages:\n"
+            f"{_get_provider_list()}"
+        )
+        raise ValueError(msg)
+
+    module_name, class_name, creator_func = _SUPPORTED_PROVIDERS[provider]
+    try:
+        module = importlib.import_module(module_name)
+    except ImportError as e:
+        pkg = module_name.replace("_", "-")
+        msg = f"Could not import {pkg} python package. Please install it with `pip install {pkg}`"
+        raise ImportError(msg) from e
+
+    cls = getattr(module, class_name)
+    return functools.partial(creator_func, cls=cls)
 
 
 def _get_provider_list() -> str:
     """Get formatted list of providers and their packages."""
-    return "\n".join(f"  - {p}: {pkg.replace('_', '-')}" for p, pkg in _SUPPORTED_PROVIDERS.items())
+    return "\n".join(
+        f"  - {p}: {pkg[0].replace('_', '-')}" for p, pkg in _SUPPORTED_PROVIDERS.items()
+    )
 
 
 def _parse_model_string(model_name: str) -> tuple[str, str]:
@@ -49,7 +113,6 @@ def _parse_model_string(model_name: str) -> tuple[str, str]:
 
     """
     if ":" not in model_name:
-        providers = _SUPPORTED_PROVIDERS
         msg = (
             f"Invalid model format '{model_name}'.\n"
             f"Model name must be in format 'provider:model-name'\n"
@@ -57,7 +120,7 @@ def _parse_model_string(model_name: str) -> tuple[str, str]:
             f"  - openai:text-embedding-3-small\n"
             f"  - bedrock:amazon.titan-embed-text-v1\n"
             f"  - cohere:embed-english-v3.0\n"
-            f"Supported providers: {providers}"
+            f"Supported providers: {_SUPPORTED_PROVIDERS.keys()}"
         )
         raise ValueError(msg)
 
@@ -92,13 +155,12 @@ def _infer_model_and_provider(
         model_name = model
 
     if not provider:
-        providers = _SUPPORTED_PROVIDERS
         msg = (
             "Must specify either:\n"
             "1. A model string in format 'provider:model-name'\n"
             "   Example: 'openai:text-embedding-3-small'\n"
             "2. Or explicitly set provider from: "
-            f"{providers}"
+            f"{_SUPPORTED_PROVIDERS.keys()}"
         )
         raise ValueError(msg)
 
@@ -112,14 +174,6 @@ def _infer_model_and_provider(
     return provider, model_name
 
 
-@functools.lru_cache(maxsize=len(_SUPPORTED_PROVIDERS))
-def _check_pkg(pkg: str) -> None:
-    """Check if a package is installed."""
-    if not util.find_spec(pkg):
-        msg = f"Could not import {pkg} python package. Please install it with `pip install {pkg}`"
-        raise ImportError(msg)
-
-
 def init_embeddings(
     model: str,
     *,
@@ -154,7 +208,7 @@ def init_embeddings(
             - `cohere`                  -> [`langchain-cohere`](https://docs.langchain.com/oss/python/integrations/providers/cohere)
             - `google_vertexai`         -> [`langchain-google-vertexai`](https://docs.langchain.com/oss/python/integrations/providers/google)
             - `huggingface`             -> [`langchain-huggingface`](https://docs.langchain.com/oss/python/integrations/providers/huggingface)
-            - `mistraiai`               -> [`langchain-mistralai`](https://docs.langchain.com/oss/python/integrations/providers/mistralai)
+            - `mistralai`               -> [`langchain-mistralai`](https://docs.langchain.com/oss/python/integrations/providers/mistralai)
             - `ollama`                  -> [`langchain-ollama`](https://docs.langchain.com/oss/python/integrations/providers/ollama)
 
         **kwargs: Additional model-specific parameters passed to the embedding model.
@@ -187,7 +241,7 @@ def init_embeddings(
         model = init_embeddings("openai:text-embedding-3-small", api_key="sk-...")
         ```
 
-    !!! version-added "Added in version 0.3.9"
+    !!! version-added "Added in `langchain` 0.3.9"
 
     """
     if not model:
@@ -196,47 +250,7 @@ def init_embeddings(
         raise ValueError(msg)
 
     provider, model_name = _infer_model_and_provider(model, provider=provider)
-    pkg = _SUPPORTED_PROVIDERS[provider]
-    _check_pkg(pkg)
-
-    if provider == "openai":
-        from langchain_openai import OpenAIEmbeddings
-
-        return OpenAIEmbeddings(model=model_name, **kwargs)
-    if provider == "azure_openai":
-        from langchain_openai import AzureOpenAIEmbeddings
-
-        return AzureOpenAIEmbeddings(model=model_name, **kwargs)
-    if provider == "google_vertexai":
-        from langchain_google_vertexai import VertexAIEmbeddings
-
-        return VertexAIEmbeddings(model=model_name, **kwargs)
-    if provider == "bedrock":
-        from langchain_aws import BedrockEmbeddings
-
-        return BedrockEmbeddings(model_id=model_name, **kwargs)
-    if provider == "cohere":
-        from langchain_cohere import CohereEmbeddings
-
-        return CohereEmbeddings(model=model_name, **kwargs)
-    if provider == "mistralai":
-        from langchain_mistralai import MistralAIEmbeddings
-
-        return MistralAIEmbeddings(model=model_name, **kwargs)
-    if provider == "huggingface":
-        from langchain_huggingface import HuggingFaceEmbeddings
-
-        return HuggingFaceEmbeddings(model_name=model_name, **kwargs)
-    if provider == "ollama":
-        from langchain_ollama import OllamaEmbeddings
-
-        return OllamaEmbeddings(model=model_name, **kwargs)
-    msg = (
-        f"Provider '{provider}' is not supported.\n"
-        f"Supported providers and their required packages:\n"
-        f"{_get_provider_list()}"
-    )
-    raise ValueError(msg)
+    return _get_embeddings_class_creator(provider)(model=model_name, **kwargs)
 
 
 __all__ = [

langchain/messages/__init__.py

@@ -2,11 +2,6 @@
 
 Includes message types for different roles (e.g., human, AI, system), as well as types
 for message content blocks (e.g., text, image, audio) and tool calls.
-
-!!! warning "Reference docs"
-    This page contains **reference documentation** for Messages. See
-    [the docs](https://docs.langchain.com/oss/python/langchain/messages) for conceptual
-    guides, tutorials, and examples on using Messages.
 """
 
 from langchain_core.messages import (

langchain/tools/__init__.py

@@ -1,10 +1,4 @@
-"""Tools.
-
-!!! warning "Reference docs"
-    This page contains **reference documentation** for Tools. See
-    [the docs](https://docs.langchain.com/oss/python/langchain/tools) for conceptual
-    guides, tutorials, and examples on using Tools.
-"""
+"""Tools."""
 
 from langchain_core.tools import (
     BaseTool,

{langchain-1.0.4.dist-info → langchain-1.2.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: langchain
-Version: 1.0.4
+Version: 1.2.3
 Summary: Building applications with LLMs through composability
 Project-URL: Homepage, https://docs.langchain.com/
 Project-URL: Documentation, https://reference.langchain.com/python/langchain/langchain/
@@ -12,7 +12,7 @@ Project-URL: Reddit, https://www.reddit.com/r/LangChain/
 License: MIT
 License-File: LICENSE
 Requires-Python: <4.0.0,>=3.10.0
-Requires-Dist: langchain-core<2.0.0,>=1.0.0
+Requires-Dist: langchain-core<2.0.0,>=1.2.1
 Requires-Dist: langgraph<1.1.0,>=1.0.2
 Requires-Dist: pydantic<3.0.0,>=2.7.4
 Provides-Extra: anthropic
@@ -37,8 +37,6 @@ Provides-Extra: huggingface
 Requires-Dist: langchain-huggingface; extra == 'huggingface'
 Provides-Extra: mistralai
 Requires-Dist: langchain-mistralai; extra == 'mistralai'
-Provides-Extra: model-profiles
-Requires-Dist: langchain-model-profiles; extra == 'model-profiles'
 Provides-Extra: ollama
 Requires-Dist: langchain-ollama; extra == 'ollama'
 Provides-Extra: openai
@@ -79,7 +77,7 @@ LangChain [agents](https://docs.langchain.com/oss/python/langchain/agents) are b
 
 ## 📖 Documentation
 
-For full documentation, see the [API reference](https://reference.langchain.com/python/langchain/langchain/).
+For full documentation, see the [API reference](https://reference.langchain.com/python/langchain/langchain/). For conceptual guides, tutorials, and examples on using LangChain, see the [LangChain Docs](https://docs.langchain.com/oss/python/langchain/overview).
 
 ## 📕 Releases & Versioning
 

langchain-1.2.3.dist-info/RECORD

@@ -0,0 +1,36 @@
+langchain/__init__.py,sha256=wtF0x4NyA6HZMSrvdCbMsf8ISWPrh4fNuwFODnwlDEE,61
+langchain/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain/agents/__init__.py,sha256=xSMzY_PXzKmfOUVPkmL8JcXaOIq55xtP2DDeb_sDSoI,285
+langchain/agents/factory.py,sha256=XL9-YiqSzyDWiSjZ4yVx9Ua9Xh1w2eGeAq3AM_eXDbg,65862
+langchain/agents/structured_output.py,sha256=FVJ7bRJDDy4JJ9vb95VmwijoTMIWaHfxrkHydk6W_t4,14467
+langchain/agents/middleware/__init__.py,sha256=aVlbP2z5bkxgKjWqhck94M7XAR9D0HM9R3boohVO9Js,2170
+langchain/agents/middleware/_execution.py,sha256=KtLnQZBVN8yW-Pn2TC8klXxL_RB42kO84NWgELgsZSk,14202
+langchain/agents/middleware/_redaction.py,sha256=Q_Q9N2QZYa5L3ZNOFcTCpGOb1KLO594xRB2LS0CCCnk,11642
+langchain/agents/middleware/_retry.py,sha256=nZSUXbvgBXP5nS28X3iBuoSYYh7EG2oLNXcAs0XbRPM,3832
+langchain/agents/middleware/context_editing.py,sha256=l_JN5U-orfRxbDoLKMiPiQbQWtgBKzoNLa0U2ZjQe6w,8903
+langchain/agents/middleware/file_search.py,sha256=ilhly8E5AcZbmXM-XdmgzooWO93yQLpTC8r11NZ6bzM,12773
+langchain/agents/middleware/human_in_the_loop.py,sha256=OaY_ae8Hnavj0CeJcRN1AIQ6nWZkG_7Yn82oNr9qm-g,12911
+langchain/agents/middleware/model_call_limit.py,sha256=GR6fktGB5keibVVT_3zGI-qNHdHYXly-Lj61fQfLhfY,9005
+langchain/agents/middleware/model_fallback.py,sha256=QZez99BxIW4RVUuLFeBvYWD1IzEbjX9nzg_cLId8khU,4018
+langchain/agents/middleware/model_retry.py,sha256=fHPL2tFOw8FbsgV1zCYez6kd-MQ9fMKsHjSQ34m2mT8,10600
+langchain/agents/middleware/pii.py,sha256=aNOCSousmz1AhKnwTCitBS9egAUjBog0_iRvhcyTEMg,12446
+langchain/agents/middleware/shell_tool.py,sha256=uhg_Y5g_FvIgZEw1S2B_X8phNAV1fiOt75_dNGtZgCQ,31146
+langchain/agents/middleware/summarization.py,sha256=EDsRakbhqhm__-9Akf2-rxAI5_v9sFK5zOqZem3nb7U,23620
+langchain/agents/middleware/todo.py,sha256=6DKvRtSgDxMiJzdsqNDD3wNLYfZESuIws2EE0aJ-gdw,13649
+langchain/agents/middleware/tool_call_limit.py,sha256=iYElI38iiNHBCpKDLMEMsxGHyYVpAjlYP7u_nVGBr2Y,18834
+langchain/agents/middleware/tool_emulator.py,sha256=KIayn1izRrAdKvkQQfqB9Os7AktihUU5Cov0H77i3js,7364
+langchain/agents/middleware/tool_retry.py,sha256=LH0WEUma9n2icEn3zaDBUI3gJiblmFuhoxEXpJ1b6WE,14123
+langchain/agents/middleware/tool_selection.py,sha256=TmLPejZQfIE10r5l-dcz41nUv4SF0FeAHRgpfPfaAVk,11821
+langchain/agents/middleware/types.py,sha256=clgJXyr35kHxJx1BfL5tgn7WSKacZUproExdREj8pPg,67809
+langchain/chat_models/__init__.py,sha256=j1XZBNMC81eRac5eLs52ayQB8aTXBk0P78Z-nG_YGN4,286
+langchain/chat_models/base.py,sha256=t4E-JY1pzY1HYE4fdEkuVQzy3GOejrq9edM420MAN5M,37650
+langchain/embeddings/__init__.py,sha256=xvVT9JTCjEngvuayIyQJyopEZUlve8acGJnyq34nAbs,586
+langchain/embeddings/base.py,sha256=gLR2Pvo3m7YsjzwaXzAWVJOkZ8JLI-mS2oA7MtYSaro,9643
+langchain/messages/__init__.py,sha256=gA-2eKFWxgf97lRTWrR28e3QMiBjuPXqaNd16jkF9p0,1626
+langchain/rate_limiters/__init__.py,sha256=5490xUNhet37N2nX6kbJlDgf8u1DX-C1Cs_r7etXn8A,351
+langchain/tools/__init__.py,sha256=A6K6Rz8FSTADGwR713fn1PaMcqLTzeQHfbHHBmK2HLY,394
+langchain/tools/tool_node.py,sha256=1DRMsm5tc31T76rtqtqJkGINw7ny1zqVCF-ViGUymFs,477
+langchain-1.2.3.dist-info/METADATA,sha256=xhPEB_NdTUxmXyVIHFcr-nBYw7BS9sOgxJIPOqolqu8,4943
+langchain-1.2.3.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+langchain-1.2.3.dist-info/licenses/LICENSE,sha256=TsZ-TKbmch26hJssqCJhWXyGph7iFLvyFBYAa3stBHg,1067
+langchain-1.2.3.dist-info/RECORD,,

{langchain-1.0.4.dist-info → langchain-1.2.3.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.27.0
+Generator: hatchling 1.28.0
 Root-Is-Purelib: true
 Tag: py3-none-any

langchain-1.0.4.dist-info/RECORD

@@ -1,34 +0,0 @@
-langchain/__init__.py,sha256=6ZpcmOCcqhKHHCh2pnjoWxfV5iHK24TAYhVsLU3QJZs,61
-langchain/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-langchain/agents/__init__.py,sha256=tDjbhFSC6XHQUZ_XvjHwmbICFfjxmE9xKFMbUVSIwfs,522
-langchain/agents/factory.py,sha256=IZXTYMUCsqglVD9082kplSuhxpgYKoNlvjzTtTr8_aE,63985
-langchain/agents/structured_output.py,sha256=nTVyron52uqRIaj2rVY5pJWGd-0mubdA15VR2htx6Mo,14083
-langchain/agents/middleware/__init__.py,sha256=Vm-Ajh4YoaahAa9b_XEAuiyoupKNIwZVzX-8JN1xKkA,2251
-langchain/agents/middleware/_execution.py,sha256=Xyjh3HxTHbgA-C9FFE4WXUOqKUW8mdOB455XRlA_BOU,14251
-langchain/agents/middleware/_redaction.py,sha256=LJeNOvdZ0gd4273Lqgpbxh7EiuuZ6q5LlqeHK4eyin4,11210
-langchain/agents/middleware/context_editing.py,sha256=suWxzSoBTgDse3n4myHooNJ8db7FJRzxZw_vLtoD_dw,8733
-langchain/agents/middleware/file_search.py,sha256=RiBNJRfy8R5E8TvjQRVgXf1O0UDtXqEarirFPnihbtI,12757
-langchain/agents/middleware/human_in_the_loop.py,sha256=N7Vt31rlHS7J-cA0EBDS2mlQW-SMvvxyAwjBnAY9vZU,12650
-langchain/agents/middleware/model_call_limit.py,sha256=2tMKzXeRU2zH_Iu4flyk47Ycg4Al503tdGAltkCH_NE,7719
-langchain/agents/middleware/model_fallback.py,sha256=5DhMhF-mpWlGyZ0FWTXjdtIw6VTpFG-OEkv_cVTtj80,4106
-langchain/agents/middleware/pii.py,sha256=I3nTAnfvrHqre9SoRJvlw0koT8-x3gGZdSvb0uKH5xg,10978
-langchain/agents/middleware/shell_tool.py,sha256=zKy8eTLhYoW5ogLpVBMQ1wK8lrfUCElCdG7gxvlKIeY,26635
-langchain/agents/middleware/summarization.py,sha256=RgsRVuNEdf_2d-YM6P9txyi5eJW_xLteqMw1YmEDSXg,10313
-langchain/agents/middleware/todo.py,sha256=ZH129wzq7nTWPg2A2SqEbGqZeaTa8w7DIbJluZ2irX0,9853
-langchain/agents/middleware/tool_call_limit.py,sha256=N17JNRI4MC36TDFXv1cYQbWZOF8FtYToAjGSJZLjXWc,17682
-langchain/agents/middleware/tool_emulator.py,sha256=jCgojSbb5EYPk6BmOzN0tAkEeRpzvDcAVky7duQkQG0,7209
-langchain/agents/middleware/tool_retry.py,sha256=xeR_i48DnHRZGKLQuRs6gry9Kx0q_x2S0hcnnftPnBs,13795
-langchain/agents/middleware/tool_selection.py,sha256=6RYdgkg6aSNx1w-YxRyL2Hct7UPnMRgGg6YVZVtW5TU,11638
-langchain/agents/middleware/types.py,sha256=6kPHwSwUU47QsW_O_X5Y9XP56_qJmXG9CfjoXtciX94,55873
-langchain/chat_models/__init__.py,sha256=lQwcJkHtGjrclCL7sBFocQuzRdRgZRPzIIPnGhEJmVQ,533
-langchain/chat_models/base.py,sha256=qkLfLXx1Cc836quJk05CvjFIa8OaEYeDg53qUShS6jw,36527
-langchain/embeddings/__init__.py,sha256=6gZ5HnxoKdlYNG84vf6kuJi6vA59Saa3WZ2vMn0LYxY,850
-langchain/embeddings/base.py,sha256=LTaC-CTPnluyo6wBDygQUwZSpa9ms3A1fFMabT__U2w,8921
-langchain/messages/__init__.py,sha256=IL1zvUHXvJ__3N80hhXhPj10KY0Drtq9K0CkK4uvVxU,1868
-langchain/rate_limiters/__init__.py,sha256=5490xUNhet37N2nX6kbJlDgf8u1DX-C1Cs_r7etXn8A,351
-langchain/tools/__init__.py,sha256=hMzbaGcfHhNYfJx20uV57uMd9a-gNLbmopG4gDReeEc,628
-langchain/tools/tool_node.py,sha256=1DRMsm5tc31T76rtqtqJkGINw7ny1zqVCF-ViGUymFs,477
-langchain-1.0.4.dist-info/METADATA,sha256=e60jqwezLwnstgJQTEjryaVeQYmcXiP2kUgDRrBRmlU,4890
-langchain-1.0.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-langchain-1.0.4.dist-info/licenses/LICENSE,sha256=TsZ-TKbmch26hJssqCJhWXyGph7iFLvyFBYAa3stBHg,1067
-langchain-1.0.4.dist-info/RECORD,,