mirror of
https://github.com/hwchase17/langchain.git
synced 2025-07-14 17:07:25 +00:00
Make it easier to subclass RunnableEach (#13346)
<!-- Thank you for contributing to LangChain! Replace this entire comment with: - **Description:** a description of the change, - **Issue:** the issue # it fixes (if applicable), - **Dependencies:** any dependencies required for this change, - **Tag maintainer:** for a quicker response, tag the relevant maintainer (see below), - **Twitter handle:** we announce bigger features on Twitter. If your PR gets announced, and you'd like a mention, we'll gladly shout you out! Please make sure your PR is passing linting and testing before submitting. Run `make format`, `make lint` and `make test` to check this locally. See contribution guidelines for more information on how to write/run tests, lint, etc: https://github.com/langchain-ai/langchain/blob/master/.github/CONTRIBUTING.md If you're adding a new integration, please include: 1. a test for the integration, preferably unit tests that do not rely on network access, 2. an example notebook showing its use. It lives in `docs/extras` directory. If no one reviews your PR within a few days, please @-mention one of @baskaryan, @eyurtsev, @hwchase17. -->
This commit is contained in:
parent
bed06a4f4a
commit
d5aeff706a
@ -2535,10 +2535,12 @@ class RunnableLambda(Runnable[Input, Output]):
|
|||||||
return await super().ainvoke(input, config)
|
return await super().ainvoke(input, config)
|
||||||
|
|
||||||
|
|
||||||
class RunnableEach(RunnableSerializable[List[Input], List[Output]]):
|
class RunnableEachBase(RunnableSerializable[List[Input], List[Output]]):
|
||||||
"""
|
"""
|
||||||
A runnable that delegates calls to another runnable
|
A runnable that delegates calls to another runnable
|
||||||
with each element of the input sequence.
|
with each element of the input sequence.
|
||||||
|
|
||||||
|
Use only if creating a new RunnableEach subclass with different __init__ args.
|
||||||
"""
|
"""
|
||||||
|
|
||||||
bound: Runnable[Input, Output]
|
bound: Runnable[Input, Output]
|
||||||
@ -2589,38 +2591,6 @@ class RunnableEach(RunnableSerializable[List[Input], List[Output]]):
|
|||||||
def get_lc_namespace(cls) -> List[str]:
|
def get_lc_namespace(cls) -> List[str]:
|
||||||
return cls.__module__.split(".")[:-1]
|
return cls.__module__.split(".")[:-1]
|
||||||
|
|
||||||
def bind(self, **kwargs: Any) -> RunnableEach[Input, Output]:
|
|
||||||
return RunnableEach(bound=self.bound.bind(**kwargs))
|
|
||||||
|
|
||||||
def with_config(
|
|
||||||
self, config: Optional[RunnableConfig] = None, **kwargs: Any
|
|
||||||
) -> RunnableEach[Input, Output]:
|
|
||||||
return RunnableEach(bound=self.bound.with_config(config, **kwargs))
|
|
||||||
|
|
||||||
def with_listeners(
|
|
||||||
self,
|
|
||||||
*,
|
|
||||||
on_start: Optional[Listener] = None,
|
|
||||||
on_end: Optional[Listener] = None,
|
|
||||||
on_error: Optional[Listener] = None,
|
|
||||||
) -> RunnableEach[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.
|
|
||||||
"""
|
|
||||||
return RunnableEach(
|
|
||||||
bound=self.bound.with_listeners(
|
|
||||||
on_start=on_start, on_end=on_end, on_error=on_error
|
|
||||||
)
|
|
||||||
)
|
|
||||||
|
|
||||||
def _invoke(
|
def _invoke(
|
||||||
self,
|
self,
|
||||||
inputs: List[Input],
|
inputs: List[Input],
|
||||||
@ -2654,9 +2624,50 @@ class RunnableEach(RunnableSerializable[List[Input], List[Output]]):
|
|||||||
return await self._acall_with_config(self._ainvoke, input, config, **kwargs)
|
return await self._acall_with_config(self._ainvoke, input, config, **kwargs)
|
||||||
|
|
||||||
|
|
||||||
|
class RunnableEach(RunnableEachBase[Input, Output]):
|
||||||
|
"""
|
||||||
|
A runnable that delegates calls to another runnable
|
||||||
|
with each element of the input sequence.
|
||||||
|
"""
|
||||||
|
|
||||||
|
def bind(self, **kwargs: Any) -> RunnableEach[Input, Output]:
|
||||||
|
return RunnableEach(bound=self.bound.bind(**kwargs))
|
||||||
|
|
||||||
|
def with_config(
|
||||||
|
self, config: Optional[RunnableConfig] = None, **kwargs: Any
|
||||||
|
) -> RunnableEach[Input, Output]:
|
||||||
|
return RunnableEach(bound=self.bound.with_config(config, **kwargs))
|
||||||
|
|
||||||
|
def with_listeners(
|
||||||
|
self,
|
||||||
|
*,
|
||||||
|
on_start: Optional[Listener] = None,
|
||||||
|
on_end: Optional[Listener] = None,
|
||||||
|
on_error: Optional[Listener] = None,
|
||||||
|
) -> RunnableEach[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.
|
||||||
|
"""
|
||||||
|
return RunnableEach(
|
||||||
|
bound=self.bound.with_listeners(
|
||||||
|
on_start=on_start, on_end=on_end, on_error=on_error
|
||||||
|
)
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
class RunnableBindingBase(RunnableSerializable[Input, Output]):
|
class RunnableBindingBase(RunnableSerializable[Input, Output]):
|
||||||
"""
|
"""
|
||||||
A runnable that delegates calls to another runnable with a set of kwargs.
|
A runnable that delegates calls to another runnable with a set of kwargs.
|
||||||
|
|
||||||
|
Use only if creating a new RunnableBinding subclass with different __init__ args.
|
||||||
"""
|
"""
|
||||||
|
|
||||||
bound: Runnable[Input, Output]
|
bound: Runnable[Input, Output]
|
||||||
@ -2879,6 +2890,10 @@ RunnableBindingBase.update_forward_refs(RunnableConfig=RunnableConfig)
|
|||||||
|
|
||||||
|
|
||||||
class RunnableBinding(RunnableBindingBase[Input, Output]):
|
class RunnableBinding(RunnableBindingBase[Input, Output]):
|
||||||
|
"""
|
||||||
|
A runnable that delegates calls to another runnable with a set of kwargs.
|
||||||
|
"""
|
||||||
|
|
||||||
def bind(self, **kwargs: Any) -> Runnable[Input, Output]:
|
def bind(self, **kwargs: Any) -> Runnable[Input, Output]:
|
||||||
return self.__class__(
|
return self.__class__(
|
||||||
bound=self.bound,
|
bound=self.bound,
|
||||||
|
@ -34,6 +34,7 @@ from langchain.schema.runnable.utils import (
|
|||||||
Input,
|
Input,
|
||||||
Output,
|
Output,
|
||||||
gather_with_concurrency,
|
gather_with_concurrency,
|
||||||
|
get_unique_config_specs,
|
||||||
)
|
)
|
||||||
|
|
||||||
|
|
||||||
@ -209,22 +210,25 @@ class RunnableConfigurableFields(DynamicRunnable[Input, Output]):
|
|||||||
|
|
||||||
@property
|
@property
|
||||||
def config_specs(self) -> Sequence[ConfigurableFieldSpec]:
|
def config_specs(self) -> Sequence[ConfigurableFieldSpec]:
|
||||||
return [
|
return get_unique_config_specs(
|
||||||
ConfigurableFieldSpec(
|
[
|
||||||
id=spec.id,
|
ConfigurableFieldSpec(
|
||||||
name=spec.name,
|
id=spec.id,
|
||||||
description=spec.description
|
name=spec.name,
|
||||||
or self.default.__fields__[field_name].field_info.description,
|
description=spec.description
|
||||||
annotation=spec.annotation
|
or self.default.__fields__[field_name].field_info.description,
|
||||||
or self.default.__fields__[field_name].annotation,
|
annotation=spec.annotation
|
||||||
default=getattr(self.default, field_name),
|
or self.default.__fields__[field_name].annotation,
|
||||||
)
|
default=getattr(self.default, field_name),
|
||||||
if isinstance(spec, ConfigurableField)
|
)
|
||||||
else make_options_spec(
|
if isinstance(spec, ConfigurableField)
|
||||||
spec, self.default.__fields__[field_name].field_info.description
|
else make_options_spec(
|
||||||
)
|
spec, self.default.__fields__[field_name].field_info.description
|
||||||
for field_name, spec in self.fields.items()
|
)
|
||||||
]
|
for field_name, spec in self.fields.items()
|
||||||
|
]
|
||||||
|
+ list(self.default.config_specs)
|
||||||
|
)
|
||||||
|
|
||||||
def configurable_fields(
|
def configurable_fields(
|
||||||
self, **kwargs: AnyConfigurableField
|
self, **kwargs: AnyConfigurableField
|
||||||
|
Loading…
Reference in New Issue
Block a user