Struct MappedAsyncCaller 

pub struct MappedAsyncCaller<'a, Out: for<'de> ArgumentDecoder<'de> + Send, Out2: for<'de> ArgumentDecoder<'de> + Send, Inner: AsyncCall<Value = Out> + Send + 'a, Map: Send + Fn(Out) -> Out2> { /* private fields */ }

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

Implementations

impl<'a, Out, Out2, Inner, Map> MappedAsyncCaller<'a, Out, Out2, Inner, Map>

where Out: for<'de> ArgumentDecoder<'de> + Send, Out2: for<'de> ArgumentDecoder<'de> + Send, Inner: AsyncCall<Value = Out> + Send + 'a, Map: Send + Fn(Out) -> Out2,

pub fn new(inner: Inner, map: Map) -> Self

Equivalent to inner.map(map).

pub async fn call(self) -> Result<CallResponse<Out2>, 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<'a, Out2, Out3, Self, R2, AndThen2>

where Out3: for<'de> ArgumentDecoder<'de> + Send + 'a, R2: Future<Output = Result<Out3, AgentError>> + Send + 'a, AndThen2: Send + Fn(Out2) -> R2 + 'a,

See AsyncCall::and_then.

pub fn map<Out3, Map2>( self, map: Map2, ) -> MappedAsyncCaller<'a, Out2, Out3, Self, Map2>

where Out3: for<'de> ArgumentDecoder<'de> + Send, Map2: Send + Fn(Out2) -> Out3,

See AsyncCall::map.

Trait Implementations

impl<'a, Out, Out2, Inner, Map> AsyncCall for MappedAsyncCaller<'a, Out, Out2, Inner, Map>

where Out: for<'de> ArgumentDecoder<'de> + Send + 'a, Out2: for<'de> ArgumentDecoder<'de> + Send + 'a, Inner: AsyncCall<Value = Out> + Send + 'a, Map: Send + Fn(Out) -> Out2 + 'a,

type Value = Out2

The return type of the Candid function being called.

fn call<'async_trait>( self, ) -> Pin<Box<dyn Future<Output = Result<CallResponse<Out2>, AgentError>> + '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>> + 'async_trait>>

where Self: 'async_trait,

Execute the call, and wait for an answer using an exponential-backoff strategy. The return type is encoded in the trait.

fn and_then<'a, Out2, R, AndThen>( self, and_then: AndThen, ) -> AndThenAsyncCaller<'a, Self::Value, Out2, Self, R, AndThen>

where Self: Sized + Send + 'a, Out2: for<'de> ArgumentDecoder<'de> + Send + 'a, R: Future<Output = Result<Out2, AgentError>> + Send + 'a, AndThen: Send + Fn(Self::Value) -> R + 'a,

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

fn map<'a, Out, Map>( self, map: Map, ) -> MappedAsyncCaller<'a, Self::Value, Out, Self, Map>

where Self: Sized + Send + 'a, Out: for<'de> ArgumentDecoder<'de> + Send + 'a, Map: Send + Fn(Self::Value) -> Out + 'a,

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

impl<'a, Out, Out2, Inner, Map> Debug for MappedAsyncCaller<'a, Out, Out2, Inner, Map>

where Out: for<'de> ArgumentDecoder<'de> + Send, Out2: for<'de> ArgumentDecoder<'de> + Send, Inner: AsyncCall<Value = Out> + Send + Debug + 'a, Map: Send + Fn(Out) -> Out2 + Debug,

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

Formats the value using the given formatter.

impl<'a, Out, Out2, Inner, Map> IntoFuture for MappedAsyncCaller<'a, Out, Out2, Inner, Map>

where Out: for<'de> ArgumentDecoder<'de> + Send + 'a, Out2: for<'de> ArgumentDecoder<'de> + Send + 'a, Inner: AsyncCall<Value = Out> + Send + 'a, Map: Send + Fn(Out) -> Out2 + 'a,

type IntoFuture = Pin<Box<dyn Future<Output = Result<Out2, AgentError>> + 'a>>

Which kind of future are we turning this into?

type Output = Result<Out2, AgentError>

The output that the future will produce on completion.

fn into_future(self) -> Self::IntoFuture

Creates a future from a value.