84 lines
2.3 KiB
Rust
84 lines
2.3 KiB
Rust
//! Run asynchronous actions.
|
|
mod action;
|
|
|
|
pub use action::Action;
|
|
|
|
use crate::widget;
|
|
|
|
use iced_futures::MaybeSend;
|
|
|
|
use std::fmt;
|
|
use std::future::Future;
|
|
|
|
/// A set of asynchronous actions to be performed by some runtime.
|
|
pub struct Command<T>(iced_futures::Command<Action<T>>);
|
|
|
|
impl<T> Command<T> {
|
|
/// Creates an empty [`Command`].
|
|
///
|
|
/// In other words, a [`Command`] that does nothing.
|
|
pub const fn none() -> Self {
|
|
Self(iced_futures::Command::none())
|
|
}
|
|
|
|
/// Creates a [`Command`] that performs a single [`Action`].
|
|
pub const fn single(action: Action<T>) -> Self {
|
|
Self(iced_futures::Command::single(action))
|
|
}
|
|
|
|
/// Creates a [`Command`] that performs a [`widget::Operation`].
|
|
pub fn widget(operation: impl widget::Operation<T> + 'static) -> Self {
|
|
Self(iced_futures::Command::single(Action::Widget(
|
|
widget::Action::new(operation),
|
|
)))
|
|
}
|
|
|
|
/// Creates a [`Command`] that performs the action of the given future.
|
|
pub fn perform<A>(
|
|
future: impl Future<Output = T> + 'static + MaybeSend,
|
|
f: impl Fn(T) -> A + 'static + MaybeSend,
|
|
) -> Command<A> {
|
|
use iced_futures::futures::FutureExt;
|
|
|
|
Command::single(Action::Future(Box::pin(future.map(f))))
|
|
}
|
|
|
|
/// Creates a [`Command`] that performs the actions of all the given
|
|
/// commands.
|
|
///
|
|
/// Once this command is run, all the commands will be executed at once.
|
|
pub fn batch(commands: impl IntoIterator<Item = Command<T>>) -> Self {
|
|
Self(iced_futures::Command::batch(
|
|
commands.into_iter().map(|Command(command)| command),
|
|
))
|
|
}
|
|
|
|
/// Applies a transformation to the result of a [`Command`].
|
|
pub fn map<A>(
|
|
self,
|
|
f: impl Fn(T) -> A + 'static + MaybeSend + Sync + Clone,
|
|
) -> Command<A>
|
|
where
|
|
T: 'static,
|
|
A: 'static,
|
|
{
|
|
let Command(command) = self;
|
|
|
|
Command(command.map(move |action| action.map(f.clone())))
|
|
}
|
|
|
|
/// Returns all of the actions of the [`Command`].
|
|
pub fn actions(self) -> Vec<Action<T>> {
|
|
let Command(command) = self;
|
|
|
|
command.actions()
|
|
}
|
|
}
|
|
|
|
impl<T> fmt::Debug for Command<T> {
|
|
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
|
|
let Command(command) = self;
|
|
|
|
command.fmt(f)
|
|
}
|
|
}
|