Struct Scanner 

pub struct Scanner { /* private fields */ }

Stateless sentinel matcher.

Scanner::new(until_tokens) builds one; feed tests a single reconstructed line; scan folds an iterator of lines into a single priority-respecting outcome.

The type holds no interior mutable state, so a single Scanner is safe to share across threads for the rare case where multiple streams feed the same loop controller.

Implementations

impl Scanner

pub fn new<S: AsRef<str>>(tokens: &[S]) -> Self

Build a scanner that always watches for BLOCKED plus every non-empty, unique until token in tokens.

Any token that trims to empty is dropped; passing BLOCKED explicitly is a no-op (it is always reserved).

pub fn feed(&self, line: &str) -> Option<Hit>

Test a single reconstructed line for an exact-token match.

Returns Some(Hit { kind: Blocked, .. }) when the trimmed line equals BLOCKED; returns Some(Hit { kind: Until, .. }) when it equals any registered until token; otherwise None. BLOCKED is checked first so a caller that registered it by mistake via tokens still gets the correct Kind.

pub fn scan<L, I>(&self, lines: I) -> Option<Hit>

where L: AsRef<str>, I: IntoIterator<Item = L>,

Fold an iterator of lines into a priority-respecting outcome.

Returns the first Hit observed unless a later line produces a Kind::Blocked hit, in which case BLOCKED wins and the function short-circuits — there is nothing a later line could say that would outrank BLOCKED. This matches the plan’s “BLOCKED always takes priority” contract and lets the loop controller drive a single pass without manual priority logic.

Trait Implementations

impl Clone for Scanner

fn clone(&self) -> Scanner

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Scanner

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

Formats the value using the given formatter.