langchain 0.4.0.dev0__py3-none-any.whl → 1.0.0__py3-none-any.whl

langchain/retrievers/self_query/elasticsearch.py

@@ -1,25 +0,0 @@
-from typing import TYPE_CHECKING, Any
-
-from langchain._api import create_importer
-
-if TYPE_CHECKING:
-    from langchain_community.query_constructors.elasticsearch import (
-        ElasticsearchTranslator,
-    )
-
-# Create a way to dynamically look up deprecated imports.
-# Used to consolidate logic for raising deprecation warnings and
-# handling optional imports.
-DEPRECATED_LOOKUP = {
-    "ElasticsearchTranslator": "langchain_community.query_constructors.elasticsearch",
-}
-
-_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
-
-
-def __getattr__(name: str) -> Any:
-    """Look up attributes dynamically."""
-    return _import_attribute(name)
-
-
-__all__ = ["ElasticsearchTranslator"]

langchain/retrievers/self_query/milvus.py

@@ -1,27 +0,0 @@
-from typing import TYPE_CHECKING, Any
-
-from langchain._api import create_importer
-
-if TYPE_CHECKING:
-    from langchain_community.query_constructors.milvus import (
-        MilvusTranslator,
-        process_value,
-    )
-
-# Create a way to dynamically look up deprecated imports.
-# Used to consolidate logic for raising deprecation warnings and
-# handling optional imports.
-DEPRECATED_LOOKUP = {
-    "MilvusTranslator": "langchain_community.query_constructors.milvus",
-    "process_value": "langchain_community.query_constructors.milvus",
-}
-
-_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
-
-
-def __getattr__(name: str) -> Any:
-    """Look up attributes dynamically."""
-    return _import_attribute(name)
-
-
-__all__ = ["MilvusTranslator", "process_value"]

langchain/retrievers/self_query/mongodb_atlas.py

@@ -1,25 +0,0 @@
-from typing import TYPE_CHECKING, Any
-
-from langchain._api import create_importer
-
-if TYPE_CHECKING:
-    from langchain_community.query_constructors.mongodb_atlas import (
-        MongoDBAtlasTranslator,
-    )
-
-# Create a way to dynamically look up deprecated imports.
-# Used to consolidate logic for raising deprecation warnings and
-# handling optional imports.
-DEPRECATED_LOOKUP = {
-    "MongoDBAtlasTranslator": "langchain_community.query_constructors.mongodb_atlas",
-}
-
-_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
-
-
-def __getattr__(name: str) -> Any:
-    """Look up attributes dynamically."""
-    return _import_attribute(name)
-
-
-__all__ = ["MongoDBAtlasTranslator"]

langchain/retrievers/self_query/myscale.py

@@ -1,23 +0,0 @@
-from typing import TYPE_CHECKING, Any
-
-from langchain._api import create_importer
-
-if TYPE_CHECKING:
-    from langchain_community.query_constructors.myscale import MyScaleTranslator
-
-# Create a way to dynamically look up deprecated imports.
-# Used to consolidate logic for raising deprecation warnings and
-# handling optional imports.
-DEPRECATED_LOOKUP = {
-    "MyScaleTranslator": "langchain_community.query_constructors.myscale",
-}
-
-_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
-
-
-def __getattr__(name: str) -> Any:
-    """Look up attributes dynamically."""
-    return _import_attribute(name)
-
-
-__all__ = ["MyScaleTranslator"]

langchain/retrievers/self_query/opensearch.py

@@ -1,23 +0,0 @@
-from typing import TYPE_CHECKING, Any
-
-from langchain._api import create_importer
-
-if TYPE_CHECKING:
-    from langchain_community.query_constructors.opensearch import OpenSearchTranslator
-
-# Create a way to dynamically look up deprecated imports.
-# Used to consolidate logic for raising deprecation warnings and
-# handling optional imports.
-DEPRECATED_LOOKUP = {
-    "OpenSearchTranslator": "langchain_community.query_constructors.opensearch",
-}
-
-_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
-
-
-def __getattr__(name: str) -> Any:
-    """Look up attributes dynamically."""
-    return _import_attribute(name)
-
-
-__all__ = ["OpenSearchTranslator"]

langchain/retrievers/self_query/pgvector.py

@@ -1,23 +0,0 @@
-from typing import TYPE_CHECKING, Any
-
-from langchain._api import create_importer
-
-if TYPE_CHECKING:
-    from langchain_community.query_constructors.pgvector import PGVectorTranslator
-
-# Create a way to dynamically look up deprecated imports.
-# Used to consolidate logic for raising deprecation warnings and
-# handling optional imports.
-DEPRECATED_LOOKUP = {
-    "PGVectorTranslator": "langchain_community.query_constructors.pgvector",
-}
-
-_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
-
-
-def __getattr__(name: str) -> Any:
-    """Look up attributes dynamically."""
-    return _import_attribute(name)
-
-
-__all__ = ["PGVectorTranslator"]

