args 2.2.0

An argument parsing and validation library designed to take some of tediousness out of the general 'getopts' crate.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

use std::ffi::OsStr;

use super::super::{Args,ArgsError};

/// A trait designed to bind associated convenience methods to a struct.
pub trait HasArgs: Send {
    // Associated methods
    /// Returns a mutable references to an associated `Args` struct.
    fn args() -> Args where Self: Sized;

    // Defaulted associated methods
    /// Generates a combination of the short and verbose usage messages.
    fn full_usage() -> String where Self: Sized {
        format!("{}\n\n{}", Self::short_usage(), Self::usage())
    }

    /// Acts as a convenience method for calling the associated `Args` implementation.
    fn parse<C: IntoIterator>(raw_args: C) -> Result<(), ArgsError> where C::Item: AsRef<OsStr>, Self: Sized {
        Self::args().parse(raw_args)
    }

    /// Acts as a convenience method for calling the associated `Args` implementation.
    fn parse_from_cli() -> Result<(), ArgsError> where Self: Sized {
        Self::args().parse_from_cli()
    }

    /// Acts as a convenience method for calling the associated `Args` implementation.
    fn short_usage() -> String where Self: Sized {
        Self::args().short_usage()
    }

    /// Acts as a convenience method for calling the associated `Args` implementation.
    fn usage() -> String where Self: Sized {
        Self::args().usage()
    }
}