Enum Line 

pub enum Line {
    Usable(Declared),
    Tool(ToolPin),
    Policy {
        what: PolicyLine,
        lineno: usize,
    },
    Broken {
        name: String,
        stage: Stage,
        lineno: usize,
        why: ParseError,
    },
}

Variants

Usable(Declared)

Tool(ToolPin)

A tool version pin — carries no check.

Policy

A policy statement — carries no check either. The line number rides along because a “names no check here” note must point somewhere.

Fields

what: PolicyLine

lineno: usize

Broken

Fields

name: String

The declared name, or <file>:<lineno> when the line has none — a gap has to be nameable to be reportable.

stage: Stage

Broken lines land on pre-commit unless the stage token parsed: seen on every commit beats seen on every push.

lineno: usize

why: ParseError

Implementations

impl Line

pub fn name(&self) -> &str

pub fn is_check(&self) -> bool

Does this line declare a CHECK? Tool and Policy lines do not, and every consumer that projects lines into checks — parse, the trust prompt, the fleet’s declared column — must filter on this rather than pattern-match variants it will forget to extend. A Broken line IS a check (one that runs to Unavailable and says why).

pub fn stage(&self) -> Stage

pub fn broken(&self) -> Option<String>

Some(reason) when this line declares a check that cannot run.

pub fn id(&self) -> String

<trigger>-<name>, matching Declared::id and External::id. A broken line has one too: hook.skip pre-commit should silence its nag exactly as it silences the checks that do run.

pub fn into_parts(self) -> (String, Stage, Result<Declared, String>)

Consume into the identity every line has, and either the declaration or the reason there is none.

Both consumers — External::from and the fleet’s projection — used to destructure this by hand, and both carried an arm for a combination the type forbids, because they computed the reason BEFORE matching. Written once, that arm has nowhere to appear.

Trait Implementations

impl Clone for Line

fn clone(&self) -> Line

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Line

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

Formats the value using the given formatter.

impl Eq for Line

impl From<Line> for External

fn from(l: Line) -> External

Converts to this type from the input type.

impl PartialEq for Line

fn eq(&self, other: &Line) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Line