langchain-core 0.3.72__py3-none-any.whl → 0.4.0.dev0__py3-none-any.whl

langchain_core/runnables/base.py

@@ -97,10 +97,7 @@ if TYPE_CHECKING:
     from langchain_core.runnables.retry import ExponentialJitterParams
     from langchain_core.runnables.schema import StreamEvent
     from langchain_core.tools import BaseTool
-    from langchain_core.tracers.log_stream import (
-        RunLog,
-        RunLogPatch,
-    )
+    from langchain_core.tracers.log_stream import RunLog, RunLogPatch
     from langchain_core.tracers.root_listeners import AsyncListener
     from langchain_core.tracers.schemas import Run
 
@@ -236,6 +233,7 @@ class Runnable(ABC, Generic[Input, Output]):
             )
 
     For a UI (and much more) checkout LangSmith: https://docs.smith.langchain.com/
+
     """  # noqa: E501
 
     name: Optional[str]
@@ -391,6 +389,7 @@ class Runnable(ABC, Generic[Input, Output]):
                 print(runnable.get_input_jsonschema())
 
         .. versionadded:: 0.3.0
+
         """
         return self.get_input_schema(config).model_json_schema()
 
@@ -464,6 +463,7 @@ class Runnable(ABC, Generic[Input, Output]):
                 print(runnable.get_output_jsonschema())
 
         .. versionadded:: 0.3.0
+
         """
         return self.get_output_schema(config).model_json_schema()
 
@@ -620,6 +620,7 @@ class Runnable(ABC, Generic[Input, Output]):
                 sequence.batch([1, 2, 3])
                 await sequence.abatch([1, 2, 3])
                 # -> [4, 6, 8]
+
         """
         return RunnableSequence(self, *others, name=name)
 
@@ -727,7 +728,7 @@ class Runnable(ABC, Generic[Input, Output]):
     @abstractmethod
     def invoke(
         self,
-        input: Input,  # noqa: A002
+        input: Input,
         config: Optional[RunnableConfig] = None,
         **kwargs: Any,
     ) -> Output:
@@ -736,10 +737,10 @@ class Runnable(ABC, Generic[Input, Output]):
         Args:
             input: The input to the Runnable.
             config: A config to use when invoking the Runnable.
-               The config supports standard keys like 'tags', 'metadata' for tracing
-               purposes, 'max_concurrency' for controlling how much work to do
-               in parallel, and other keys. Please refer to the RunnableConfig
-               for more details.
+                The config supports standard keys like ``'tags'``, ``'metadata'`` for
+                tracing purposes, ``'max_concurrency'`` for controlling how much work to
+                do in parallel, and other keys. Please refer to the RunnableConfig
+                for more details. Defaults to None.
 
         Returns:
             The output of the Runnable.
@@ -747,7 +748,7 @@ class Runnable(ABC, Generic[Input, Output]):
 
     async def ainvoke(
         self,
-        input: Input,  # noqa: A002
+        input: Input,
         config: Optional[RunnableConfig] = None,
         **kwargs: Any,
     ) -> Output:
@@ -885,9 +886,9 @@ class Runnable(ABC, Generic[Input, Output]):
         Args:
             inputs: A list of inputs to the Runnable.
             config: A config to use when invoking the Runnable.
-                The config supports standard keys like 'tags', 'metadata' for tracing
-                purposes, 'max_concurrency' for controlling how much work to do
-                in parallel, and other keys. Please refer to the RunnableConfig
+                The config supports standard keys like ``'tags'``, ``'metadata'`` for
+                tracing purposes, ``'max_concurrency'`` for controlling how much work to
+                do in parallel, and other keys. Please refer to the RunnableConfig
                 for more details. Defaults to None.
             return_exceptions: Whether to return exceptions instead of raising them.
                 Defaults to False.
@@ -950,10 +951,10 @@ class Runnable(ABC, Generic[Input, Output]):
         Args:
             inputs: A list of inputs to the Runnable.
             config: A config to use when invoking the Runnable.
