langchain-core 1.0.0a6__py3-none-any.whl → 1.0.0a8__py3-none-any.whl

langchain_core/utils/utils.py

@@ -6,9 +6,9 @@ import functools
 import importlib
 import os
 import warnings
-from collections.abc import Iterator, Sequence
+from collections.abc import Callable, Iterator, Sequence
 from importlib.metadata import version
-from typing import Any, Callable, Optional, Union, overload
+from typing import Any, overload
 from uuid import uuid4
 
 from packaging.version import parse
@@ -91,7 +91,7 @@ def mock_now(dt_value: datetime.datetime) -> Iterator[type]:
 
         @classmethod
         @override
-        def now(cls, tz: Union[datetime.tzinfo, None] = None) -> "MockDateTime":
+        def now(cls, tz: datetime.tzinfo | None = None) -> "MockDateTime":
             # Create a copy of dt_value.
             return MockDateTime(
                 dt_value.year,
@@ -113,7 +113,7 @@ def mock_now(dt_value: datetime.datetime) -> Iterator[type]:
 
 
 def guard_import(
-    module_name: str, *, pip_name: Optional[str] = None, package: Optional[str] = None
+    module_name: str, *, pip_name: str | None = None, package: str | None = None
 ) -> Any:
     """Dynamically import a module.
 
@@ -146,10 +146,10 @@ def guard_import(
 
 def check_package_version(
     package: str,
-    lt_version: Optional[str] = None,
-    lte_version: Optional[str] = None,
-    gt_version: Optional[str] = None,
-    gte_version: Optional[str] = None,
+    lt_version: str | None = None,
+    lte_version: str | None = None,
+    gt_version: str | None = None,
+    gte_version: str | None = None,
 ) -> None:
     """Check the version of a package.
 
@@ -306,7 +306,7 @@ def build_extra_kwargs(
     return extra_kwargs
 
 
-def convert_to_secret_str(value: Union[SecretStr, str]) -> SecretStr:
+def convert_to_secret_str(value: SecretStr | str) -> SecretStr:
     """Convert a string to a SecretStr if needed.
 
     Args:
@@ -345,29 +345,29 @@ def from_env(key: str, /, *, error_message: str) -> Callable[[], str]: ...
 
 @overload
 def from_env(
-    key: Union[str, Sequence[str]], /, *, default: str, error_message: Optional[str]
+    key: str | Sequence[str], /, *, default: str, error_message: str | None
 ) -> Callable[[], str]: ...
 
 
 @overload
 def from_env(
-    key: str, /, *, default: None, error_message: Optional[str]
-) -> Callable[[], Optional[str]]: ...
+    key: str, /, *, default: None, error_message: str | None
+) -> Callable[[], str | None]: ...
 
 
 @overload
 def from_env(
-    key: Union[str, Sequence[str]], /, *, default: None
-) -> Callable[[], Optional[str]]: ...
+    key: str | Sequence[str], /, *, default: None
+) -> Callable[[], str | None]: ...
 
 
 def from_env(
-    key: Union[str, Sequence[str]],
+    key: str | Sequence[str],
     /,
     *,
-    default: Union[str, _NoDefaultType, None] = _NoDefault,
-    error_message: Optional[str] = None,
-) -> Union[Callable[[], str], Callable[[], Optional[str]]]:
+    default: str | _NoDefaultType | None = _NoDefault,
+    error_message: str | None = None,
+) -> Callable[[], str] | Callable[[], str | None]:
     """Create a factory method that gets a value from an environment variable.
 
     Args:
@@ -384,7 +384,7 @@ def from_env(
         factory method that will look up the value from the environment.
     """
 
-    def get_from_env_fn() -> Optional[str]:
+    def get_from_env_fn() -> str | None:
         """Get a value from an environment variable.
 
         Raises:
@@ -416,7 +416,7 @@ def from_env(
 
 
 @overload
-def secret_from_env(key: Union[str, Sequence[str]], /) -> Callable[[], SecretStr]: ...
+def secret_from_env(key: str | Sequence[str], /) -> Callable[[], SecretStr]: ...
 
 
 @overload
@@ -425,8 +425,8 @@ def secret_from_env(key: str, /, *, default: str) -> Callable[[], SecretStr]: ..
 
 @overload
 def secret_from_env(
-    key: Union[str, Sequence[str]], /, *, default: None
-) -> Callable[[], Optional[SecretStr]]: ...
+    key: str | Sequence[str], /, *, default: None
+) -> Callable[[], SecretStr | None]: ...
 
 
 @overload
@@ -434,12 +434,12 @@ def secret_from_env(key: str, /, *, error_message: str) -> Callable[[], SecretSt
 
 
 def secret_from_env(
-    key: Union[str, Sequence[str]],
+    key: str | Sequence[str],
     /,
     *,
-    default: Union[str, _NoDefaultType, None] = _NoDefault,
-    error_message: Optional[str] = None,
-) -> Union[Callable[[], Optional[SecretStr]], Callable[[], SecretStr]]:
+    default: str | _NoDefaultType | None = _NoDefault,
+    error_message: str | None = None,
+) -> Callable[[], SecretStr | None] | Callable[[], SecretStr]:
     """Secret from env.
 
     Args:
@@ -453,7 +453,7 @@ def secret_from_env(
         factory method that will look up the secret from the environment.
     """
 
-    def get_secret_from_env() -> Optional[SecretStr]:
+    def get_secret_from_env() -> SecretStr | None:
         """Get a value from an environment variable.
 
         Raises:
@@ -498,7 +498,7 @@ Used for:
 """
 
 
-def ensure_id(id_val: Optional[str]) -> str:
+def ensure_id(id_val: str | None) -> str:
     """Ensure the ID is a valid string, generating a new UUID if not provided.
 
     Auto-generated UUIDs are prefixed by ``'lc_'`` to indicate they are
@@ -510,4 +510,4 @@ def ensure_id(id_val: Optional[str]) -> str:
     Returns:
         A string ID, either the validated provided value or a newly generated UUID4.
     """
-    return id_val or str(f"{LC_AUTO_PREFIX}{uuid4()}")
+    return id_val or f"{LC_AUTO_PREFIX}{uuid4()}"

langchain_core/vectorstores/base.py

@@ -25,13 +25,12 @@ import logging
 import math
 import warnings
 from abc import ABC, abstractmethod
+from collections.abc import Callable
 from itertools import cycle
 from typing import (
     TYPE_CHECKING,
     Any,
-    Callable,
     ClassVar,
-    Optional,
     TypeVar,
 )
 
@@ -62,9 +61,9 @@ class VectorStore(ABC):
     def add_texts(
         self,
         texts: Iterable[str],
-        metadatas: Optional[list[dict]] = None,
+        metadatas: list[dict] | None = None,
         *,
-        ids: Optional[list[str]] = None,
+        ids: list[str] | None = None,
         **kwargs: Any,
     ) -> list[str]:
         """Run more texts through the embeddings and add to the vectorstore.
@@ -98,10 +97,10 @@ class VectorStore(ABC):
                 )
                 raise ValueError(msg)
             metadatas_ = iter(metadatas) if metadatas else cycle([{}])
-            ids_: Iterator[Optional[str]] = iter(ids) if ids else cycle([None])
+            ids_: Iterator[str | None] = iter(ids) if ids else cycle([None])
             docs = [
                 Document(id=id_, page_content=text, metadata=metadata_)
-                for text, metadata_, id_ in zip(texts, metadatas_, ids_)
+                for text, metadata_, id_ in zip(texts, metadatas_, ids_, strict=False)
             ]
             if ids is not None:
                 # For backward compatibility
@@ -112,7 +111,7 @@ class VectorStore(ABC):
         raise NotImplementedError(msg)
 
     @property
-    def embeddings(self) -> Optional[Embeddings]:
+    def embeddings(self) -> Embeddings | None:
         """Access the query embedding object if available."""
         logger.debug(
             "The embeddings property has not been implemented for %s",
@@ -120,7 +119,7 @@ class VectorStore(ABC):
         )
         return None
 
-    def delete(self, ids: Optional[list[str]] = None, **kwargs: Any) -> Optional[bool]:
+    def delete(self, ids: list[str] | None = None, **kwargs: Any) -> bool | None:
         """Delete by vector ID or other criteria.
 
         Args:
@@ -156,7 +155,7 @@ class VectorStore(ABC):
         Returns:
             List of Documents.
 
-        .. versionadded:: 0.2.11
+        !!! version-added "Added in version 0.2.11"
         """
         msg = f"{self.__class__.__name__} does not yet support get_by_ids."
         raise NotImplementedError(msg)
@@ -184,13 +183,11 @@ class VectorStore(ABC):
         Returns:
             List of Documents.
 
-        .. versionadded:: 0.2.11
+        !!! version-added "Added in version 0.2.11"
         """
         return await run_in_executor(None, self.get_by_ids, ids)
 
-    async def adelete(
-        self, ids: Optional[list[str]] = None, **kwargs: Any
-    ) -> Optional[bool]:
+    async def adelete(self, ids: list[str] | None = None, **kwargs: Any) -> bool | None:
         """Async delete by vector ID or other criteria.
 
         Args:
@@ -206,9 +203,9 @@ class VectorStore(ABC):
     async def aadd_texts(
         self,
         texts: Iterable[str],
-        metadatas: Optional[list[dict]] = None,
+        metadatas: list[dict] | None = None,
         *,
-        ids: Optional[list[str]] = None,
+        ids: list[str] | None = None,
         **kwargs: Any,
     ) -> list[str]:
         """Async run more texts through the embeddings and add to the vectorstore.
@@ -244,11 +241,11 @@ class VectorStore(ABC):
                 )
                 raise ValueError(msg)
             metadatas_ = iter(metadatas) if metadatas else cycle([{}])
-            ids_: Iterator[Optional[str]] = iter(ids) if ids else cycle([None])
+            ids_: Iterator[str | None] = iter(ids) if ids else cycle([None])
 
             docs = [
                 Document(id=id_, page_content=text, metadata=metadata_)
-                for text, metadata_, id_ in zip(texts, metadatas_, ids_)
+                for text, metadata_, id_ in zip(texts, metadatas_, ids_, strict=False)
             ]
             return await self.aadd_documents(docs, **kwargs)
         return await run_in_executor(None, self.add_texts, texts, metadatas, **kwargs)
@@ -872,9 +869,9 @@ class VectorStore(ABC):
         cls: type[VST],
         texts: list[str],
         embedding: Embeddings,
-        metadatas: Optional[list[dict]] = None,
+        metadatas: list[dict] | None = None,
         *,
-        ids: Optional[list[str]] = None,
+        ids: list[str] | None = None,
         **kwargs: Any,
     ) -> VST:
         """Return VectorStore initialized from texts and embeddings.
@@ -896,9 +893,9 @@ class VectorStore(ABC):
         cls,
         texts: list[str],
         embedding: Embeddings,
-        metadatas: Optional[list[dict]] = None,
+        metadatas: list[dict] | None = None,
         *,
-        ids: Optional[list[str]] = None,
+        ids: list[str] | None = None,
         **kwargs: Any,
     ) -> Self:
         """Async return VectorStore initialized from texts and embeddings.

langchain_core/vectorstores/in_memory.py

@@ -4,17 +4,15 @@ from __future__ import annotations
 
 import json
 import uuid
+from collections.abc import Callable
 from pathlib import Path
 from typing import (
     TYPE_CHECKING,
     Any,
-    Callable,
-    Optional,
 )
 
 from typing_extensions import override
 
-from langchain_core._api import deprecated
 from langchain_core.documents import Document
 from langchain_core.load import dumpd, load
 from langchain_core.vectorstores import VectorStore
@@ -25,7 +23,6 @@ if TYPE_CHECKING:
     from collections.abc import Iterator, Sequence
 
     from langchain_core.embeddings import Embeddings
-    from langchain_core.indexing import UpsertResponse
 
 try:
     import numpy as np
@@ -180,20 +177,20 @@ class InMemoryVectorStore(VectorStore):
         return self.embedding
 
     @override
-    def delete(self, ids: Optional[Sequence[str]] = None, **kwargs: Any) -> None:
+    def delete(self, ids: Sequence[str] | None = None, **kwargs: Any) -> None:
         if ids:
             for _id in ids:
                 self.store.pop(_id, None)
 
     @override
-    async def adelete(self, ids: Optional[Sequence[str]] = None, **kwargs: Any) -> None:
+    async def adelete(self, ids: Sequence[str] | None = None, **kwargs: Any) -> None:
         self.delete(ids)
 
     @override
     def add_documents(
         self,
         documents: list[Document],
-        ids: Optional[list[str]] = None,
+        ids: list[str] | None = None,
         **kwargs: Any,
     ) -> list[str]:
         texts = [doc.page_content for doc in documents]
@@ -206,13 +203,13 @@ class InMemoryVectorStore(VectorStore):
             )
             raise ValueError(msg)
 