langchain/retrievers/self_query/pinecone.py

@@ -1,23 +0,0 @@
-from typing import TYPE_CHECKING, Any
-
-from langchain._api import create_importer
-
-if TYPE_CHECKING:
-    from langchain_community.query_constructors.pinecone import PineconeTranslator
-
-# Create a way to dynamically look up deprecated imports.
-# Used to consolidate logic for raising deprecation warnings and
-# handling optional imports.
-DEPRECATED_LOOKUP = {
-    "PineconeTranslator": "langchain_community.query_constructors.pinecone",
-}
-
-_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
-
-
-def __getattr__(name: str) -> Any:
-    """Look up attributes dynamically."""
-    return _import_attribute(name)
-
-
-__all__ = ["PineconeTranslator"]

langchain/retrievers/self_query/qdrant.py

@@ -1,23 +0,0 @@
-from typing import TYPE_CHECKING, Any
-
-from langchain._api import create_importer
-
-if TYPE_CHECKING:
-    from langchain_community.query_constructors.qdrant import QdrantTranslator
-
-# Create a way to dynamically look up deprecated imports.
-# Used to consolidate logic for raising deprecation warnings and
-# handling optional imports.
-DEPRECATED_LOOKUP = {
-    "QdrantTranslator": "langchain_community.query_constructors.qdrant",
-}
-
-_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
-
-
-def __getattr__(name: str) -> Any:
-    """Look up attributes dynamically."""
-    return _import_attribute(name)
-
-
-__all__ = ["QdrantTranslator"]

langchain/retrievers/self_query/redis.py

@@ -1,23 +0,0 @@
-from typing import TYPE_CHECKING, Any
-
-from langchain._api import create_importer
-
-if TYPE_CHECKING:
-    from langchain_community.query_constructors.redis import RedisTranslator
-
-# Create a way to dynamically look up deprecated imports.
-# Used to consolidate logic for raising deprecation warnings and
-# handling optional imports.
-DEPRECATED_LOOKUP = {
-    "RedisTranslator": "langchain_community.query_constructors.redis",
-}
-
-_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
-
-
-def __getattr__(name: str) -> Any:
-    """Look up attributes dynamically."""
-    return _import_attribute(name)
-
-
-__all__ = ["RedisTranslator"]

langchain/retrievers/self_query/supabase.py

@@ -1,23 +0,0 @@
-from typing import TYPE_CHECKING, Any
-
-from langchain._api import create_importer
-
-if TYPE_CHECKING:
-    from langchain_community.query_constructors.supabase import SupabaseVectorTranslator
-
-# Create a way to dynamically look up deprecated imports.
-# Used to consolidate logic for raising deprecation warnings and
-# handling optional imports.
-DEPRECATED_LOOKUP = {
-    "SupabaseVectorTranslator": "langchain_community.query_constructors.supabase",
-}
-
-_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
-
-
-def __getattr__(name: str) -> Any:
-    """Look up attributes dynamically."""
-    return _import_attribute(name)
-
-
-__all__ = ["SupabaseVectorTranslator"]

langchain/retrievers/self_query/tencentvectordb.py

@@ -1,27 +0,0 @@
-from typing import TYPE_CHECKING, Any
-
-from langchain._api import create_importer
-
-if TYPE_CHECKING:
-    from langchain_community.query_constructors.tencentvectordb import (
-        TencentVectorDBTranslator,
-    )
-
-# Create a way to dynamically look up deprecated imports.
-# Used to consolidate logic for raising deprecation warnings and
-# handling optional imports.
-DEPRECATED_LOOKUP = {
-    "TencentVectorDBTranslator": (
-        "langchain_community.query_constructors.tencentvectordb"
-    ),
-}
-
-_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
-
-
-def __getattr__(name: str) -> Any:
-    """Look up attributes dynamically."""
-    return _import_attribute(name)
-
-
-__all__ = ["TencentVectorDBTranslator"]

langchain/retrievers/self_query/timescalevector.py

