Struct SidecarConfig 

pub struct SidecarConfig {
    pub name: String,
    pub command: Option<String>,
    pub socket: Option<String>,
    pub shm_size: u64,
    pub health_interval_ms: u64,
    pub timeout_ms: u64,
    pub retry: u8,
    pub pool_size: usize,
    pub max_in_flight: u64,
    pub auth_token: Option<String>,
    pub failover: Option<FailoverConfig>,
    pub reconnect_policy: ReconnectPolicy,
}

Configuration for a single sidecar.

Fields

name: String

Sidecar name (used for registry lookup and SHM naming).

command: Option<String>

Optional command to auto-spawn the sidecar process. If None, sidecar must self-register via UDS.

socket: Option<String>

Unix domain socket path. Defaults to /tmp/vil_sidecar_{name}.sock.

shm_size: u64

SHM region size in bytes. Default: 64 MB.

health_interval_ms: u64

Health check interval in milliseconds. Default: 5000.

timeout_ms: u64

Invocation timeout in milliseconds. Default: 30000.

retry: u8

Number of retries on invocation failure. Default: 0.

pool_size: usize

Number of concurrent connections to the sidecar. Default: 4.

max_in_flight: u64

Maximum number of in-flight requests (0 = unlimited). Default: 1000.

auth_token: Option<String>

Optional authentication token for handshake.

failover: Option<FailoverConfig>

Failover configuration.

reconnect_policy: ReconnectPolicy

Reconnect policy for dropped connections.

Implementations

impl SidecarConfig

pub fn new(name: impl Into<String>) -> SidecarConfig

Create a minimal config with just a name.

pub fn command(self, cmd: impl Into<String>) -> SidecarConfig

Set the spawn command.

pub fn timeout(self, ms: u64) -> SidecarConfig

Set the timeout in milliseconds.

pub fn shm_size(self, bytes: u64) -> SidecarConfig

Set the SHM size.

pub fn pool_size(self, n: usize) -> SidecarConfig

Set the connection pool size.

pub fn max_in_flight(self, n: u64) -> SidecarConfig

Set the maximum number of in-flight requests (0 = unlimited).

pub fn reconnect_max_retries(self, n: u32) -> SidecarConfig

Set the maximum reconnect retries.

pub fn reconnect_backoff_ms(self, base: u64, max: u64) -> SidecarConfig

Set the reconnect backoff parameters (base and max in milliseconds).

pub fn socket_path(&self) -> String

Resolve the socket path (use explicit or generate from name).

pub fn shm_path(&self) -> String

Resolve the SHM path.

Trait Implementations

impl Clone for SidecarConfig

fn clone(&self) -> SidecarConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SidecarConfig

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SidecarConfig

fn deserialize<__D>( __deserializer: __D, ) -> Result<SidecarConfig, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SidecarConfig

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.