-                The config supports standard keys like 'tags', 'metadata' for tracing
-                purposes, 'max_concurrency' for controlling how much work to do
-                in parallel, and other keys. Please refer to the RunnableConfig
-                for more details. Defaults to None. Defaults to None.
+                The config supports standard keys like ``'tags'``, ``'metadata'`` for
+                tracing purposes, ``'max_concurrency'`` for controlling how much work to
+                do in parallel, and other keys. Please refer to the RunnableConfig
+                for more details. Defaults to None.
             return_exceptions: Whether to return exceptions instead of raising them.
                 Defaults to False.
             kwargs: Additional keyword arguments to pass to the Runnable.
@@ -995,7 +996,7 @@ class Runnable(ABC, Generic[Input, Output]):
 
     def stream(
         self,
-        input: Input,  # noqa: A002
+        input: Input,
         config: Optional[RunnableConfig] = None,
         **kwargs: Optional[Any],
     ) -> Iterator[Output]:
@@ -1015,7 +1016,7 @@ class Runnable(ABC, Generic[Input, Output]):
 
     async def astream(
         self,
-        input: Input,  # noqa: A002
+        input: Input,
         config: Optional[RunnableConfig] = None,
         **kwargs: Optional[Any],
     ) -> AsyncIterator[Output]:
@@ -1069,7 +1070,7 @@ class Runnable(ABC, Generic[Input, Output]):
 
     async def astream_log(
         self,
-        input: Any,  # noqa: A002
+        input: Any,
         config: Optional[RunnableConfig] = None,
         *,
         diff: bool = True,
@@ -1140,7 +1141,7 @@ class Runnable(ABC, Generic[Input, Output]):
 
     async def astream_events(
         self,
-        input: Any,  # noqa: A002
+        input: Any,
         config: Optional[RunnableConfig] = None,
         *,
         version: Literal["v1", "v2"] = "v2",
@@ -1361,6 +1362,7 @@ class Runnable(ABC, Generic[Input, Output]):
 
         Raises:
             NotImplementedError: If the version is not `v1` or `v2`.
+
         """  # noqa: E501
         from langchain_core.tracers.event_stream import (
             _astream_events_implementation_v1,
@@ -1405,7 +1407,7 @@ class Runnable(ABC, Generic[Input, Output]):
 
     def transform(
         self,
-        input: Iterator[Input],  # noqa: A002
+        input: Iterator[Input],
         config: Optional[RunnableConfig] = None,
         **kwargs: Optional[Any],
     ) -> Iterator[Output]:
@@ -1447,7 +1449,7 @@ class Runnable(ABC, Generic[Input, Output]):
 
     async def atransform(
         self,
-        input: AsyncIterator[Input],  # noqa: A002
+        input: AsyncIterator[Input],
         config: Optional[RunnableConfig] = None,
         **kwargs: Optional[Any],
     ) -> AsyncIterator[Output]:
@@ -1569,18 +1571,17 @@ class Runnable(ABC, Generic[Input, Output]):
     ) -> Runnable[Input, Output]:
         """Bind lifecycle listeners to a Runnable, returning a new Runnable.
 
-        on_start: Called before the Runnable starts running, with the Run object.
-        on_end: Called after the Runnable finishes running, with the Run object.
-        on_error: Called if the Runnable throws an error, with the Run object.
-
         The Run object contains information about the run, including its id,
         type, input, output, error, start_time, end_time, and any tags or metadata
         added to the run.
 
         Args:
-            on_start: Called before the Runnable starts running. Defaults to None.
-            on_end: Called after the Runnable finishes running. Defaults to None.
-            on_error: Called if the Runnable throws an error. Defaults to None.
+            on_start: Called before the Runnable starts running, with the Run object.
+                Defaults to None.
+            on_end: Called after the Runnable finishes running, with the Run object.
+                Defaults to None.
+            on_error: Called if the Runnable throws an error, with the Run object.
+                Defaults to None.
 
         Returns:
             A new Runnable with the listeners bound.
@@ -1608,6 +1609,7 @@ class Runnable(ABC, Generic[Input, Output]):
                 on_end=fn_end
             )
             chain.invoke(2)
+
         """
         from langchain_core.tracers.root_listeners import RootListenersTracer
 
@@ -1636,21 +1638,17 @@ class Runnable(ABC, Generic[Input, Output]):
     ) -> Runnable[Input, Output]:
         """Bind async lifecycle listeners to a Runnable, returning a new Runnable.
 
-        on_start: Asynchronously called before the Runnable starts running.
-        on_end: Asynchronously called after the Runnable finishes running.
-        on_error: Asynchronously called if the Runnable throws an error.
-
         The Run object contains information about the run, including its id,
         type, input, output, error, start_time, end_time, and any tags or metadata
         added to the run.
 
         Args:
-            on_start: Asynchronously called before the Runnable starts running.
-                Defaults to None.
-            on_end: Asynchronously called after the Runnable finishes running.
-                Defaults to None.
-            on_error: Asynchronously called if the Runnable throws an error.
-                Defaults to None.
+            on_start: Called asynchronously before the Runnable starts running,
+                with the Run object. Defaults to None.
+            on_end: Called asynchronously after the Runnable finishes running,
+                with the Run object. Defaults to None.
+            on_error: Called asynchronously if the Runnable throws an error,
+                with the Run object. Defaults to None.
 
         Returns:
             A new Runnable with the listeners bound.
@@ -1830,6 +1828,7 @@ class Runnable(ABC, Generic[Input, Output]):
 
                     runnable = RunnableLambda(_lambda)
                     print(runnable.map().invoke([1, 2, 3])) # [2, 3, 4]
+
         """
         return RunnableEach(bound=self)
 
@@ -2362,6 +2361,7 @@ class Runnable(ABC, Generic[Input, Output]):
         name: Optional[str] = None,
         description: Optional[str] = None,
         arg_types: Optional[dict[str, type]] = None,
+        message_version: Literal["v0", "v1"] = "v0",
     ) -> BaseTool:
         """Create a BaseTool from a Runnable.
 
@@ -2377,6 +2377,11 @@ class Runnable(ABC, Generic[Input, Output]):
             name: The name of the tool. Defaults to None.
             description: The description of the tool. Defaults to None.
             arg_types: A dictionary of argument names to types. Defaults to None.
+            message_version: Version of ToolMessage to return given
+            :class:`~langchain_core.messages.content_blocks.ToolCall` input.
+
+            If ``"v0"``, output will be a v0 :class:`~langchain_core.messages.tool.ToolMessage`.
+            If ``"v1"``, output will be a v1 :class:`~langchain_core.messages.v1.ToolMessage`.
 
         Returns:
             A BaseTool instance.
@@ -2451,7 +2456,8 @@ class Runnable(ABC, Generic[Input, Output]):
             as_tool.invoke("b")
 
         .. versionadded:: 0.2.14
-        """
+
+        """  # noqa: E501
         # Avoid circular import
         from langchain_core.tools import convert_runnable_to_tool
 
@@ -2461,6 +2467,7 @@ class Runnable(ABC, Generic[Input, Output]):
             name=name,
             description=description,
             arg_types=arg_types,
+            message_version=message_version,
         )
 
 
