Struct Client 

pub struct Client { /* private fields */ }

Implementations

impl Client

pub fn connect_any_version(paths: &Paths) -> Result<Option<Client>>

Connects to whatever daemon answers, of any version; None when nothing does.

pub fn connect_or_start(paths: &Paths) -> Result<Client>

Connects, starting this binary as the daemon when none answers, and replacing a daemon of an older version or another protocol; a newer daemon is an error, so an old window never kills its upgrade.

pub fn connect_or_start_with( paths: &Paths, exe: &Path, version: &str, ) -> Result<Client>

pub fn is_closed(&self) -> bool

True once the daemon hung up; a holder should connect again.

pub fn request(&self, account: &str, command: Command) -> Result<Event>

Sends and waits for the reply, up to 120 s unless reply_timeout says the command may take longer.

pub fn send(&self, account: &str, command: Command) -> bool

Sends without waiting; a refusal arrives as Event::CommandFailed on the subscription.

pub fn subscribe(&self) -> Result<Receiver<Event>>

Every broadcast event from now on, plus refusals of send. Call once.

pub fn subscribe_waking( &self, wake: impl Fn() + Send + 'static, ) -> Result<Receiver<Event>>

As subscribe, calling wake after each event and once the daemon hung up, so a window can repaint.

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

pub fn shutdown(&self) -> Result<()>

pub fn stop_and_wait(&self, paths: &Paths) -> Result<u32>

Stops the daemon and waits for its socket to go; returns the pid it had.

Trait Implementations

impl Drop for Client

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.