Struct IdleTracker 

pub struct IdleTracker { /* private fields */ }

Tracks daemon activity so an unused daemon shuts itself down, and so background work only runs while nobody is asking for anything.

Two different questions are asked of the same clock:

• quiet — no connection is open and the last request is older than some period. Background extraction waits for this.
• idle — quiet for the configured shutdown timeout, and no background batch in flight. The accept loop exits on this.

A background batch therefore cannot be cut in half by the idle timeout, and a hot request always makes the daemon un-quiet immediately. None disables idle shutdown entirely (--foreground, or idle_timeout_secs = 0) without disabling quiet, which is what keeps a supervised daemon extracting.

Implementations

impl IdleTracker

pub fn new(timeout: Option<Duration>) -> Self

pub fn new_at(timeout: Option<Duration>, start: Instant) -> Self

Construct with an explicit start instant (used by tests).

pub fn begin(&self)

Register a connection as open.

pub fn end(&self)

Register a connection as closed.

pub fn begin_background(&self)

Register a background batch as running. Holds off idle shutdown until it finishes, without pretending the daemon is being used.

pub fn end_background(&self)

Register a background batch as finished.

pub fn touch_at(&self, now: Instant)

Record activity at now.

pub fn has_connections(&self) -> bool

True while at least one client connection is open.

pub fn is_quiet_at(&self, now: Instant, quiet: Duration) -> bool

True when no connection is open and nothing has been asked of the daemon for quiet.

pub fn is_idle_at(&self, now: Instant) -> bool

True when the daemon has been unused for longer than the timeout and no background batch is in flight.

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

The configured idle shutdown timeout, if any.

pub fn poll_interval(&self) -> Duration

How often the accept loop should re-check idleness.

Trait Implementations

impl Debug for IdleTracker

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

Formats the value using the given formatter.