The agent engineering platform.
Python agentsaiai-agentsanthropicchatgptdeepagentsenterpriseframeworkgeminigenerative-ailangchainlanggraphllmmultiagentopen-sourceopenaipydanticpythonragtypescript
chore(core): fix some ruff TC rules (#33929)
Christophe Bornet2bfbc29ccc22
diff --git a/libs/core/langchain_core/callbacks/base.py b/libs/core/langchain_core/callbacks/base.pyindex af455bd970..f6b6b45742 100644--- a/libs/core/langchain_core/callbacks/base.py+++ b/libs/core/langchain_core/callbacks/base.py@@ -5,13 +5,12 @@ from __future__ import annotationsimport loggingfrom typing import TYPE_CHECKING, Any-from typing_extensions import Self-if TYPE_CHECKING:from collections.abc import Sequencefrom uuid import UUIDfrom tenacity import RetryCallState+ from typing_extensions import Selffrom langchain_core.agents import AgentAction, AgentFinishfrom langchain_core.documents import Documentdiff --git a/libs/core/langchain_core/callbacks/manager.py b/libs/core/langchain_core/callbacks/manager.pyindex 29db63609d..7ed53f7400 100644--- a/libs/core/langchain_core/callbacks/manager.py+++ b/libs/core/langchain_core/callbacks/manager.py@@ -39,7 +39,6 @@ from langchain_core.tracers.context import (tracing_v2_callback_var,)from langchain_core.tracers.langchain import LangChainTracer-from langchain_core.tracers.schemas import Runfrom langchain_core.tracers.stdout import ConsoleCallbackHandlerfrom langchain_core.utils.env import env_var_is_set@@ -52,6 +51,7 @@ if TYPE_CHECKING:from langchain_core.documents import Documentfrom langchain_core.outputs import ChatGenerationChunk, GenerationChunk, LLMResultfrom langchain_core.runnables.config import RunnableConfig+ from langchain_core.tracers.schemas import Runlogger = logging.getLogger(__name__)diff --git a/libs/core/langchain_core/indexing/api.py b/libs/core/langchain_core/indexing/api.pyindex de42a4f4f8..860d34f335 100644--- a/libs/core/langchain_core/indexing/api.py+++ b/libs/core/langchain_core/indexing/api.py@@ -6,16 +6,9 @@ import hashlibimport jsonimport uuidimport warnings-from collections.abc import (- AsyncIterable,- AsyncIterator,- Callable,- Iterable,- Iterator,- Sequence,-)from itertools import islicefrom typing import (+ TYPE_CHECKING,Any,Literal,TypedDict,@@ -29,6 +22,16 @@ from langchain_core.exceptions import LangChainExceptionfrom langchain_core.indexing.base import DocumentIndex, RecordManagerfrom langchain_core.vectorstores import VectorStore+if TYPE_CHECKING:+ from collections.abc import (+ AsyncIterable,+ AsyncIterator,+ Callable,+ Iterable,+ Iterator,+ Sequence,+ )+# Magic UUID to use as a namespace for hashing.# Used to try and generate a unique UUID for each document# from hashing the document content and metadata.diff --git a/libs/core/langchain_core/messages/base.py b/libs/core/langchain_core/messages/base.pyindex 05ce4e57fd..0cc7614e53 100644--- a/libs/core/langchain_core/messages/base.py+++ b/libs/core/langchain_core/messages/base.py@@ -5,11 +5,9 @@ from __future__ import annotationsfrom typing import TYPE_CHECKING, Any, cast, overloadfrom pydantic import ConfigDict, Field-from typing_extensions import Selffrom langchain_core._api.deprecation import warn_deprecatedfrom langchain_core.load.serializable import Serializable-from langchain_core.messages import content as typesfrom langchain_core.utils import get_bolded_textfrom langchain_core.utils._merge import merge_dicts, merge_listsfrom langchain_core.utils.interactive_env import is_interactive_env@@ -17,6 +15,9 @@ from langchain_core.utils.interactive_env import is_interactive_envif TYPE_CHECKING:from collections.abc import Sequence+ from typing_extensions import Self++ from langchain_core.messages import content as typesfrom langchain_core.prompts.chat import ChatPromptTemplatediff --git a/libs/core/langchain_core/messages/block_translators/__init__.py b/libs/core/langchain_core/messages/block_translators/__init__.pyindex 9d0c67ea7d..44ddc2515c 100644--- a/libs/core/langchain_core/messages/block_translators/__init__.py+++ b/libs/core/langchain_core/messages/block_translators/__init__.py@@ -12,10 +12,11 @@ the implementation in `BaseMessage`.from __future__ import annotations-from collections.abc import Callablefrom typing import TYPE_CHECKINGif TYPE_CHECKING:+ from collections.abc import Callable+from langchain_core.messages import AIMessage, AIMessageChunkfrom langchain_core.messages import content as typesdiff --git a/libs/core/langchain_core/messages/block_translators/openai.py b/libs/core/langchain_core/messages/block_translators/openai.pyindex f70c15feca..1bc4b3f64f 100644--- a/libs/core/langchain_core/messages/block_translators/openai.py+++ b/libs/core/langchain_core/messages/block_translators/openai.py@@ -4,7 +4,6 @@ from __future__ import annotationsimport jsonimport warnings-from collections.abc import Iterablefrom typing import TYPE_CHECKING, Any, Literal, castfrom langchain_core.language_models._utils import (@@ -14,6 +13,8 @@ from langchain_core.language_models._utils import (from langchain_core.messages import content as typesif TYPE_CHECKING:+ from collections.abc import Iterable+from langchain_core.messages import AIMessage, AIMessageChunkdiff --git a/libs/core/langchain_core/outputs/chat_generation.py b/libs/core/langchain_core/outputs/chat_generation.pyindex 209f08937a..96605d939e 100644--- a/libs/core/langchain_core/outputs/chat_generation.py+++ b/libs/core/langchain_core/outputs/chat_generation.py@@ -2,15 +2,17 @@from __future__ import annotations-from typing import Literal+from typing import TYPE_CHECKING, Literalfrom pydantic import model_validator-from typing_extensions import Selffrom langchain_core.messages import BaseMessage, BaseMessageChunkfrom langchain_core.outputs.generation import Generationfrom langchain_core.utils._merge import merge_dicts+if TYPE_CHECKING:+ from typing_extensions import Self+class ChatGeneration(Generation):"""A single chat generation output.diff --git a/libs/core/langchain_core/prompts/base.py b/libs/core/langchain_core/prompts/base.pyindex f4cd86fb5c..947550f587 100644--- a/libs/core/langchain_core/prompts/base.py+++ b/libs/core/langchain_core/prompts/base.py@@ -6,7 +6,7 @@ import contextlibimport jsonimport typingfrom abc import ABC, abstractmethod-from collections.abc import Callable, Mapping+from collections.abc import Mappingfrom functools import cached_propertyfrom pathlib import Pathfrom typing import (@@ -33,6 +33,8 @@ from langchain_core.runnables.config import ensure_configfrom langchain_core.utils.pydantic import create_model_v2if TYPE_CHECKING:+ from collections.abc import Callable+from langchain_core.documents import Documentdiff --git a/libs/core/langchain_core/prompts/message.py b/libs/core/langchain_core/prompts/message.pyindex bf52af4959..fb7dd88b5c 100644--- a/libs/core/langchain_core/prompts/message.py+++ b/libs/core/langchain_core/prompts/message.py@@ -6,10 +6,10 @@ from abc import ABC, abstractmethodfrom typing import TYPE_CHECKING, Anyfrom langchain_core.load import Serializable-from langchain_core.messages import BaseMessagefrom langchain_core.utils.interactive_env import is_interactive_envif TYPE_CHECKING:+ from langchain_core.messages import BaseMessagefrom langchain_core.prompts.chat import ChatPromptTemplatediff --git a/libs/core/langchain_core/prompts/string.py b/libs/core/langchain_core/prompts/string.pyindex c93615fdb3..ee4835b1bf 100644--- a/libs/core/langchain_core/prompts/string.py+++ b/libs/core/langchain_core/prompts/string.py@@ -4,9 +4,8 @@ from __future__ import annotationsimport warningsfrom abc import ABC-from collections.abc import Callable, Sequencefrom string import Formatter-from typing import Any, Literal+from typing import TYPE_CHECKING, Any, Literalfrom pydantic import BaseModel, create_model@@ -16,6 +15,9 @@ from langchain_core.utils import get_colored_text, mustachefrom langchain_core.utils.formatting import formatterfrom langchain_core.utils.interactive_env import is_interactive_env+if TYPE_CHECKING:+ from collections.abc import Callable, Sequence+try:from jinja2 import Environment, metafrom jinja2.sandbox import SandboxedEnvironmentdiff --git a/libs/core/langchain_core/runnables/graph.py b/libs/core/langchain_core/runnables/graph.pyindex 76f1cc1f5b..3e1aa1cc42 100644--- a/libs/core/langchain_core/runnables/graph.py+++ b/libs/core/langchain_core/runnables/graph.py@@ -4,7 +4,6 @@ from __future__ import annotationsimport inspectfrom collections import defaultdict-from collections.abc import Callablefrom dataclasses import dataclass, fieldfrom enum import Enumfrom typing import (@@ -22,7 +21,7 @@ from langchain_core.runnables.base import Runnable, RunnableSerializablefrom langchain_core.utils.pydantic import _IgnoreUnserializable, is_basemodel_subclassif TYPE_CHECKING:- from collections.abc import Sequence+ from collections.abc import Callable, Sequencefrom pydantic import BaseModeldiff --git a/libs/core/langchain_core/runnables/graph_ascii.py b/libs/core/langchain_core/runnables/graph_ascii.pyindex b7d6edf39b..05692b857c 100644--- a/libs/core/langchain_core/runnables/graph_ascii.py+++ b/libs/core/langchain_core/runnables/graph_ascii.py@@ -7,7 +7,6 @@ from __future__ import annotationsimport mathimport os-from collections.abc import Mapping, Sequencefrom typing import TYPE_CHECKING, Anytry:@@ -20,6 +19,8 @@ except ImportError:_HAS_GRANDALF = Falseif TYPE_CHECKING:+ from collections.abc import Mapping, Sequence+from langchain_core.runnables.graph import Edge as LangEdgediff --git a/libs/core/langchain_core/runnables/utils.py b/libs/core/langchain_core/runnables/utils.pyindex 4860e70bc2..2c013f6123 100644--- a/libs/core/langchain_core/runnables/utils.py+++ b/libs/core/langchain_core/runnables/utils.py@@ -7,8 +7,7 @@ import asyncioimport inspectimport sysimport textwrap-from collections.abc import Callable, Mapping, Sequence-from contextvars import Context+from collections.abc import Mapping, Sequencefrom functools import lru_cachefrom inspect import signaturefrom itertools import groupby@@ -31,9 +30,11 @@ if TYPE_CHECKING:AsyncIterable,AsyncIterator,Awaitable,+ Callable,Coroutine,Iterable,)+ from contextvars import Contextfrom langchain_core.runnables.schema import StreamEventdiff --git a/libs/core/langchain_core/tracers/core.py b/libs/core/langchain_core/tracers/core.pyindex e027d78a32..97a2092d15 100644--- a/libs/core/langchain_core/tracers/core.py+++ b/libs/core/langchain_core/tracers/core.py@@ -15,12 +15,6 @@ from typing import (from langchain_core.exceptions import TracerExceptionfrom langchain_core.load import dumpd-from langchain_core.outputs import (- ChatGeneration,- ChatGenerationChunk,- GenerationChunk,- LLMResult,-)from langchain_core.tracers.schemas import Runif TYPE_CHECKING:@@ -31,6 +25,12 @@ if TYPE_CHECKING:from langchain_core.documents import Documentfrom langchain_core.messages import BaseMessage+ from langchain_core.outputs import (+ ChatGeneration,+ ChatGenerationChunk,+ GenerationChunk,+ LLMResult,+ )logger = logging.getLogger(__name__)diff --git a/libs/core/langchain_core/utils/function_calling.py b/libs/core/langchain_core/utils/function_calling.pyindex f96b3ee1a9..6fe3e35a61 100644--- a/libs/core/langchain_core/utils/function_calling.py+++ b/libs/core/langchain_core/utils/function_calling.py@@ -8,7 +8,6 @@ import loggingimport typesimport typingimport uuid-from collections.abc import Callablefrom typing import (TYPE_CHECKING,Annotated,@@ -33,6 +32,8 @@ from langchain_core.utils.json_schema import dereference_refsfrom langchain_core.utils.pydantic import is_basemodel_subclassif TYPE_CHECKING:+ from collections.abc import Callable+from langchain_core.tools import BaseToollogger = logging.getLogger(__name__)diff --git a/libs/core/langchain_core/utils/json.py b/libs/core/langchain_core/utils/json.pyindex 9c00b11f94..0d5907b4d6 100644--- a/libs/core/langchain_core/utils/json.py+++ b/libs/core/langchain_core/utils/json.py@@ -4,11 +4,13 @@ from __future__ import annotationsimport jsonimport re-from collections.abc import Callable-from typing import Any+from typing import TYPE_CHECKING, Anyfrom langchain_core.exceptions import OutputParserException+if TYPE_CHECKING:+ from collections.abc import Callable+def _replace_new_line(match: re.Match[str]) -> str:value = match.group(2)diff --git a/libs/core/langchain_core/utils/pydantic.py b/libs/core/langchain_core/utils/pydantic.pyindex fd3413e715..514a3f8fc4 100644--- a/libs/core/langchain_core/utils/pydantic.py+++ b/libs/core/langchain_core/utils/pydantic.py@@ -5,7 +5,6 @@ from __future__ import annotationsimport inspectimport textwrapimport warnings-from collections.abc import Callablefrom contextlib import nullcontextfrom functools import lru_cache, wrapsfrom types import GenericAlias@@ -41,10 +40,12 @@ from pydantic.json_schema import ()from pydantic.v1 import BaseModel as BaseModelV1from pydantic.v1 import create_model as create_model_v1-from pydantic.v1.fields import ModelFieldfrom typing_extensions import deprecated, overrideif TYPE_CHECKING:+ from collections.abc import Callable++ from pydantic.v1.fields import ModelFieldfrom pydantic_core import core_schemaPYDANTIC_VERSION = version.parse(pydantic.__version__)diff --git a/libs/core/langchain_core/vectorstores/base.py b/libs/core/langchain_core/vectorstores/base.pyindex 3580f5e9cd..1f7f73e709 100644--- a/libs/core/langchain_core/vectorstores/base.py+++ b/libs/core/langchain_core/vectorstores/base.py@@ -11,7 +11,6 @@ import loggingimport mathimport warningsfrom abc import ABC, abstractmethod-from collections.abc import Callablefrom itertools import cyclefrom typing import (TYPE_CHECKING,@@ -29,7 +28,7 @@ from langchain_core.retrievers import BaseRetriever, LangSmithRetrieverParamsfrom langchain_core.runnables.config import run_in_executorif TYPE_CHECKING:- from collections.abc import Collection, Iterable, Iterator, Sequence+ from collections.abc import Callable, Collection, Iterable, Iterator, Sequencefrom langchain_core.callbacks.manager import (AsyncCallbackManagerForRetrieverRun,diff --git a/libs/core/langchain_core/vectorstores/in_memory.py b/libs/core/langchain_core/vectorstores/in_memory.pyindex cb8a9b1985..919cd6a377 100644--- a/libs/core/langchain_core/vectorstores/in_memory.py+++ b/libs/core/langchain_core/vectorstores/in_memory.py@@ -4,7 +4,6 @@ from __future__ import annotationsimport jsonimport uuid-from collections.abc import Callablefrom pathlib import Pathfrom typing import (TYPE_CHECKING,@@ -20,7 +19,7 @@ from langchain_core.vectorstores.utils import _cosine_similarity as cosine_similfrom langchain_core.vectorstores.utils import maximal_marginal_relevanceif TYPE_CHECKING:- from collections.abc import Iterator, Sequence+ from collections.abc import Callable, Iterator, Sequencefrom langchain_core.embeddings import Embeddingsdiff --git a/libs/core/tests/unit_tests/runnables/test_concurrency.py b/libs/core/tests/unit_tests/runnables/test_concurrency.pyindex 60022b803d..72196881d2 100644--- a/libs/core/tests/unit_tests/runnables/test_concurrency.py+++ b/libs/core/tests/unit_tests/runnables/test_concurrency.py@@ -3,12 +3,14 @@import asyncioimport timefrom threading import Lock-from typing import Any+from typing import TYPE_CHECKING, Anyimport pytestfrom langchain_core.runnables import RunnableConfig, RunnableLambda-from langchain_core.runnables.base import Runnable++if TYPE_CHECKING:+ from langchain_core.runnables.base import Runnable@pytest.mark.asynciodiff --git a/libs/core/tests/unit_tests/runnables/test_tracing_interops.py b/libs/core/tests/unit_tests/runnables/test_tracing_interops.pyindex e5638b3e8e..4fb9ab3cad 100644--- a/libs/core/tests/unit_tests/runnables/test_tracing_interops.py+++ b/libs/core/tests/unit_tests/runnables/test_tracing_interops.py@@ -3,21 +3,25 @@ from __future__ import annotationsimport jsonimport sysimport uuid-from collections.abc import AsyncGenerator, Callable, Coroutine, Generatorfrom inspect import isasyncgenfunction-from typing import Any, Literal+from typing import TYPE_CHECKING, Any, Literalfrom unittest.mock import MagicMock, patchimport pytestfrom langsmith import Client, get_current_run_tree, traceablefrom langsmith.run_helpers import tracing_context-from langsmith.run_trees import RunTreefrom langsmith.utils import get_env_var-from langchain_core.callbacks import BaseCallbackHandlerfrom langchain_core.runnables.base import RunnableLambda, RunnableParallelfrom langchain_core.tracers.langchain import LangChainTracer+if TYPE_CHECKING:+ from collections.abc import AsyncGenerator, Callable, Coroutine, Generator++ from langsmith.run_trees import RunTree++ from langchain_core.callbacks import BaseCallbackHandler+def _get_posts(client: Client) -> list:mock_calls = client.session.request.mock_calls # type: ignore[attr-defined]diff --git a/libs/core/tests/unit_tests/utils/test_utils.py b/libs/core/tests/unit_tests/utils/test_utils.pyindex f70063c421..c492980047 100644--- a/libs/core/tests/unit_tests/utils/test_utils.py+++ b/libs/core/tests/unit_tests/utils/test_utils.py@@ -1,10 +1,9 @@import osimport reimport sys-from collections.abc import Callablefrom contextlib import AbstractContextManager, nullcontextfrom copy import deepcopy-from typing import Any+from typing import TYPE_CHECKING, Anyfrom unittest.mock import patchimport pytest@@ -23,6 +22,9 @@ from langchain_core.utils import (from langchain_core.utils._merge import merge_dictsfrom langchain_core.utils.utils import secret_from_env+if TYPE_CHECKING:+ from collections.abc import Callable+@pytest.mark.parametrize(("package", "check_kwargs", "actual_version", "expected"),