@@ -2522,6 +2529,7 @@ class RunnableSerializable(Serializable, Runnable[Input, Output]):
                 configurable={"output_token_number": 200}
                 ).invoke("tell me something about chess").content
             )
+
         """
         from langchain_core.runnables.configurable import RunnableConfigurableFields
 
@@ -2550,7 +2558,7 @@ class RunnableSerializable(Serializable, Runnable[Input, Output]):
             which: The ConfigurableField instance that will be used to select the
                 alternative.
             default_key: The default key to use if no alternative is selected.
-                Defaults to "default".
+                Defaults to ``'default'``.
             prefix_keys: Whether to prefix the keys with the ConfigurableField id.
                 Defaults to False.
             **kwargs: A dictionary of keys to Runnable instances or callables that
@@ -2566,7 +2574,7 @@ class RunnableSerializable(Serializable, Runnable[Input, Output]):
             from langchain_openai import ChatOpenAI
 
             model = ChatAnthropic(
-                model_name="claude-3-sonnet-20240229"
+                model_name="claude-3-7-sonnet-20250219"
             ).configurable_alternatives(
                 ConfigurableField(id="llm"),
                 default_key="anthropic",
@@ -2582,6 +2590,7 @@ class RunnableSerializable(Serializable, Runnable[Input, Output]):
                     configurable={"llm": "openai"}
                 ).invoke("which organization created you?").content
             )
+
         """
         from langchain_core.runnables.configurable import (
             RunnableConfigurableAlternatives,
@@ -2746,6 +2755,7 @@ class RunnableSequence(RunnableSerializable[Input, Output]):
             async for chunk in chain.astream({'topic': 'colors'}):
                 print('-')  # noqa: T201
                 print(chunk, sep='', flush=True)  # noqa: T201
+
     """
 
     # The steps are broken into first, middle and last, solely for type checking
@@ -3544,6 +3554,7 @@ class RunnableParallel(RunnableSerializable[Input, dict[str, Any]]):
                 for key in chunk:
                     output[key] = output[key] + chunk[key].content
                 print(output)  # noqa: T201
+
     """
 
     steps__: Mapping[str, Runnable[Input, Any]]
@@ -4066,6 +4077,7 @@ class RunnableGenerator(Runnable[Input, Output]):
 
             runnable = chant_chain | RunnableLambda(reverse_generator)
             "".join(runnable.stream({"topic": "waste"}))  # ".elcycer ,esuer ,ecudeR"
+
     """
 
     def __init__(
@@ -4326,6 +4338,7 @@ class RunnableLambda(Runnable[Input, Output]):
             runnable = RunnableLambda(add_one, afunc=add_one_async)
             runnable.invoke(1) # Uses add_one
             await runnable.ainvoke(1) # Uses add_one_async
+
     """
 
     def __init__(
@@ -5180,6 +5193,7 @@ class RunnableEach(RunnableEachBase[Input, Output]):
                                         {'topic':'Art'},
                                         {'topic':'Biology'}])
             print(output)  # noqa: T201
