clars 0.2.0

Command line arguments resolution system
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
38
39
40
41
42
43
44
45
46
47
48
49
50

use crate::ClarMatches;
use antex::{ColorMode, StyledText, Text};
use std::path::Path;

/// Returns the application name and command line arguments.
///
/// # Examples
///
/// ```
/// use clars::get_app_and_args;
///
/// let (app, args) = get_app_and_args();
/// let expected_app_name = "rust_out";
/// assert_eq!(expected_app_name, app);
/// let expected_app_args: Vec<String> = vec![];
/// assert_eq!(expected_app_args, args);
///
/// ```
pub fn get_app_and_args() -> (String, Vec<String>) {
  let mut args = std::env::args();
  let name = Path::new(&args.next().expect("expected at least one argument"))
    .file_name()
    .expect("expected file name")
    .display()
    .to_string();
  (name, args.collect())
}

/// Returns the value of the first resolved argument with the given name.
pub fn get_first_value(matches: &ClarMatches, name: &str) -> Option<String> {
  matches.get_values(name).first().cloned().flatten()
}

/// Returns a colored text with more information hint.
pub fn get_more_info_hint(cm: ColorMode, options: &[impl AsRef<str>]) -> Text {
  let mut text = Text::new(cm).s("For more information, try ");
  for (index, option) in options.iter().enumerate() {
    if index > 0 {
      text += " or "
    }
    text += Text::new(cm)
      .s("'")
      .bright_cyan()
      .bold()
      .s(option.as_ref())
      .reset()
      .s("'");
  }
  text
}