@@ -1,27 +0,0 @@
-from typing import TYPE_CHECKING, Any
-
-from langchain._api import create_importer
-
-if TYPE_CHECKING:
-    from langchain_community.query_constructors.timescalevector import (
-        TimescaleVectorTranslator,
-    )
-
-# Create a way to dynamically look up deprecated imports.
-# Used to consolidate logic for raising deprecation warnings and
-# handling optional imports.
-DEPRECATED_LOOKUP = {
-    "TimescaleVectorTranslator": (
-        "langchain_community.query_constructors.timescalevector"
-    ),
-}
-
-_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
-
-
-def __getattr__(name: str) -> Any:
-    """Look up attributes dynamically."""
-    return _import_attribute(name)
-
-
-__all__ = ["TimescaleVectorTranslator"]

langchain/retrievers/self_query/vectara.py

@@ -1,27 +0,0 @@
-from typing import TYPE_CHECKING, Any
-
-from langchain._api import create_importer
-
-if TYPE_CHECKING:
-    from langchain_community.query_constructors.vectara import (
-        VectaraTranslator,
-        process_value,
-    )
-
-# Create a way to dynamically look up deprecated imports.
-# Used to consolidate logic for raising deprecation warnings and
-# handling optional imports.
-DEPRECATED_LOOKUP = {
-    "VectaraTranslator": "langchain_community.query_constructors.vectara",
-    "process_value": "langchain_community.query_constructors.vectara",
-}
-
-_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
-
-
-def __getattr__(name: str) -> Any:
-    """Look up attributes dynamically."""
-    return _import_attribute(name)
-
-
-__all__ = ["VectaraTranslator", "process_value"]

langchain/retrievers/self_query/weaviate.py

@@ -1,23 +0,0 @@
-from typing import TYPE_CHECKING, Any
-
-from langchain._api import create_importer
-
-if TYPE_CHECKING:
-    from langchain_community.query_constructors.weaviate import WeaviateTranslator
-
-# Create a way to dynamically look up deprecated imports.
-# Used to consolidate logic for raising deprecation warnings and
-# handling optional imports.
-DEPRECATED_LOOKUP = {
-    "WeaviateTranslator": "langchain_community.query_constructors.weaviate",
-}
-
-_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
-
-
-def __getattr__(name: str) -> Any:
-    """Look up attributes dynamically."""
-    return _import_attribute(name)
-
-
-__all__ = ["WeaviateTranslator"]

langchain/retrievers/svm.py

@@ -1,23 +0,0 @@
-from typing import TYPE_CHECKING, Any
-
-from langchain._api import create_importer
-
-if TYPE_CHECKING:
-    from langchain_community.retrievers import SVMRetriever
-
-# Create a way to dynamically look up deprecated imports.
-# Used to consolidate logic for raising deprecation warnings and
-# handling optional imports.
-DEPRECATED_LOOKUP = {"SVMRetriever": "langchain_community.retrievers"}
-
-_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
-
-
-def __getattr__(name: str) -> Any:
-    """Look up attributes dynamically."""
-    return _import_attribute(name)
-
-
-__all__ = [
-    "SVMRetriever",
-]

langchain/retrievers/tavily_search_api.py

@@ -1,28 +0,0 @@
-from typing import TYPE_CHECKING, Any
-
-from langchain._api import create_importer
-
-if TYPE_CHECKING:
-    from langchain_community.retrievers import TavilySearchAPIRetriever
-    from langchain_community.retrievers.tavily_search_api import SearchDepth
-
-# Create a way to dynamically look up deprecated imports.
-# Used to consolidate logic for raising deprecation warnings and
-# handling optional imports.
-DEPRECATED_LOOKUP = {
-    "SearchDepth": "langchain_community.retrievers.tavily_search_api",
-    "TavilySearchAPIRetriever": "langchain_community.retrievers",
-}
-
-_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
-
-
-def __getattr__(name: str) -> Any:
-    """Look up attributes dynamically."""
-    return _import_attribute(name)
-
-
-__all__ = [
-    "SearchDepth",
-    "TavilySearchAPIRetriever",
-]

langchain/retrievers/tfidf.py

@@ -1,23 +0,0 @@
-from typing import TYPE_CHECKING, Any
-
-from langchain._api import create_importer
-
-if TYPE_CHECKING:
-    from langchain_community.retrievers import TFIDFRetriever
-
-# Create a way to dynamically look up deprecated imports.
-# Used to consolidate logic for raising deprecation warnings and
-# handling optional imports.
-DEPRECATED_LOOKUP = {"TFIDFRetriever": "langchain_community.retrievers"}
-
-_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
-
-
-def __getattr__(name: str) -> Any:
-    """Look up attributes dynamically."""
-    return _import_attribute(name)
-
-
-__all__ = [
-    "TFIDFRetriever",
-]

langchain/retrievers/time_weighted_retriever.py

