Struct mpd_utils::PersistentClient

pub struct PersistentClient<'a> { /* private fields */ }

MPD client which automatically attempts to reconnect if the connection cannot be established or is lost.

Commands sent to a disconnected client are queued.

Implementations

impl<'a> PersistentClient<'a>

pub fn new(host: &'a str, retry_interval: Duration) -> Self

pub fn init(&self)

Attempts to connect to the MPD host and begins listening to server events.

pub fn host(&self) -> &str

Gets the client host address or path

pub fn is_connected(&self) -> bool

Gets whether there is a valid connection to the server

pub async fn wait_for_client(&self) -> Arc<Client>

Waits for a valid connection to the server to be established. If already connected, resolves immediately.

pub async fn with_client<F, Fut, T>(&self, f: F) -> Twhere F: FnOnce(Arc<Client>) -> Fut, Fut: Future<Output = T>,

Runs the provided callback as soon as the connected client is available.

pub async fn recv(&self) -> Option<ConnectionEvent>

Receives an event from the MPD server.

pub async fn status(&self) -> Result<Status, CommandError>

Runs the status command on the MPD server.

pub async fn current_song(&self) -> Result<Option<SongInQueue>, CommandError>

Runs the currentsong command on the MPD server.

Trait Implementations

impl<'a> Debug for PersistentClient<'a>

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

Formats the value using the given formatter.

impl<'a> Default for PersistentClient<'a>

Creates a new client on the default localhost TCP address with a connection retry of 5 seconds.

fn default() -> Self

Returns the “default value” for a type.