Struct CommandContext

pub struct CommandContext<Effect, Event> { /* private fields */ }

Context enabling tasks to communicate with the parent Command, specifically submit effects, events and spawn further tasks

Implementations

impl<Effect, Event> CommandContext<Effect, Event>

pub fn notify_shell<Op>(&self, operation: Op)

where Op: Operation, Effect: From<Request<Op>>,

Create a one-off notification to the shell. This method returns immediately.

pub fn request_from_shell<Op>(&self, operation: Op) -> ShellRequest<Op::Output>

where Op: Operation, Effect: From<Request<Op>> + Send + 'static,

Create a one-off request for an operation. Returns a future which eventually resolves with the output of the operation provided by the shell.

pub fn stream_from_shell<Op>(&self, operation: Op) -> ShellStream<Op::Output>

where Op: Operation, Effect: From<Request<Op>> + Send + 'static,

Create a stream request for an operation. Returns a stream producing the with the output of the operation every time it is provided by the shell.

pub fn send_event(&self, event: Event)

Send an event which should be handed to the update function. This is used to communicate the result (or a sequence of results) of a command back to the app so that state can be updated accordingly

pub fn spawn<F, Fut>(&self, make_future: F) -> JoinHandle

where F: FnOnce(CommandContext<Effect, Event>) -> Fut, Fut: Future<Output = ()> + Send + 'static,

Spawn a new task within the same command. The task will execute concurrently with other tasks within the command until it either concludes, is aborted, or until the parent command is aborted.

Returns a JoinHandle which can be used as a future to await the completion of the task. It can also be used to abort the task.

Trait Implementations

impl<Effect, Event> Clone for CommandContext<Effect, Event>

fn clone(&self) -> Self

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.