Struct ic_utils::interfaces::management_canister::builders::InstallCodeBuilder
source · [−]pub struct InstallCodeBuilder<'agent, 'canister: 'agent, T> { /* private fields */ }
Expand description
A builder for an install_code
call.
Implementations
sourceimpl<'agent, 'canister: 'agent, T> InstallCodeBuilder<'agent, 'canister, T>
impl<'agent, 'canister: 'agent, T> InstallCodeBuilder<'agent, 'canister, T>
sourcepub fn builder(
canister: &'canister Canister<'agent, T>,
canister_id: &Principal,
wasm: &'canister [u8]
) -> Self
pub fn builder(
canister: &'canister Canister<'agent, T>,
canister_id: &Principal,
wasm: &'canister [u8]
) -> Self
Create an InstallCode builder, which is also an AsyncCall implementation.
sourcepub fn with_arg<Argument: CandidType + Sync + Send>(
self,
arg: Argument
) -> InstallCodeBuilder<'agent, 'canister, T>
pub fn with_arg<Argument: CandidType + Sync + Send>(
self,
arg: Argument
) -> InstallCodeBuilder<'agent, 'canister, T>
Add an argument to the installation, which will be passed to the init method of the canister.
sourcepub fn with_raw_arg(
self,
arg: Vec<u8>
) -> InstallCodeBuilder<'agent, 'canister, T>
pub fn with_raw_arg(
self,
arg: Vec<u8>
) -> InstallCodeBuilder<'agent, 'canister, T>
Override the argument passed in to the canister with raw bytes.
sourcepub fn with_mode(self, mode: InstallMode) -> Self
pub fn with_mode(self, mode: InstallMode) -> Self
Pass in the InstallMode.
sourcepub fn build(self) -> Result<impl 'agent + AsyncCall<()>, AgentError>
pub fn build(self) -> Result<impl 'agent + AsyncCall<()>, AgentError>
Create an AsyncCall implementation that, when called, will install the canister.
sourcepub async fn call(self) -> Result<RequestId, AgentError>
pub async fn call(self) -> Result<RequestId, AgentError>
Make a call. This is equivalent to the AsyncCall::call.
sourcepub async fn call_and_wait<W>(self, waiter: W) -> Result<(), AgentError> where
W: Waiter,
pub async fn call_and_wait<W>(self, waiter: W) -> Result<(), AgentError> where
W: Waiter,
Make a call. This is equivalent to the AsyncCall::call_and_wait.
Trait Implementations
sourceimpl<'agent, 'canister: 'agent, T: Sync> AsyncCall<()> for InstallCodeBuilder<'agent, 'canister, T>
impl<'agent, 'canister: 'agent, T: Sync> AsyncCall<()> for InstallCodeBuilder<'agent, 'canister, T>
sourcefn call<'async_trait>(
self
) -> Pin<Box<dyn Future<Output = Result<RequestId, AgentError>> + Send + 'async_trait>> where
Self: 'async_trait,
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. Read more
sourcefn call_and_wait<'async_trait, W>(
self,
waiter: W
) -> Pin<Box<dyn Future<Output = Result<(), AgentError>> + Send + 'async_trait>> where
W: Waiter,
W: 'async_trait,
Self: 'async_trait,
fn call_and_wait<'async_trait, W>(
self,
waiter: W
) -> Pin<Box<dyn Future<Output = Result<(), AgentError>> + Send + 'async_trait>> where
W: Waiter,
W: 'async_trait,
Self: 'async_trait,
sourcefn 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,
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. Read more
sourcefn 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,
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) })
.
Auto Trait Implementations
impl<'agent, 'canister, T> !RefUnwindSafe for InstallCodeBuilder<'agent, 'canister, T>
impl<'agent, 'canister, T> Send for InstallCodeBuilder<'agent, 'canister, T> where
T: Sync,
impl<'agent, 'canister, T> Sync for InstallCodeBuilder<'agent, 'canister, T> where
T: Sync,
impl<'agent, 'canister, T> Unpin for InstallCodeBuilder<'agent, 'canister, T> where
'agent: 'canister,
impl<'agent, 'canister, T> !UnwindSafe for InstallCodeBuilder<'agent, 'canister, T>
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
sourceimpl<T> Instrument for T
impl<T> Instrument for T
sourcefn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
sourcefn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
impl<V, T> VZip<V> for T where
V: MultiLane<T>,
impl<V, T> VZip<V> for T where
V: MultiLane<T>,
fn vzip(self) -> V
sourceimpl<T> WithSubscriber for T
impl<T> WithSubscriber for T
sourcefn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> where
S: Into<Dispatch>,
fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> where
S: Into<Dispatch>,
Attaches the provided Subscriber
to this type, returning a
WithDispatch
wrapper. Read more
sourcefn with_current_subscriber(self) -> WithDispatch<Self>
fn with_current_subscriber(self) -> WithDispatch<Self>
Attaches the current default Subscriber
to this type, returning a
WithDispatch
wrapper. Read more