-        id_iterator: Iterator[Optional[str]] = (
+        id_iterator: Iterator[str | None] = (
             iter(ids) if ids else iter(doc.id for doc in documents)
         )
 
         ids_ = []
 
-        for doc, vector in zip(documents, vectors):
+        for doc, vector in zip(documents, vectors, strict=False):
             doc_id = next(id_iterator)
             doc_id_ = doc_id or str(uuid.uuid4())
             ids_.append(doc_id_)
@@ -227,7 +224,7 @@ class InMemoryVectorStore(VectorStore):
 
     @override
     async def aadd_documents(
-        self, documents: list[Document], ids: Optional[list[str]] = None, **kwargs: Any
+        self, documents: list[Document], ids: list[str] | None = None, **kwargs: Any
     ) -> list[str]:
         texts = [doc.page_content for doc in documents]
         vectors = await self.embedding.aembed_documents(texts)
@@ -239,12 +236,12 @@ class InMemoryVectorStore(VectorStore):
             )
             raise ValueError(msg)
 
-        id_iterator: Iterator[Optional[str]] = (
+        id_iterator: Iterator[str | None] = (
             iter(ids) if ids else iter(doc.id for doc in documents)
         )
         ids_: list[str] = []
 
-        for doc, vector in zip(documents, vectors):
+        for doc, vector in zip(documents, vectors, strict=False):
             doc_id = next(id_iterator)
             doc_id_ = doc_id or str(uuid.uuid4())
             ids_.append(doc_id_)
@@ -281,76 +278,6 @@ class InMemoryVectorStore(VectorStore):
                 )
         return documents
 