+
     """
 
     @override
@@ -5215,6 +5229,10 @@ class RunnableEach(RunnableEachBase[Input, Output]):
     ) -> RunnableEach[Input, Output]:
         """Bind lifecycle listeners to a Runnable, returning a new Runnable.
 
+        The Run object contains information about the run, including its id,
+        type, input, output, error, start_time, end_time, and any tags or metadata
+        added to the run.
+
         Args:
             on_start: Called before the Runnable starts running, with the Run object.
                 Defaults to None.
@@ -5225,10 +5243,6 @@ class RunnableEach(RunnableEachBase[Input, Output]):
 
         Returns:
             A new Runnable with the listeners bound.
-
-        The Run object contains information about the run, including its id,
-        type, input, output, error, start_time, end_time, and any tags or metadata
-        added to the run.
         """
         return RunnableEach(
             bound=self.bound.with_listeners(
@@ -5245,20 +5259,20 @@ class RunnableEach(RunnableEachBase[Input, Output]):
     ) -> RunnableEach[Input, Output]:
         """Bind async lifecycle listeners to a Runnable, returning a new Runnable.
 
+        The Run object contains information about the run, including its id,
+        type, input, output, error, start_time, end_time, and any tags or metadata
+        added to the run.
+
         Args:
             on_start: Called asynchronously before the Runnable starts running,
-                      with the Run object. Defaults to None.
+                with the Run object. Defaults to None.
             on_end: Called asynchronously after the Runnable finishes running,
-                    with the Run object. Defaults to None.
+                with the Run object. Defaults to None.
             on_error: Called asynchronously if the Runnable throws an error,
-                    with the Run object. Defaults to None.
+                with the Run object. Defaults to None.
 
         Returns:
             A new Runnable with the listeners bound.
-
-        The Run object contains information about the run, including its id,
-        type, input, output, error, start_time, end_time, and any tags or metadata
-        added to the run.
         """
         return RunnableEach(
             bound=self.bound.with_alisteners(
@@ -5714,6 +5728,7 @@ class RunnableBinding(RunnableBindingBase[Input, Output]):
                 kwargs={'stop': ['-']} # <-- Note the additional kwargs
             )
             runnable_binding.invoke('Say "Parrot-MAGIC"') # Should return `Parrot`
+
     """
 
     @override
@@ -5768,6 +5783,10 @@ class RunnableBinding(RunnableBindingBase[Input, Output]):
     ) -> Runnable[Input, Output]:
         """Bind lifecycle listeners to a Runnable, returning a new Runnable.
 
+        The Run object contains information about the run, including its id,
+        type, input, output, error, start_time, end_time, and any tags or metadata
+        added to the run.
+
         Args:
             on_start: Called before the Runnable starts running, with the Run object.
                 Defaults to None.
@@ -5777,9 +5796,7 @@ class RunnableBinding(RunnableBindingBase[Input, Output]):
                 Defaults to None.
 
         Returns:
-            The Runnable object contains information about the run, including its id,
-            type, input, output, error, start_time, end_time, and any tags or metadata
-            added to the run.
+            A new Runnable with the listeners bound.
         """
         from langchain_core.tracers.root_listeners import RootListenersTracer
 
