pathmut 0.3.0

Command line utility for extracting, removing, and replacing components from path strings
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
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93

use clap::{crate_version, value_parser, Arg, ArgAction, Command};

use std::path::PathBuf;

pub fn build() -> Command {
    Command::new("pathmut")
        .version(crate_version!())
        .about("Mutates path strings.")
        .subcommands([
            ext_command(),
            stem_command(),
            prefix_command(),
            name_command(),
            parent_command(),
            first_command(),
        ])
        .dont_delimit_trailing_values(true)
        .arg_required_else_help(true)
        .subcommand_value_name("COMPONENT|COMMAND")
        .subcommand_help_heading("Components/Commands")
}

fn ext_command() -> Command {
    Command::new("ext")
        .about("Read or update file extension")
        .args(component_args())
        .arg_required_else_help(true)
}

fn stem_command() -> Command {
    Command::new("stem")
        .about("Read or update file stem")
        .args(component_args())
        .arg_required_else_help(true)
}

fn prefix_command() -> Command {
    Command::new("prefix")
        .about("Read or update file prefix")
        .args(component_args())
        .arg_required_else_help(true)
}

fn name_command() -> Command {
    Command::new("name")
        .about("Read or update file name")
        .args(component_args())
        .arg_required_else_help(true)
}

fn parent_command() -> Command {
    Command::new("parent")
        .about("Read or update parent directory")
        .args(component_args())
        .arg_required_else_help(true)
}

fn first_command() -> Command {
    Command::new("first")
        .about("Read or update first component")
        .args(component_args())
        .arg_required_else_help(true)
}

fn component_args() -> [Arg; 3] {
    [path_arg(), remove_arg(), replace_arg()]
}

fn path_arg() -> Arg {
    Arg::new("path")
        .required(true)
        .action(ArgAction::Append)
        .help("Path string to mutate.")
        .value_parser(value_parser!(PathBuf))
}

fn remove_arg() -> Arg {
    Arg::new("remove")
        .short('r')
        .long("remove")
        .action(ArgAction::SetTrue)
        .help("Remove component from path")
        .conflicts_with("replace")
}

fn replace_arg() -> Arg {
    Arg::new("replace")
        .short('s')
        .long("replace")
        .action(ArgAction::Set)
        .help("Replace component in path")
        .conflicts_with("remove")
}