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

langchain_core/runnables/utils.py

@@ -80,7 +80,7 @@ def accepts_run_manager(callable: Callable[..., Any]) -> bool:  # noqa: A002
         callable: The callable to check.
 
     Returns:
-        bool: True if the callable accepts a run_manager argument, False otherwise.
+        `True` if the callable accepts a run_manager argument, `False` otherwise.
     """
     try:
         return signature(callable).parameters.get("run_manager") is not None
@@ -95,7 +95,7 @@ def accepts_config(callable: Callable[..., Any]) -> bool:  # noqa: A002
         callable: The callable to check.
 
     Returns:
-        bool: True if the callable accepts a config argument, False otherwise.
+        `True` if the callable accepts a config argument, `False` otherwise.
     """
     try:
         return signature(callable).parameters.get("config") is not None
@@ -110,7 +110,7 @@ def accepts_context(callable: Callable[..., Any]) -> bool:  # noqa: A002
         callable: The callable to check.
 
     Returns:
-        bool: True if the callable accepts a context argument, False otherwise.
+        `True` if the callable accepts a context argument, `False` otherwise.
     """
     try:
         return signature(callable).parameters.get("context") is not None
@@ -120,11 +120,10 @@ def accepts_context(callable: Callable[..., Any]) -> bool:  # noqa: A002
 
 @lru_cache(maxsize=1)
 def asyncio_accepts_context() -> bool:
-    """Cache the result of checking if asyncio.create_task accepts a ``context`` arg.
+    """Cache the result of checking if asyncio.create_task accepts a `context` arg.
 
     Returns:
-        bool: True if ``asyncio.create_task`` accepts a context argument, False
-            otherwise.
+        True if `asyncio.create_task` accepts a context argument, `False` otherwise.
     """
     return accepts_context(asyncio.create_task)
 