@@ -1,196 +0,0 @@
-import datetime
-from copy import deepcopy
-from typing import Any, Optional
-
-from langchain_core.callbacks import (
-    AsyncCallbackManagerForRetrieverRun,
-    CallbackManagerForRetrieverRun,
-)
-from langchain_core.documents import Document
-from langchain_core.retrievers import BaseRetriever
-from langchain_core.vectorstores import VectorStore
-from pydantic import ConfigDict, Field
-from typing_extensions import override
-
-
-def _get_hours_passed(time: datetime.datetime, ref_time: datetime.datetime) -> float:
-    """Get the hours passed between two datetimes."""
-    return (time - ref_time).total_seconds() / 3600
-
-
-class TimeWeightedVectorStoreRetriever(BaseRetriever):
-    """Retriever that combines embedding similarity with
-    recency in retrieving values."""
-
-    vectorstore: VectorStore
-    """The vectorstore to store documents and determine salience."""
-
-    search_kwargs: dict = Field(default_factory=lambda: {"k": 100})
-    """Keyword arguments to pass to the vectorstore similarity search."""
-
-    # TODO: abstract as a queue
-    memory_stream: list[Document] = Field(default_factory=list)
-    """The memory_stream of documents to search through."""
-
-    decay_rate: float = Field(default=0.01)
-    """The exponential decay factor used as (1.0-decay_rate)**(hrs_passed)."""
-
-    k: int = 4
-    """The maximum number of documents to retrieve in a given call."""
-
-    other_score_keys: list[str] = []
-    """Other keys in the metadata to factor into the score, e.g. 'importance'."""
-
-    default_salience: Optional[float] = None
-    """The salience to assign memories not retrieved from the vector store.
-
-    None assigns no salience to documents not fetched from the vector store.
-    """
-
-    model_config = ConfigDict(
-        arbitrary_types_allowed=True,
-    )
-
-    def _document_get_date(self, field: str, document: Document) -> datetime.datetime:
-        """Return the value of the date field of a document."""
-        if field in document.metadata:
-            if isinstance(document.metadata[field], float):
-                return datetime.datetime.fromtimestamp(document.metadata[field])
-            return document.metadata[field]
-        return datetime.datetime.now()
-
-    def _get_combined_score(
-        self,
-        document: Document,
-        vector_relevance: Optional[float],
-        current_time: datetime.datetime,
-    ) -> float:
-        """Return the combined score for a document."""
-        hours_passed = _get_hours_passed(
-            current_time,
-            self._document_get_date("last_accessed_at", document),
-        )
-        score = (1.0 - self.decay_rate) ** hours_passed
-        for key in self.other_score_keys:
-            if key in document.metadata:
-                score += document.metadata[key]
-        if vector_relevance is not None:
-            score += vector_relevance
-        return score
-
-    def get_salient_docs(self, query: str) -> dict[int, tuple[Document, float]]:
-        """Return documents that are salient to the query."""
-        docs_and_scores: list[tuple[Document, float]]
-        docs_and_scores = self.vectorstore.similarity_search_with_relevance_scores(
-            query,
-            **self.search_kwargs,
-        )
-        results = {}
-        for fetched_doc, relevance in docs_and_scores:
-            if "buffer_idx" in fetched_doc.metadata:
-                buffer_idx = fetched_doc.metadata["buffer_idx"]
-                doc = self.memory_stream[buffer_idx]
-                results[buffer_idx] = (doc, relevance)
-        return results
-
-    async def aget_salient_docs(self, query: str) -> dict[int, tuple[Document, float]]:
-        """Return documents that are salient to the query."""
-        docs_and_scores: list[tuple[Document, float]]
-        docs_and_scores = (
-            await self.vectorstore.asimilarity_search_with_relevance_scores(
-                query,
-                **self.search_kwargs,
-            )
-        )
-        results = {}
-        for fetched_doc, relevance in docs_and_scores:
-            if "buffer_idx" in fetched_doc.metadata:
-                buffer_idx = fetched_doc.metadata["buffer_idx"]
-                doc = self.memory_stream[buffer_idx]
-                results[buffer_idx] = (doc, relevance)
-        return results
-
-    def _get_rescored_docs(
-        self,
-        docs_and_scores: dict[Any, tuple[Document, Optional[float]]],
-    ) -> list[Document]:
-        current_time = datetime.datetime.now()
-        rescored_docs = [
-            (doc, self._get_combined_score(doc, relevance, current_time))
-            for doc, relevance in docs_and_scores.values()
-        ]
-        rescored_docs.sort(key=lambda x: x[1], reverse=True)
-        result = []
-        # Ensure frequently accessed memories aren't forgotten
-        for doc, _ in rescored_docs[: self.k]:
-            # TODO: Update vector store doc once `update` method is exposed.
-            buffered_doc = self.memory_stream[doc.metadata["buffer_idx"]]
-            buffered_doc.metadata["last_accessed_at"] = current_time
-            result.append(buffered_doc)
-        return result
-
-    @override
-    def _get_relevant_documents(
-        self,
-        query: str,
-        *,
-        run_manager: CallbackManagerForRetrieverRun,
-    ) -> list[Document]:
-        docs_and_scores = {
-            doc.metadata["buffer_idx"]: (doc, self.default_salience)
-            for doc in self.memory_stream[-self.k :]
-        }
-        # If a doc is considered salient, update the salience score
-        docs_and_scores.update(self.get_salient_docs(query))
-        return self._get_rescored_docs(docs_and_scores)
-
-    @override
-    async def _aget_relevant_documents(
-        self,
-        query: str,
-        *,
-        run_manager: AsyncCallbackManagerForRetrieverRun,
-    ) -> list[Document]:
-        docs_and_scores = {
-            doc.metadata["buffer_idx"]: (doc, self.default_salience)
-            for doc in self.memory_stream[-self.k :]
-        }
-        # If a doc is considered salient, update the salience score
-        docs_and_scores.update(await self.aget_salient_docs(query))
-        return self._get_rescored_docs(docs_and_scores)
-
-    def add_documents(self, documents: list[Document], **kwargs: Any) -> list[str]:
-        """Add documents to vectorstore."""
-        current_time = kwargs.get("current_time")
-        if current_time is None:
-            current_time = datetime.datetime.now()
-        # Avoid mutating input documents
-        dup_docs = [deepcopy(d) for d in documents]
-        for i, doc in enumerate(dup_docs):
-            if "last_accessed_at" not in doc.metadata:
-                doc.metadata["last_accessed_at"] = current_time
-            if "created_at" not in doc.metadata:
-                doc.metadata["created_at"] = current_time
-            doc.metadata["buffer_idx"] = len(self.memory_stream) + i
-        self.memory_stream.extend(dup_docs)
-        return self.vectorstore.add_documents(dup_docs, **kwargs)
-
-    async def aadd_documents(
-        self,
-        documents: list[Document],
-        **kwargs: Any,
-    ) -> list[str]:
-        """Add documents to vectorstore."""
-        current_time = kwargs.get("current_time")
-        if current_time is None:
-            current_time = datetime.datetime.now()
-        # Avoid mutating input documents
-        dup_docs = [deepcopy(d) for d in documents]
-        for i, doc in enumerate(dup_docs):
-            if "last_accessed_at" not in doc.metadata:
-                doc.metadata["last_accessed_at"] = current_time
-            if "created_at" not in doc.metadata:
-                doc.metadata["created_at"] = current_time
-            doc.metadata["buffer_idx"] = len(self.memory_stream) + i
-        self.memory_stream.extend(dup_docs)
-        return await self.vectorstore.aadd_documents(dup_docs, **kwargs)

