Struct Conductor 

pub struct Conductor { /* private fields */ }

The conductor’s state across polling cycles: its own CLI-side conversation and the last (revision, stalled ∪ finished ids) pair it actually acted on.

Implementations

impl Conductor

pub fn new() -> Self

A conductor that has never run.

pub fn worth_a_look( &self, queue: &Queue, stalled: &[Task], finished: &[Task], ) -> bool

Whether calling the conductor could possibly do anything different from last time: Queue::revision moved, or the set of stalled and finished task ids changed.

Deliberately not “stalled or finished is non-empty” - a task sitting stalled or finished with nobody changing anything about it must not be re-shown to the model every single poll forever; only a change in which tasks are stalled or finished, or a queue write changing something about a runnable one, is worth another look.

Cheap and config-free on purpose, so crate::daemon’s poll loop can skip Config::discover’s synchronous I/O entirely on a cycle where this says no - which Conductor::maybe_run would otherwise only discover after paying for that load. Both ask the identical question, from the same Conductor::last_seen, so they can never disagree about whether there is anything to look at.

pub async fn maybe_run( &mut self, cfg: &Config, repo: &Path, queue: &Queue, questions: &Questions, home: &Path, queued: &[Task], stalled: &[Task], finished: &[Task], max_attempts: usize, )

Call the conductor once, unless nothing has changed since the last time it was worth calling - see Conductor::worth_a_look, the exact same test. Never fatal - see this module’s doc.

Trait Implementations

impl Debug for Conductor

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

Formats the value using the given formatter.

impl Default for Conductor

fn default() -> Conductor

Returns the “default value” for a type.