Struct ic_utils::call::AndThenAsyncCaller

pub struct AndThenAsyncCaller<Out: for<'de> ArgumentDecoder<'de> + Send, Out2: for<'de> ArgumentDecoder<'de> + Send, Inner: AsyncCall<Out> + Send, R: Future<Output = Result<Out2, AgentError>> + Send, AndThen: Send + Fn(Out) -> R> { /* private fields */ }

An AsyncCall that applies a transform function to the result of the call. Because of constraints on the type system in Rust, both the input and output to the function must be deserializable.

Implementations

impl<Out, Out2, Inner, R, AndThen> AndThenAsyncCaller<Out, Out2, Inner, R, AndThen>where
    Out: for<'de> ArgumentDecoder<'de> + Send,
    Out2: for<'de> ArgumentDecoder<'de> + Send,
    Inner: AsyncCall<Out> + Send,
    R: Future<Output = Result<Out2, AgentError>> + Send,
    AndThen: Send + Fn(Out) -> R,

pub fn new(inner: Inner, and_then: AndThen) -> Self

Equivalent to inner.and_then(and_then).

pub async fn call(self) -> Result<RequestId, AgentError>

See AsyncCall::call.

pub async fn call_and_wait(self) -> Result<Out2, AgentError>

See AsyncCall::call_and_wait.

pub fn and_then<Out3, R2, AndThen2>(
    self,
    and_then: AndThen2
) -> AndThenAsyncCaller<Out2, Out3, Self, R2, AndThen2>where
    Out3: for<'de> ArgumentDecoder<'de> + Send,
    R2: Future<Output = Result<Out3, AgentError>> + Send,
    AndThen2: Send + Fn(Out2) -> R2,

See AsyncCall::and_then.

pub fn map<Out3, Map>(self, map: Map) -> MappedAsyncCaller<Out2, Out3, Self, Map>where
    Out3: for<'de> ArgumentDecoder<'de> + Send,
    Map: Send + Fn(Out2) -> Out3,

See AsyncCall::map.

Trait Implementations

impl<Out, Out2, Inner, R, AndThen> AsyncCall<Out2> for AndThenAsyncCaller<Out, Out2, Inner, R, AndThen>where
    Out: for<'de> ArgumentDecoder<'de> + Send,
    Out2: for<'de> ArgumentDecoder<'de> + Send,
    Inner: AsyncCall<Out> + Send,
    R: Future<Output = Result<Out2, AgentError>> + Send,
    AndThen: Send + Fn(Out) -> R,

fn call<'async_trait>(
    self
) -> Pin<Box<dyn Future<Output = Result<RequestId, AgentError>> + Send + 'async_trait>>where
    Self: 'async_trait,

Execute the call, but returns the RequestId. Waiting on the request Id must be managed by the caller using the Agent directly.

fn call_and_wait<'async_trait>(
    self
) -> Pin<Box<dyn Future<Output = Result<Out2, AgentError>> + Send + 'async_trait>>where
    Self: 'async_trait,

Execute the call, and wait for an answer using a [Waiter] strategy. The return type is encoded in the trait.

fn and_then<Out2, R, AndThen>(
    self,
    and_then: AndThen
) -> AndThenAsyncCaller<Out, Out2, Self, R, AndThen>where
    Self: Sized + Send,
    Out2: for<'de> ArgumentDecoder<'de> + Send,
    R: Future<Output = Result<Out2, AgentError>> + Send,
    AndThen: Send + Fn(Out) -> R,

Apply a transformation function after the call has been successful. The transformation is applied with the result.

fn map<Out2, Map>(self, map: Map) -> MappedAsyncCaller<Out, Out2, Self, Map>where
    Self: Sized + Send,
    Out2: for<'de> ArgumentDecoder<'de> + Send,
    Map: Send + Fn(Out) -> Out2,

Apply a transformation function after the call has been successful. Equivalent to .and_then(|x| async { map(x) }).

impl<Out, Out2, Inner, R, AndThen> Debug for AndThenAsyncCaller<Out, Out2, Inner, R, AndThen>where
    Out: for<'de> ArgumentDecoder<'de> + Send,
    Out2: for<'de> ArgumentDecoder<'de> + Send,
    Inner: AsyncCall<Out> + Send + Debug,
    R: Future<Output = Result<Out2, AgentError>> + Send,
    AndThen: Send + Fn(Out) -> R + Debug,

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.