Struct SidecarLifecycle 

pub struct SidecarLifecycle { /* private fields */ }

Lifecycle manager owned by BuildahSidecarBackend.

Holds at most one LiveSidecar and lazily produces it on the first call to Self::ensure. Cheap to clone (the inner Arc shares the underlying state), so the backend can pass &self references into async build pipelines without ceremony.

Implementations

impl SidecarLifecycle

pub fn new(config: Arc<SidecarConfig>) -> Self

Construct a manager bound to config. No filesystem or network I/O happens here.

pub async fn ensure(&self) -> Result<LiveSidecar>

Return the cached LiveSidecar, spawning + dialing on first call.

Errors

Returns whatever the underlying spawn / handshake / dial flow produced — typically BuildError::NotSupported when the binary is missing or the handshake times out.

pub async fn drop_connection(&self)

Drop the cached LiveSidecar so the next call to Self::ensure performs a fresh spawn + dial. Tears down the previous child via its Drop impl once the last outstanding clone is released.

Trait Implementations

impl Debug for SidecarLifecycle

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

Formats the value using the given formatter.