Struct SpecView 

pub struct SpecView<'a> { /* private fields */ }

A borrowed, sparse view over a derive-generated Spec.

Constructing a view copies no command tree and is never part of argv parsing. It exists for cold paths—help, spec emission and completion—where a program may need runtime identity or a centrally audited metadata policy without lowering the static tables through usage-lib.

Implementations

impl<'a> SpecView<'a>

pub const fn new(base: &'a Spec<'a>) -> SpecView<'a>

pub fn name<'b, 'c>(self, name: &'b str) -> SpecView<'c>

where 'a: 'c, 'b: 'c,

pub fn bin<'b, 'c>(self, bin: &'b str) -> SpecView<'c>

where 'a: 'c, 'b: 'c,

pub fn version<'b, 'c>(self, version: &'b str) -> SpecView<'c>

where 'a: 'c, 'b: 'c,

pub fn omit_version(self) -> SpecView<'a>

Leave the runtime version out of emitted specs and other metadata consumers.

The parser’s built-in version response is unchanged because parsing reads the base spec. This is for checked-in generated artifacts whose version is managed independently.

pub fn overlay<'b, 'c>(self, commands: &'b [CommandOverlay<'b>]) -> SpecView<'c>

where 'a: 'c, 'b: 'c,

pub const fn spec(&self) -> Spec<'a>

The shallow effective spec. Its command metadata still borrows the derive’s static tree.

pub fn to_kdl(self) -> String

Emit the effective view without constructing or mutating a command graph.

Trait Implementations

impl<'a> Clone for SpecView<'a>

fn clone(&self) -> SpecView<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for SpecView<'a>

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

Formats the value using the given formatter.