@@ -5992,5 +6009,6 @@ def chain(
 
             for chunk in llm.stream(formatted):
                 yield chunk
+
     """
     return RunnableLambda(func)

langchain_core/runnables/branch.py

@@ -63,6 +63,7 @@ class RunnableBranch(RunnableSerializable[Input, Output]):
 
             branch.invoke("hello") # "HELLO"
             branch.invoke(None) # "goodbye"
+
     """
 
     branches: Sequence[tuple[Runnable[Input, bool], Runnable[Input, Output]]]

langchain_core/runnables/config.py

@@ -402,7 +402,7 @@ def call_func_with_variable_args(
         Callable[[Input, CallbackManagerForChainRun], Output],
         Callable[[Input, CallbackManagerForChainRun, RunnableConfig], Output],
     ],
-    input: Input,  # noqa: A002
+    input: Input,
     config: RunnableConfig,
     run_manager: Optional[CallbackManagerForChainRun] = None,
     **kwargs: Any,
@@ -439,7 +439,7 @@ def acall_func_with_variable_args(
             Awaitable[Output],
         ],
     ],
-    input: Input,  # noqa: A002
+    input: Input,
     config: RunnableConfig,
     run_manager: Optional[AsyncCallbackManagerForChainRun] = None,
     **kwargs: Any,

langchain_core/runnables/configurable.py

@@ -378,6 +378,7 @@ class RunnableConfigurableFields(DynamicRunnable[Input, Output]):
                 {"question": "foo", "context": "bar"},
                 config={"configurable": {"hub_commit": "rlm/rag-prompt-llama"}},
             )
+
     """
 
     fields: dict[str, AnyConfigurableField]
@@ -544,7 +545,7 @@ class RunnableConfigurableAlternatives(DynamicRunnable[Input, Output]):
     """The alternatives to choose from."""
 
     default_key: str = "default"
-    """The enum value to use for the default option. Defaults to "default"."""
+    """The enum value to use for the default option. Defaults to ``'default'``."""
 
     prefix_keys: bool
     """Whether to prefix configurable fields of each alternative with a namespace

langchain_core/runnables/fallbacks.py

@@ -5,12 +5,7 @@ import inspect
 import typing
 from collections.abc import AsyncIterator, Iterator, Sequence
 from functools import wraps
-from typing import (
-    TYPE_CHECKING,
-    Any,
-    Optional,
-    Union,
-)
+from typing import TYPE_CHECKING, Any, Optional, Union
 
 from pydantic import BaseModel, ConfigDict
 from typing_extensions import override
@@ -85,6 +80,7 @@ class RunnableWithFallbacks(RunnableSerializable[Input, Output]):
                 | model
                 | StrOutputParser()
             ).with_fallbacks([RunnableLambda(when_all_is_lost)])
+
     """
 
     runnable: Runnable[Input, Output]
@@ -598,7 +594,7 @@ class RunnableWithFallbacks(RunnableSerializable[Input, Output]):
                 from langchain_anthropic import ChatAnthropic
 
                 gpt_4o = ChatOpenAI(model="gpt-4o")
-                claude_3_sonnet = ChatAnthropic(model="claude-3-sonnet-20240229")
+                claude_3_sonnet = ChatAnthropic(model="claude-3-7-sonnet-20250219")
                 llm = gpt_4o.with_fallbacks([claude_3_sonnet])
 
                 llm.model_name

langchain_core/runnables/graph.py

@@ -114,7 +114,7 @@ class Node(NamedTuple):
     def copy(
         self,
         *,
-        id: Optional[str] = None,  # noqa: A002
+        id: Optional[str] = None,
         name: Optional[str] = None,
     ) -> Node:
         """Return a copy of the node with optional new id and name.
