OptSpec

Struct OptSpec 

Source
pub struct OptSpec {
    pub name: &'static str,
    pub short: Option<char>,
    pub ty: &'static str,
    pub doc: &'static str,
    pub env: Option<&'static str>,
    pub default: Option<&'static str>,
    pub example: Option<&'static str>,
}
Expand description

Specification for Opt.

Note that noargs does not support options with only short names.

Fields§

§name: &'static str

Option long name (usually kebab-case).

§short: Option<char>

Option short name.

§ty: &'static str

Value type.

§doc: &'static str

Documentation.

§env: Option<&'static str>

Environment variable name.

If a non-empty value is set for this environment variable, it will be used as the value of this option when the option is not specified in RawArgs.

§default: Option<&'static str>

Default value.

§example: Option<&'static str>

Example value (if this is set, the option is considered to be requried when generating the help text).

This is only used if RawArgs::metadata().help_mode is true.

Implementations§

Source§

impl OptSpec

Source

pub const DEFAULT: Self

The default specification.

Source

pub const fn new(name: &'static str) -> Self

Makes an OptSpec instance with a specified name (equivalent to noargs::opt(name)).

Source

pub const fn short(self, name: char) -> Self

Updates the value of OptSpec::short.

Source

pub const fn ty(self, value_type: &'static str) -> Self

Updates the value of OptSpec::ty.

Source

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

Updates the value of OptSpec::doc.

Source

pub const fn env(self, variable_name: &'static str) -> Self

Updates the value of OptSpec::env.

Source

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

Updates the value of OptSpec::default.

Source

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

Updates the value of OptSpec::example.

Source

pub fn take(self, args: &mut RawArgs) -> Opt

Takes the first Opt instance that satisfies this specification from the raw arguments.

Trait Implementations§

Source§

impl Clone for OptSpec

Source§

fn clone(&self) -> OptSpec

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for OptSpec

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for OptSpec

Source§

fn default() -> Self

Returns the “default value” for a type. Read more
Source§

impl Hash for OptSpec

Source§

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher. Read more
1.3.0 · Source§

fn hash_slice<H>(data: &[Self], state: &mut H)
where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher. Read more
Source§

impl PartialEq for OptSpec

Source§

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

Tests for self and other values to be equal, and is used by ==.
1.0.0 · Source§

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

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

impl Copy for OptSpec

Source§

impl Eq for OptSpec

Source§

impl StructuralPartialEq for OptSpec

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.