Struct Directive 

pub struct Directive<A = String> {
    pub action: A,
    pub kind: Option<String>,
    pub name: Pattern,
    pub path: Option<Pattern>,
    pub note: Option<String>,
}

One parsed directive: ACTION:[<KIND>]NAME[@PATH][=NOTE].

Generic over the action vocabulary A, defaulting to String. Matching (Directive::matches) is independent of A.

Fields

action: A

The resolved action.

kind: Option<String>

Optional KIND filter (<*>/omitted ⇒ None ⇒ any). Stored un-escaped; matched exactly.

name: Pattern

The (required) NAME glob.

path: Option<Pattern>

The optional @PATH glob.

note: Option<String>

The optional =NOTE — free text, taken raw.

Implementations

impl<A> Directive<A>

pub fn matches(&self, t: &impl Target) -> bool

Does this directive apply to t?

• KIND (if set) must equal t.qualifier() exactly;
• NAME must match (the target decides over which of its names, via Target::matches_name);
• PATH (if set) must match one of the target’s scopes (Target::matches_scope).

Action-independent: a caller that wants to ignore some actions (e.g. a set config directive) filters those out before matching.

Trait Implementations

impl<A: Clone> Clone for Directive<A>

fn clone(&self) -> Directive<A>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<A: Debug> Debug for Directive<A>

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

Formats the value using the given formatter.

impl<A: Display> Display for Directive<A>

Best-effort round-trip. Reproduces the canonical form; fields are emitted as stored, so a KIND containing >/= won’t re-escape (KINDs in practice are plain identifiers).

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

Formats the value using the given formatter.

impl<A: Eq> Eq for Directive<A>

impl<A: PartialEq> PartialEq for Directive<A>

fn eq(&self, other: &Directive<A>) -> bool

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<A> StructuralPartialEq for Directive<A>