langchain/retrievers/vespa_retriever.py

@@ -1,23 +0,0 @@
-from typing import TYPE_CHECKING, Any
-
-from langchain._api import create_importer
-
-if TYPE_CHECKING:
-    from langchain_community.retrievers import VespaRetriever
-
-# Create a way to dynamically look up deprecated imports.
-# Used to consolidate logic for raising deprecation warnings and
-# handling optional imports.
-DEPRECATED_LOOKUP = {"VespaRetriever": "langchain_community.retrievers"}
-
-_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
-
-
-def __getattr__(name: str) -> Any:
-    """Look up attributes dynamically."""
-    return _import_attribute(name)
-
-
-__all__ = [
-    "VespaRetriever",
-]

langchain/retrievers/weaviate_hybrid_search.py

@@ -1,23 +0,0 @@
-from typing import TYPE_CHECKING, Any
-
-from langchain._api import create_importer
-
-if TYPE_CHECKING:
-    from langchain_community.retrievers import WeaviateHybridSearchRetriever
-
-# Create a way to dynamically look up deprecated imports.
-# Used to consolidate logic for raising deprecation warnings and
-# handling optional imports.
-DEPRECATED_LOOKUP = {"WeaviateHybridSearchRetriever": "langchain_community.retrievers"}
-
-_import_attribute = create_importer(__package__, deprecated_lookups=DEPRECATED_LOOKUP)
-
-
-def __getattr__(name: str) -> Any:
-    """Look up attributes dynamically."""
-    return _import_attribute(name)
-
-
-__all__ = [
-    "WeaviateHybridSearchRetriever",
-]