-    @deprecated(
-        alternative="VectorStore.add_documents",
-        message=(
-            "This was a beta API that was added in 0.2.11. It'll be removed in 0.3.0."
-        ),
-        since="0.2.29",
-        removal="1.0",
-    )
-    def upsert(self, items: Sequence[Document], /, **_kwargs: Any) -> UpsertResponse:
-        """[DEPRECATED] Upsert documents into the store.
-
-        Args:
-            items: The documents to upsert.
-
-        Returns:
-            The upsert response.
-        """
-        vectors = self.embedding.embed_documents([item.page_content for item in items])
-        ids = []
-        for item, vector in zip(items, vectors):
-            doc_id = item.id or str(uuid.uuid4())
-            ids.append(doc_id)
-            self.store[doc_id] = {
-                "id": doc_id,
-                "vector": vector,
-                "text": item.page_content,
-                "metadata": item.metadata,
-            }
-        return {
-            "succeeded": ids,
-            "failed": [],
-        }
-
-    @deprecated(
-        alternative="VectorStore.aadd_documents",
-        message=(
-            "This was a beta API that was added in 0.2.11. It'll be removed in 0.3.0."
-        ),
-        since="0.2.29",
-        removal="1.0",
-    )
-    async def aupsert(
-        self, items: Sequence[Document], /, **_kwargs: Any
-    ) -> UpsertResponse:
-        """[DEPRECATED] Upsert documents into the store.
-
-        Args:
-            items: The documents to upsert.
-
-        Returns:
-            The upsert response.
-        """
-        vectors = await self.embedding.aembed_documents(
-            [item.page_content for item in items]
-        )
-        ids = []
-        for item, vector in zip(items, vectors):
-            doc_id = item.id or str(uuid.uuid4())
-            ids.append(doc_id)
-            self.store[doc_id] = {
-                "id": doc_id,
-                "vector": vector,
-                "text": item.page_content,
-                "metadata": item.metadata,
-            }
-        return {
-            "succeeded": ids,
-            "failed": [],
-        }
-
     @override
     async def aget_by_ids(self, ids: Sequence[str], /) -> list[Document]:
         """Async get documents by their ids.
@@ -367,7 +294,7 @@ class InMemoryVectorStore(VectorStore):
         self,
         embedding: list[float],
         k: int = 4,
-        filter: Optional[Callable[[Document], bool]] = None,  # noqa: A002
+        filter: Callable[[Document], bool] | None = None,  # noqa: A002
     ) -> list[tuple[Document, float, list[float]]]:
         # get all docs with fixed order in list
         docs = list(self.store.values())
@@ -410,7 +337,7 @@ class InMemoryVectorStore(VectorStore):
         self,
         embedding: list[float],
         k: int = 4,
-        filter: Optional[Callable[[Document], bool]] = None,  # noqa: A002
+        filter: Callable[[Document], bool] | None = None,  # noqa: A002
         **_kwargs: Any,
     ) -> list[tuple[Document, float]]:
         """Search for the most similar documents to the given embedding.
