Struct DaemonClient 

pub struct DaemonClient { /* private fields */ }

A one-shot client over the daemon’s Unix-domain control socket. Each call opens a fresh connection, sends one DaemonEnvelope, and reads one DaemonReply.

Implementations

impl DaemonClient

pub fn new(socket_path: impl Into<PathBuf>) -> Self

Creates a client targeting the socket at socket_path.

pub fn socket_path(&self) -> &Path

The socket path this client targets.

pub async fn request(&self, envelope: DaemonEnvelope) -> Result<DaemonReply>

Sends one envelope and returns the daemon’s reply.

pub async fn subscribe( &self, envelope: DaemonEnvelope, ) -> Result<DaemonSubscription>

Opens a streaming subscription: sends envelope once and returns a handle over which the daemon pushes many replies on the same connection (an initial snapshot then a fresh one on each change) until the daemon or the client closes it. Per the control-socket protocol the client must only read after this — sending any further line is interpreted as an explicit cancel — so DaemonSubscription exposes reads only.

pub async fn ping(&self) -> Result<()>

Probes whether a live daemon is answering on the socket.

pub async fn version(&self) -> Result<Option<String>>

Returns the resident daemon’s advertised binary version, or None when it advertises none (a pre-#1113 daemon whose ping carries no version).

Lets a client warn that it is driving a stale daemon after a binary upgrade without a separate status round-trip.

pub async fn status(&self) -> Result<StatusReport>

Requests aggregated per-service status.

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

Asks the daemon to shut down gracefully.

Trait Implementations

impl Clone for DaemonClient

fn clone(&self) -> DaemonClient

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DaemonClient

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

Formats the value using the given formatter.