Struct WrapperSpec 

pub struct WrapperSpec {
    pub name: String,
    pub short_value_flags: Vec<String>,
    pub long_value_flags: Vec<String>,
    pub unanalyzable_flags: Vec<String>,
    pub skip_env_assignments: bool,
    pub has_terminator: bool,
    pub skip_positionals: usize,
}

Describes how to strip a transparent wrapper command to find the inner command.

Each wrapper has different flag semantics. This struct captures just enough to correctly skip past the wrapper and its flags to the real command. Designed for deserialization from config files — consumers load specs from JSON/TOML/YAML and pass them to [resolve_command_with].

Fields

name: String

Command name to match (basename, e.g., “sudo”).

short_value_flags: Vec<String>

Short flags that consume the next token as a value (e.g., ["-u", "-g"]).

long_value_flags: Vec<String>

Long flags that consume the next token as a value (e.g., ["--user", "--group"]).

unanalyzable_flags: Vec<String>

Flags whose presence makes the entire invocation unanalyzable. Example: env -S executes its value as a command string (eval-equivalent).

skip_env_assignments: bool

Whether to skip leading KEY=VALUE tokens after the wrapper (env-style).

has_terminator: bool

Whether -- terminates flag processing for this wrapper.

skip_positionals: usize

Number of leading positional arguments to skip before the inner command.

Some wrappers require mandatory positional args before the command: timeout DURATION cmd, chrt PRIORITY cmd, taskset MASK cmd. Set this to the number of positionals to consume before treating the next non-flag token as the inner command.

Trait Implementations

impl Clone for WrapperSpec

fn clone(&self) -> WrapperSpec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WrapperSpec

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for WrapperSpec

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for WrapperSpec

fn eq(&self, other: &WrapperSpec) -> 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 Serialize for WrapperSpec

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for WrapperSpec

impl StructuralPartialEq for WrapperSpec