@@ -498,7 +425,7 @@ class InMemoryVectorStore(VectorStore):
         fetch_k: int = 20,
         lambda_mult: float = 0.5,
         *,
-        filter: Optional[Callable[[Document], bool]] = None,
+        filter: Callable[[Document], bool] | None = None,
         **kwargs: Any,
     ) -> list[Document]:
         prefetch_hits = self._similarity_search_with_score_by_vector(
@@ -564,7 +491,7 @@ class InMemoryVectorStore(VectorStore):
         cls,
         texts: list[str],
         embedding: Embeddings,
-        metadatas: Optional[list[dict]] = None,
+        metadatas: list[dict] | None = None,
         **kwargs: Any,
     ) -> InMemoryVectorStore:
         store = cls(
@@ -579,7 +506,7 @@ class InMemoryVectorStore(VectorStore):
         cls,
         texts: list[str],
         embedding: Embeddings,
-        metadatas: Optional[list[dict]] = None,
+        metadatas: list[dict] | None = None,
         **kwargs: Any,
     ) -> InMemoryVectorStore:
         store = cls(

langchain_core/vectorstores/utils.py

@@ -8,7 +8,7 @@ from __future__ import annotations
 
 import logging
 import warnings
-from typing import TYPE_CHECKING, Union
+from typing import TYPE_CHECKING
 
 try:
     import numpy as np
@@ -25,7 +25,7 @@ except ImportError:
     _HAS_SIMSIMD = False
 
 if TYPE_CHECKING:
-    Matrix = Union[list[list[float]], list[np.ndarray], np.ndarray]
+    Matrix = list[list[float]] | list[np.ndarray] | np.ndarray
 
 logger = logging.getLogger(__name__)
 

langchain_core/version.py

@@ -1,3 +1,3 @@
 """langchain-core version information and utilities."""
 
-VERSION = "1.0.0a6"
+VERSION = "1.0.0a8"

{langchain_core-1.0.0a6.dist-info → langchain_core-1.0.0a8.dist-info}/METADATA

@@ -1,19 +1,19 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: langchain-core
-Version: 1.0.0a6
+Version: 1.0.0a8
 Summary: Building applications with LLMs through composability
-License: MIT
 Project-URL: Source Code, https://github.com/langchain-ai/langchain/tree/master/libs/core
 Project-URL: Release Notes, https://github.com/langchain-ai/langchain/releases?q=tag%3A%22langchain-core%3D%3D0%22&expanded=true
 Project-URL: repository, https://github.com/langchain-ai/langchain
+License: MIT
 Requires-Python: <4.0.0,>=3.10.0
-Requires-Dist: langsmith<1.0.0,>=0.3.45
-Requires-Dist: tenacity!=8.4.0,<10.0.0,>=8.1.0
 Requires-Dist: jsonpatch<2.0.0,>=1.33.0
-Requires-Dist: PyYAML<7.0.0,>=5.3.0
-Requires-Dist: typing-extensions<5.0.0,>=4.7.0
+Requires-Dist: langsmith<1.0.0,>=0.3.45
 Requires-Dist: packaging<26.0.0,>=23.2.0
 Requires-Dist: pydantic<3.0.0,>=2.7.4
+Requires-Dist: pyyaml<7.0.0,>=5.3.0
+Requires-Dist: tenacity!=8.4.0,<10.0.0,>=8.1.0
+Requires-Dist: typing-extensions<5.0.0,>=4.7.0
 Description-Content-Type: text/markdown
 
 # 🦜🍎️ LangChain Core
@@ -35,7 +35,7 @@ These abstractions are designed to be as modular and simple as possible.
 
 The benefit of having these abstractions is that any provider can implement the required interface and then easily be used in the rest of the LangChain ecosystem.
 
-For full documentation see the [API reference](https://python.langchain.com/api_reference/core/index.html).
+For full documentation see the [API reference](https://reference.langchain.com/python/).
 
 ## ⛰️ Why build on top of LangChain Core?
 
@@ -47,21 +47,10 @@ The LangChain ecosystem is built on top of `langchain-core`. Some of the benefit
 
 ## 📕 Releases & Versioning
 
-As `langchain-core` contains the base abstractions and runtime for the whole LangChain ecosystem, we will communicate any breaking changes with advance notice and version bumps. The exception for this is anything in `langchain_core.beta`. The reason for `langchain_core.beta` is that given the rate of change of the field, being able to move quickly is still a priority, and this module is our attempt to do so.
-
-Minor version increases will occur for:
-
-- Breaking changes for any public interfaces NOT in `langchain_core.beta`
-
-Patch version increases will occur for:
-
-- Bug fixes
-- New features
-- Any changes to private interfaces
-- Any changes to `langchain_core.beta`
+See our [Releases](https://docs.langchain.com/oss/python/release-policy) and [Versioning Policy](https://docs.langchain.com/oss/python/versioning).
 
 ## 💁 Contributing
 
 As an open-source project in a rapidly developing field, we are extremely open to contributions, whether it be in the form of a new feature, improved infrastructure, or better documentation.
 
-For detailed information on how to contribute, see the [Contributing Guide](https://python.langchain.com/docs/contributing/).
+For detailed information on how to contribute, see the [Contributing Guide](https://docs.langchain.com/oss/python/contributing).