@@ -137,7 +136,7 @@ def coro_with_context(
     Args:
         coro: The coroutine to await.
         context: The context to use.
-        create_task: Whether to create a task. Defaults to False.
+        create_task: Whether to create a task. Defaults to `False`.
 
     Returns:
         The coroutine with the context.
@@ -363,8 +362,7 @@ def get_function_first_arg_dict_keys(func: Callable) -> list[str] | None:
         func: The function to check.
 
     Returns:
-        Optional[list[str]]: The keys of the first argument if it is a dict,
-            None otherwise.
+        The keys of the first argument if it is a dict, None otherwise.
     """
     try:
         code = inspect.getsource(func)
@@ -383,7 +381,7 @@ def get_lambda_source(func: Callable) -> str | None:
         func: a Callable that can be a lambda function.
 
     Returns:
-        str: the source code of the lambda function.
+        the source code of the lambda function.
     """
     try:
         name = func.__name__ if func.__name__ != "<lambda>" else None
@@ -407,7 +405,7 @@ def get_function_nonlocals(func: Callable) -> list[Any]:
         func: The function to check.
 
     Returns:
-        list[Any]: The nonlocal variables accessed by the function.
+        The nonlocal variables accessed by the function.
     """
     try:
         code = inspect.getsource(func)
@@ -450,7 +448,7 @@ def indent_lines_after_first(text: str, prefix: str) -> str:
         prefix: Used to determine the number of spaces to indent.
 
     Returns:
-        str: The indented text.
+        The indented text.
     """
     n_spaces = len(prefix)
     spaces = " " * n_spaces
@@ -525,7 +523,7 @@ def add(addables: Iterable[Addable]) -> Addable | None:
         addables: The addable objects to add.
 
     Returns:
-        Optional[Addable]: The result of adding the addable objects.
+        The result of adding the addable objects.
     """
     final: Addable | None = None
     for chunk in addables:
@@ -540,7 +538,7 @@ async def aadd(addables: AsyncIterable[Addable]) -> Addable | None:
         addables: The addable objects to add.
 
     Returns:
-        Optional[Addable]: The result of adding the addable objects.
+        The result of adding the addable objects.
     """
     final: Addable | None = None
     async for chunk in addables:
@@ -554,13 +552,13 @@ class ConfigurableField(NamedTuple):
     id: str
     """The unique identifier of the field."""
     name: str | None = None
-    """The name of the field. Defaults to None."""
+    """The name of the field. """
     description: str | None = None
-    """The description of the field. Defaults to None."""
+    """The description of the field. """
     annotation: Any | None = None
-    """The annotation of the field. Defaults to None."""
+    """The annotation of the field. """
     is_shared: bool = False
-    """Whether the field is shared. Defaults to False."""
+    """Whether the field is shared. Defaults to `False`."""
 
     @override
     def __hash__(self) -> int:
@@ -577,11 +575,11 @@ class ConfigurableFieldSingleOption(NamedTuple):
     default: str
     """The default value for the field."""
     name: str | None = None
-    """The name of the field. Defaults to None."""
+    """The name of the field. """
     description: str | None = None
-    """The description of the field. Defaults to None."""
+    """The description of the field. """
     is_shared: bool = False
-    """Whether the field is shared. Defaults to False."""
+    """Whether the field is shared. Defaults to `False`."""
 
     @override
     def __hash__(self) -> int:
@@ -598,11 +596,11 @@ class ConfigurableFieldMultiOption(NamedTuple):
     default: Sequence[str]
     """The default values for the field."""
     name: str | None = None
-    """The name of the field. Defaults to None."""
+    """The name of the field. """
     description: str | None = None
-    """The description of the field. Defaults to None."""
+    """The description of the field. """
     is_shared: bool = False
-    """Whether the field is shared. Defaults to False."""
+    """Whether the field is shared. Defaults to `False`."""
 
     @override
     def __hash__(self) -> int:
@@ -622,15 +620,15 @@ class ConfigurableFieldSpec(NamedTuple):
     annotation: Any
     """The annotation of the field."""
     name: str | None = None
-    """The name of the field. Defaults to None."""
+    """The name of the field. """
     description: str | None = None
-    """The description of the field. Defaults to None."""
+    """The description of the field. """
     default: Any = None
-    """The default value for the field. Defaults to None."""
+    """The default value for the field. """
     is_shared: bool = False
-    """Whether the field is shared. Defaults to False."""
+    """Whether the field is shared. Defaults to `False`."""
     dependencies: list[str] | None = None
-    """The dependencies of the field. Defaults to None."""
+    """The dependencies of the field. """
 
 
 def get_unique_config_specs(
@@ -642,7 +640,7 @@ def get_unique_config_specs(
         specs: The config specs.
 
     Returns:
-        list[ConfigurableFieldSpec]: The unique config specs.
+        The unique config specs.
 
     Raises:
         ValueError: If the runnable sequence contains conflicting config specs.
@@ -729,8 +727,7 @@ def is_async_generator(
         func: The function to check.
 
     Returns:
-        TypeGuard[Callable[..., AsyncIterator]: True if the function is
-            an async generator, False otherwise.
+        `True` if the function is an async generator, `False` otherwise.
     """
     return inspect.isasyncgenfunction(func) or (
         hasattr(func, "__call__")  # noqa: B004
@@ -747,8 +744,7 @@ def is_async_callable(
         func: The function to check.
 
     Returns:
-        TypeGuard[Callable[..., Awaitable]: True if the function is async,
-            False otherwise.
+        `True` if the function is async, `False` otherwise.
     """
     return asyncio.iscoroutinefunction(func) or (
         hasattr(func, "__call__")  # noqa: B004

langchain_core/stores.py

@@ -47,36 +47,34 @@ class BaseStore(ABC, Generic[K, V]):
     which will usually be more efficient by saving on round trips to the store.
 
     Examples:
-
-        .. code-block:: python
-
-            from langchain.storage import BaseStore
-
-
-            class MyInMemoryStore(BaseStore[str, int]):
-                def __init__(self) -> None:
-                    self.store: dict[str, int] = {}
-
-                def mget(self, keys: Sequence[str]) -> list[int | None]:
-                    return [self.store.get(key) for key in keys]
-
-                def mset(self, key_value_pairs: Sequence[tuple[str, int]]) -> None:
-                    for key, value in key_value_pairs:
-                        self.store[key] = value
-
-                def mdelete(self, keys: Sequence[str]) -> None:
-                    for key in keys:
-                        if key in self.store:
-                            del self.store[key]
-
-                def yield_keys(self, prefix: str | None = None) -> Iterator[str]:
-                    if prefix is None:
-                        yield from self.store.keys()
-                    else:
-                        for key in self.store.keys():
-                            if key.startswith(prefix):
-                                yield key
-
+        ```python
+        from langchain.storage import BaseStore
+
+
+        class MyInMemoryStore(BaseStore[str, int]):
+            def __init__(self) -> None:
+                self.store: dict[str, int] = {}
+
+            def mget(self, keys: Sequence[str]) -> list[int | None]:
+                return [self.store.get(key) for key in keys]
+
+            def mset(self, key_value_pairs: Sequence[tuple[str, int]]) -> None:
+                for key, value in key_value_pairs:
+                    self.store[key] = value
+
+            def mdelete(self, keys: Sequence[str]) -> None:
+                for key in keys:
+                    if key in self.store:
+                        del self.store[key]
+
+            def yield_keys(self, prefix: str | None = None) -> Iterator[str]:
+                if prefix is None:
+                    yield from self.store.keys()
+                else:
+                    for key in self.store.keys():
+                        if key.startswith(prefix):
+                            yield key
+        ```
     """
 
     @abstractmethod
@@ -84,7 +82,7 @@ class BaseStore(ABC, Generic[K, V]):
         """Get the values associated with the given keys.
 
         Args:
-            keys (Sequence[K]): A sequence of keys.
+            keys: A sequence of keys.
 
         Returns:
             A sequence of optional values associated with the keys.
@@ -95,7 +93,7 @@ class BaseStore(ABC, Generic[K, V]):
         """Async get the values associated with the given keys.
 
         Args:
-            keys (Sequence[K]): A sequence of keys.
+            keys: A sequence of keys.
 
         Returns:
             A sequence of optional values associated with the keys.
@@ -108,14 +106,14 @@ class BaseStore(ABC, Generic[K, V]):
         """Set the values for the given keys.
 
         Args:
-            key_value_pairs (Sequence[tuple[K, V]]): A sequence of key-value pairs.
+            key_value_pairs: A sequence of key-value pairs.
         """
 
     async def amset(self, key_value_pairs: Sequence[tuple[K, V]]) -> None:
         """Async set the values for the given keys.
 
         Args:
-            key_value_pairs (Sequence[tuple[K, V]]): A sequence of key-value pairs.
+            key_value_pairs: A sequence of key-value pairs.
         """
         return await run_in_executor(None, self.mset, key_value_pairs)
 
@@ -124,14 +122,14 @@ class BaseStore(ABC, Generic[K, V]):
         """Delete the given keys and their associated values.
 
         Args:
-            keys (Sequence[K]): A sequence of keys to delete.
+            keys: A sequence of keys to delete.
         """
 
     async def amdelete(self, keys: Sequence[K]) -> None:
         """Async delete the given keys and their associated values.
 
         Args:
-            keys (Sequence[K]): A sequence of keys to delete.
+            keys: A sequence of keys to delete.
         """
         return await run_in_executor(None, self.mdelete, keys)
 
@@ -140,10 +138,10 @@ class BaseStore(ABC, Generic[K, V]):
         """Get an iterator over keys that match the given prefix.
 
         Args:
-            prefix (str): The prefix to match.
+            prefix: The prefix to match.
 
         Yields:
-            Iterator[K | str]: An iterator over keys that match the given prefix.
+            An iterator over keys that match the given prefix.
             This method is allowed to return an iterator over either K or str
             depending on what makes more sense for the given store.
         """
@@ -154,10 +152,10 @@ class BaseStore(ABC, Generic[K, V]):
         """Async get an iterator over keys that match the given prefix.
 
         Args:
-            prefix (str): The prefix to match.
+            prefix: The prefix to match.
 
         Yields:
-            Iterator[K | str]: An iterator over keys that match the given prefix.
+            The keys that match the given prefix.
             This method is allowed to return an iterator over either K or str
             depending on what makes more sense for the given store.
         """
@@ -180,28 +178,12 @@ class InMemoryBaseStore(BaseStore[str, V], Generic[V]):
         """Initialize an empty store."""
         self.store: dict[str, V] = {}
 
+    @override
     def mget(self, keys: Sequence[str]) -> list[V | None]:
-        """Get the values associated with the given keys.
-
-        Args:
-            keys (Sequence[str]): A sequence of keys.
-
-        Returns:
-            A sequence of optional values associated with the keys.
-            If a key is not found, the corresponding value will be None.
-        """
         return [self.store.get(key) for key in keys]
 
+    @override
     async def amget(self, keys: Sequence[str]) -> list[V | None]:
-        """Async get the values associated with the given keys.
-
-        Args:
-            keys (Sequence[str]): A sequence of keys.
-
-        Returns:
-            A sequence of optional values associated with the keys.
-            If a key is not found, the corresponding value will be None.
-        """
         return self.mget(keys)
 
     @override
@@ -213,32 +195,24 @@ class InMemoryBaseStore(BaseStore[str, V], Generic[V]):
     async def amset(self, key_value_pairs: Sequence[tuple[str, V]]) -> None:
         return self.mset(key_value_pairs)
 
+    @override
     def mdelete(self, keys: Sequence[str]) -> None:
-        """Delete the given keys and their associated values.
-
-        Args:
-            keys (Sequence[str]): A sequence of keys to delete.
-        """
         for key in keys:
             if key in self.store:
                 del self.store[key]
 
+    @override
     async def amdelete(self, keys: Sequence[str]) -> None:
-        """Async delete the given keys and their associated values.
-
-        Args:
-            keys (Sequence[str]): A sequence of keys to delete.
-        """
         self.mdelete(keys)
 
     def yield_keys(self, prefix: str | None = None) -> Iterator[str]:
         """Get an iterator over keys that match the given prefix.
 
         Args:
-            prefix (str, optional): The prefix to match. Defaults to None.
+            prefix: The prefix to match.
 
         Yields:
-            Iterator[str]: An iterator over keys that match the given prefix.
+            The keys that match the given prefix.
         """
         if prefix is None:
             yield from self.store.keys()
@@ -251,10 +225,10 @@ class InMemoryBaseStore(BaseStore[str, V], Generic[V]):
         """Async get an async iterator over keys that match the given prefix.
 
         Args:
-            prefix (str, optional): The prefix to match. Defaults to None.
+            prefix: The prefix to match.
 
         Yields:
-            AsyncIterator[str]: An async iterator over keys that match the given prefix.
+            The keys that match the given prefix.
         """
         if prefix is None:
             for key in self.store:
@@ -273,21 +247,19 @@ class InMemoryStore(InMemoryBaseStore[Any]):
             the key-value pairs.
 
     Examples:
-
-        .. code-block:: python
-
-            from langchain.storage import InMemoryStore
-
-            store = InMemoryStore()
-            store.mset([("key1", "value1"), ("key2", "value2")])
-            store.mget(["key1", "key2"])
-            # ['value1', 'value2']
-            store.mdelete(["key1"])
-            list(store.yield_keys())
-            # ['key2']
-            list(store.yield_keys(prefix="k"))
-            # ['key2']
-
+        ```python
+        from langchain.storage import InMemoryStore
+
+        store = InMemoryStore()
+        store.mset([("key1", "value1"), ("key2", "value2")])
+        store.mget(["key1", "key2"])
+        # ['value1', 'value2']
+        store.mdelete(["key1"])
+        list(store.yield_keys())
+        # ['key2']
+        list(store.yield_keys(prefix="k"))
+        # ['key2']
+        ```
     """
 
 
@@ -299,21 +271,19 @@ class InMemoryByteStore(InMemoryBaseStore[bytes]):
             the key-value pairs.
 
     Examples:
-
-        .. code-block:: python
-
-            from langchain.storage import InMemoryByteStore
-
-            store = InMemoryByteStore()
-            store.mset([("key1", b"value1"), ("key2", b"value2")])
-            store.mget(["key1", "key2"])
-            # [b'value1', b'value2']
-            store.mdelete(["key1"])
-            list(store.yield_keys())
-            # ['key2']
-            list(store.yield_keys(prefix="k"))
-            # ['key2']
-
+        ```python
+        from langchain.storage import InMemoryByteStore
+
+        store = InMemoryByteStore()
+        store.mset([("key1", b"value1"), ("key2", b"value2")])
+        store.mget(["key1", "key2"])
+        # [b'value1', b'value2']
+        store.mdelete(["key1"])
+        list(store.yield_keys())
+        # ['key2']
+        list(store.yield_keys(prefix="k"))
+        # ['key2']
+        ```
     """
 
 

langchain_core/sys_info.py

@@ -1,11 +1,8 @@
-"""**sys_info** implementation.
-
-sys_info prints information about the system and langchain packages for
-debugging purposes.
-"""
+"""Print information about the system and langchain packages for debugging purposes."""
 
 import pkgutil
 import platform
+import re
 import sys
 from collections.abc import Sequence
 from importlib import metadata, util
@@ -26,9 +23,12 @@ def _get_sub_deps(packages: Sequence[str]) -> list[str]:
             continue
 
         for req in required:
-            cleaned_req = req.split(" ")[0]
-            if cleaned_req.replace("-", "_") not in underscored_packages:
-                sub_deps.add(cleaned_req)
+            # Extract package name (e.g., "httpx<1,>=0.23.0" -> "httpx")
+            match = re.match(r"^([a-zA-Z0-9_.-]+)", req)
+            if match:
+                pkg_name = match.group(1)
+                if pkg_name.replace("-", "_") not in underscored_packages:
+                    sub_deps.add(pkg_name)
 
     return sorted(sub_deps, key=lambda x: x.lower())
 
@@ -75,17 +75,17 @@ def print_sys_info(*, additional_pkgs: Sequence[str] = ()) -> None:
         "OS Version": platform.version(),
         "Python Version": sys.version,
     }
-    print()  # noqa: T201
-    print("System Information")  # noqa: T201
-    print("------------------")  # noqa: T201
-    print("> OS: ", system_info["OS"])  # noqa: T201
-    print("> OS Version: ", system_info["OS Version"])  # noqa: T201
-    print("> Python Version: ", system_info["Python Version"])  # noqa: T201
+    print()
+    print("System Information")
+    print("------------------")
+    print("> OS: ", system_info["OS"])
+    print("> OS Version: ", system_info["OS Version"])
+    print("> Python Version: ", system_info["Python Version"])
 
     # Print out only langchain packages
-    print()  # noqa: T201
-    print("Package Information")  # noqa: T201
-    print("-------------------")  # noqa: T201
+    print()
+    print("Package Information")
+    print("-------------------")
 
     not_installed = []
 
@@ -106,30 +106,28 @@ def print_sys_info(*, additional_pkgs: Sequence[str] = ()) -> None:
 
         # Print package with version
         if package_version is not None:
-            print(f"> {pkg}: {package_version}")  # noqa: T201
-        else:
-            print(f"> {pkg}: Installed. No version info available.")  # noqa: T201
+            print(f"> {pkg}: {package_version}")
 
     if not_installed:
-        print()  # noqa: T201
-        print("Optional packages not installed")  # noqa: T201
-        print("-------------------------------")  # noqa: T201
+        print()
+        print("Optional packages not installed")
+        print("-------------------------------")
         for pkg in not_installed:
-            print(f"> {pkg}")  # noqa: T201
+            print(f"> {pkg}")
 
     sub_dependencies = _get_sub_deps(all_packages)
 
     if sub_dependencies:
-        print()  # noqa: T201
-        print("Other Dependencies")  # noqa: T201
-        print("------------------")  # noqa: T201
+        print()
+        print("Other Dependencies")
+        print("------------------")
 
         for dep in sub_dependencies:
             try:
                 dep_version = metadata.version(dep)
-                print(f"> {dep}: {dep_version}")  # noqa: T201
+                print(f"> {dep}: {dep_version}")
             except Exception:
-                print(f"> {dep}: Installed. No version info available.")  # noqa: T201
+                print(f"> {dep}: Installed. No version info available.")
 
 
 if __name__ == "__main__":

langchain_core/tools/__init__.py

@@ -2,20 +2,7 @@
 
 Each tool has a **description**. Agent uses the description to choose the right
 tool for the job.
-
-**Class hierarchy:**
-
-.. code-block::
-
-    RunnableSerializable --> BaseTool --> <name>Tool  # Examples: AIPluginTool, BaseGraphQLTool
-                                          <name>      # Examples: BraveSearch, HumanInputRun
-
-**Main helpers:**
-
-.. code-block::
-
-    CallbackManagerForToolRun, AsyncCallbackManagerForToolRun
-"""  # noqa: E501
+"""
 
 from __future__ import annotations