@@ -187,7 +187,7 @@ class MermaidDrawMethod(Enum):
 
 
 def node_data_str(
-    id: str,  # noqa: A002
+    id: str,
     data: Union[type[BaseModel], RunnableType, None],
 ) -> str:
     """Convert the data of a node to a string.
@@ -328,7 +328,7 @@ class Graph:
     def add_node(
         self,
         data: Union[type[BaseModel], RunnableType, None],
-        id: Optional[str] = None,  # noqa: A002
+        id: Optional[str] = None,
         *,
         metadata: Optional[dict[str, Any]] = None,
     ) -> Node:
@@ -611,6 +611,7 @@ class Graph:
 
         Returns:
             The Mermaid syntax string.
+
         """
         from langchain_core.runnables.graph_mermaid import draw_mermaid
 
@@ -681,6 +682,7 @@ class Graph:
 
         Returns:
             The PNG image as bytes.
+
         """
         from langchain_core.runnables.graph_mermaid import draw_mermaid_png
 

langchain_core/runnables/graph_ascii.py

@@ -263,6 +263,7 @@ def draw_ascii(vertices: Mapping[str, str], edges: Sequence[LangEdge]) -> str:
             +---+     +---+
             | 3 |     | 4 |
             +---+     +---+
+
     """
     # NOTE: coordinates might me negative, so we need to shift
     # everything to the positive plane before we actually draw it.

langchain_core/runnables/graph_mermaid.py

@@ -70,6 +70,7 @@ def draw_mermaid(
 
     Returns:
         str: Mermaid graph syntax.
+
     """
     # Initialize Mermaid graph configuration
     original_frontmatter_config = frontmatter_config or {}

langchain_core/runnables/history.py

@@ -311,6 +311,7 @@ class RunnableWithMessageHistory(RunnableBindingBase):
                 into the get_session_history factory.
             **kwargs: Arbitrary additional kwargs to pass to parent class
                 ``RunnableBindingBase`` init.
+
         """
         history_chain: Runnable = RunnableLambda(
             self._enter_history, self._aenter_history

langchain_core/runnables/passthrough.py

@@ -132,6 +132,7 @@ class RunnablePassthrough(RunnableSerializable[Other, Other]):
 
             runnable.invoke('hello')
             # {'llm1': 'completion', 'llm2': 'completion', 'total_chars': 20}
+
     """
 
     input_type: Optional[type[Other]] = None
@@ -393,6 +394,7 @@ class RunnableAssign(RunnableSerializable[dict[str, Any], dict[str, Any]]):
             # Asynchronous example
             await runnable_assign.ainvoke({"input": 5})
             # returns {'input': 5, 'add_step': {'added': 15}}
+
     """
 
     mapper: RunnableParallel
@@ -697,6 +699,7 @@ class RunnablePick(RunnableSerializable[dict[str, Any], dict[str, Any]]):
             output_data = runnable.invoke(input_data)
 
             print(output_data)  # Output: {'name': 'John', 'age': 30}
+
     """
 
     keys: Union[str, list[str]]

langchain_core/runnables/retry.py

@@ -110,6 +110,7 @@ class RunnableRetry(RunnableBindingBase[Input, Output]):
             # Bad
             chain = template | model
             retryable_chain = chain.with_retry()
+
     """  # noqa: E501
 
     retry_exception_types: tuple[type[BaseException], ...] = (Exception,)

langchain_core/runnables/router.py

@@ -66,6 +66,7 @@ class RouterRunnable(RunnableSerializable[RouterInput, Output]):
 
             router = RouterRunnable(runnables={"add": add, "square": square})
             router.invoke({"key": "square", "input": 3})
+
     """
 
     runnables: Mapping[str, Runnable[Any, Output]]

langchain_core/runnables/schema.py

@@ -83,6 +83,7 @@ class BaseStreamEvent(TypedDict):
                     "tags": [],
                 },
             ]
+
     """
 
     event: str

langchain_core/stores.py

@@ -76,6 +76,7 @@ class BaseStore(ABC, Generic[K, V]):
                         for key in self.store.keys():
                             if key.startswith(prefix):
                                 yield key
+
     """
 
     @abstractmethod
@@ -302,6 +303,7 @@ class InMemoryStore(InMemoryBaseStore[Any]):
             # ['key2']
             list(store.yield_keys(prefix='k'))
             # ['key2']
+
     """
 
 
@@ -327,6 +329,7 @@ class InMemoryByteStore(InMemoryBaseStore[bytes]):
             # ['key2']
             list(store.yield_keys(prefix='k'))
             # ['key2']
+
     """