Enum ArgBinding 

#[non_exhaustive]
pub enum ArgBinding {
    Typed,
    Verbatim,
}

How the kernel’s argv binder hands a tool its arguments.

The default split into ToolArgs::positional, ToolArgs::named and ToolArgs::flags is set-shaped, which suits most tools but cannot serve a subcommand tree: kj block list --limit 5 renders back as --limit=5 -- block list, which clap rejects because --limit belongs to list, not the root. Order and multiplicity are gone by then.

A third binding is plausible, so this enum is #[non_exhaustive] from the day it ships: adding the attribute later is itself a breaking change. Match with a wildcard arm that fails loudly, never a silent default.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Typed

Decompose into positional/named/flags. The default; every tool that does not ask for something else gets this.

Verbatim

Hand the tool every word after its name, in source order, as ToolArgs::words. See ToolSchema::with_verbatim_argv.

Implementations

impl ArgBinding

pub fn is_typed(&self) -> bool

True for the default binding. skip_serializing_if reads this so a typed tool’s schema carries no "arg_binding" key at all.

Trait Implementations

impl Clone for ArgBinding

fn clone(&self) -> ArgBinding

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ArgBinding

impl Debug for ArgBinding

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

Formats the value using the given formatter.

impl Default for ArgBinding

fn default() -> ArgBinding

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ArgBinding

fn deserialize<__D>( __deserializer: __D, ) -> Result<ArgBinding, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ArgBinding

impl PartialEq for ArgBinding

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ArgBinding

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ArgBinding