Struct Directive 

pub struct Directive {
    pub cli_flag: &'static str,
    pub help: Option<&'static str>,
    pub values: Option<ClosedValues>,
    pub boolean: bool,
    pub repeatable: bool,
    pub yaml_directive: Option<&'static str>,
}

A richer flag descriptor that bundles the CLI form, optional YAML mirror, value semantics, and repeatability into one declaration. Adapters can expand a &[Directive] into per-flag completion + parse rules without the caller writing a parallel translation layer.

Maps roughly to nbrs’s vocab::Directive shape — a directive is “the canonical statement of what a flag IS, in every surface it appears.” Use apply_directives to register a slice of directives onto a Node in one call.

Fields

cli_flag: &'static str

CLI form, e.g. "--metric". Required.

help: Option<&'static str>

One-line help text. Optional.

values: Option<ClosedValues>

Closed value set for both completion and validation. None means free-form value (or boolean).

boolean: bool

true for boolean flags (no value expected).

repeatable: bool

true when this flag may appear multiple times. Currently informational; reserved for downstream parsers/validators.

yaml_directive: Option<&'static str>

Optional YAML directive mirror. Currently informational; lets downstream YAML parsers cross-reference the same Directive.

Implementations

impl Directive

pub const fn closed( cli_flag: &'static str, values: &'static [&'static str], ) -> Self

Construct a value-taking directive with a closed set.

pub const fn value(cli_flag: &'static str) -> Self

Construct a free-form value-taking directive.

pub const fn boolean(cli_flag: &'static str) -> Self

Construct a boolean-flag directive.

pub const fn with_help(self, help: &'static str) -> Self

Builder: attach help text.

pub const fn repeatable(self) -> Self

Builder: mark as repeatable.

pub const fn with_yaml(self, name: &'static str) -> Self

Builder: attach the YAML mirror directive name.

Trait Implementations

impl Clone for Directive

fn clone(&self) -> Directive

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Directive

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

Formats the value using the given formatter.