Struct Client 

pub struct Client { /* private fields */ }

Synchronous client for communicating with the whoami daemon.

Example

use getmyid::Client;

let client = Client::new();
let identity = client.get_identity()?;
println!("Identity: {}", identity.identity);

Implementations

impl Client

pub fn new() -> Self

Create a new client with default settings.

Uses the default socket path /var/run/whoami.sock.

pub fn builder() -> ClientBuilder

Create a client builder for custom configuration.

pub fn get_identity(&self) -> Result<Identity>

Get the identity of the current process.

Connects to the whoami daemon, which uses SO_PEERCRED to identify this process, then matches against configured rules to return the application-level identity.

Errors

Returns an error if:

• The socket does not exist or cannot be connected to
• The daemon returns an error (e.g., no matching rule)
• The response cannot be parsed

pub fn get_identity_with_runner( &self, runner: Option<RunnerRequest>, ) -> Result<Identity>

Get the identity with client-provided runner context.

The runner request allows you to send context (like instance_id, timestamp) that will be merged with server-injected identity in the response’s runner object.

Example

use getmyid::{Client, RunnerRequest};

let client = Client::new();
let runner_req = RunnerRequest::new()
    .with_instance_id(42)
    .with_current_timestamp();

let identity = client.get_identity_with_runner(Some(runner_req))?;
println!("Instance: {:?}", identity.runner.instance_id);

pub fn socket_path(&self) -> &Path

Get the configured socket path.

pub fn timeout(&self) -> Option<Duration>

Get the configured timeout.

Trait Implementations

impl Clone for Client

fn clone(&self) -> Client

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Client

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

Formats the value using the given formatter.

impl Default for Client

fn default() -> Self

Returns the “default value” for a type.