use clap::{App, AppSettings, Arg, ArgMatches, ErrorKind, SubCommand};
use std::{env, process};
pub fn parse() -> ArgMatches<'static> {
let footnote = "Cargo commands (-x) are always executed before shell commands (-s). You can use the `-- command` style instead, note you'll need to use full commands, it won't prefix `cargo` for you. For select cargo subcommands (bench, build, clippy, run, test), you can use them directly without `--`.\n\nBy default, the workspace directories of your project and all local dependencies are watched, except for the target/ and .git/ folders. Your .ignore and .gitignore files are used to filter paths.".to_owned();
#[cfg(windows)] let footnote = format!("{}\n\nOn Windows, patterns given to -i have forward slashes (/) automatically converted to backward ones (\\) to ease command portability.", footnote);
let mut app = App::new(env!("CARGO_PKG_NAME"))
.bin_name("cargo watch")
.author(env!("CARGO_PKG_HOMEPAGE"))
.about(env!("CARGO_PKG_DESCRIPTION"))
.version(env!("CARGO_PKG_VERSION"))
.usage("cargo watch [FLAGS] [OPTIONS]")
.help_message("Display this message")
.version_message("Display version information")
.setting(AppSettings::AllowExternalSubcommands)
.setting(AppSettings::DisableHelpSubcommand)
.setting(AppSettings::StrictUtf8)
.arg(
Arg::with_name("once")
.long("testing-only--once")
.hidden(true),
)
.arg(
Arg::with_name("clear")
.short("c")
.long("clear")
.help("Clear the screen before each run"),
)
.arg(
Arg::with_name("log:debug")
.long("debug")
.help("Show debug output"),
)
.arg(
Arg::with_name("log:info")
.long("why")
.help("Show paths that changed"),
)
.arg(
Arg::with_name("ignore-nothing")
.long("ignore-nothing")
.help("Ignore nothing, not even target/ and .git/"),
)
.arg(
Arg::with_name("no-vcs-ignores")
.long("no-vcs-ignores")
.alias("no-gitignore")
.help("Don’t use .gitignore files"),
)
.arg(
Arg::with_name("no-dot-ignores")
.long("no-dot-ignores")
.alias("no-ignore")
.help("Don’t use .ignore files"),
)
.arg(
Arg::with_name("no-restart")
.long("no-restart")
.help("Don’t restart command while it’s still running"),
)
.arg(
Arg::with_name("packages:all")
.long("all")
.conflicts_with("packages:one")
.hidden(true)
.help("Reserved for workspace support"),
)
.arg(
Arg::with_name("poll")
.long("poll")
.help("Force use of polling for file changes"),
)
.arg(
Arg::with_name("postpone")
.long("postpone")
.help("Postpone first run until a file changes"),
)
.arg(
Arg::with_name("no-process-group")
.long("no-process-group")
.help("Do not use a process group when running the command")
)
.arg(
Arg::with_name("watch-when-idle")
.long("watch-when-idle")
.help("Ignore events emitted while the commands run."),
)
.arg(
Arg::with_name("features")
.long("features")
.takes_value(true)
.help("List of features passed to cargo invocations"),
)
.arg(
Arg::with_name("log:quiet")
.short("q")
.long("quiet")
.help("Suppress output from cargo-watch itself"),
)
.arg(
Arg::with_name("cmd:cargo")
.short("x")
.long("exec")
.takes_value(true)
.value_name("cmd")
.multiple(true)
.empty_values(false)
.min_values(1)
.number_of_values(1)
.help("Cargo command(s) to execute on changes [default: check]"),
)
.arg(
Arg::with_name("cmd:shell")
.short("s")
.long("shell")
.takes_value(true)
.value_name("cmd")
.multiple(true)
.empty_values(false)
.min_values(1)
.number_of_values(1)
.help("Shell command(s) to execute on changes"),
)
.arg(
Arg::with_name("delay")
.short("d")
.long("delay")
.takes_value(true)
.empty_values(false)
.default_value("0.5")
.help("File updates debounce delay in seconds"),
)
.arg(
Arg::with_name("ignore")
.short("i")
.long("ignore")
.takes_value(true)
.value_name("pattern")
.multiple(true)
.empty_values(false)
.min_values(1)
.number_of_values(1)
.help("Ignore a glob/gitignore-style pattern"),
)
.arg(
Arg::with_name("packages:one")
.short("p")
.long("package")
.takes_value(true)
.value_name("spec")
.multiple(true)
.empty_values(false)
.min_values(1)
.hidden(true)
.help("Reserved for workspace support"),
)
.arg(
Arg::with_name("watch")
.short("w")
.long("watch")
.takes_value(true)
.multiple(true)
.empty_values(false)
.min_values(1)
.number_of_values(1)
.help("Watch specific file(s) or folder(s). Disables finding and watching local dependencies."),
)
.arg(
Arg::with_name("use-shell")
.long("use-shell")
.takes_value(true)
.help(if cfg!(windows) {
"Use a different shell. Try --use-shell=powershell"
} else {
"Use a different shell. E.g. --use-shell=bash"
}),
)
.arg(
Arg::with_name("workdir")
.short("C")
.long("workdir")
.takes_value(true)
.help("Change working directory before running command [default: crate root]"),
)
.arg(
Arg::with_name("notif")
.help("Send a desktop notification when watchexec notices a change (experimental, behaviour may change)")
.short("N")
.long("notify")
)
.arg(
Arg::with_name("env-vars")
.help("Set environment variables for the command")
.short("E")
.long("env")
.takes_value(true)
.multiple(true)
.empty_values(false)
.min_values(1)
.number_of_values(1)
)
.arg(
Arg::with_name("env-files")
.help("Set environment variables from a .env file")
.long("env-file")
.takes_value(true)
.multiple(true)
.empty_values(false)
.min_values(1)
.number_of_values(1)
)
.arg(
Arg::with_name("env-changes")
.help("EXPERIMENTAL: Set environment variables for modified files")
.long("experimental--env-changes")
.hidden(true)
)
.arg(
Arg::with_name("rust-backtrace")
.help("Inject RUST_BACKTRACE=VALUE (generally you want to set it to 1) into the environment")
.short("B")
.takes_value(true)
)
.arg(
Arg::with_name("rust-log")
.help("Inject RUST_LOG=VALUE into the environment")
.short("L")
.takes_value(true)
)
.arg(
Arg::with_name("skip-local-deps")
.help("Don't try to find local dependencies of the current crate and watch their working directories. Only watch the current directory.")
.long("skip-local-deps")
)
.subcommand(special_cargo_subc("bench"))
.subcommand(special_cargo_subc("build"))
.subcommand(special_cargo_subc("check"))
.subcommand(special_cargo_subc("clippy"))
.subcommand(special_cargo_subc("test"))
.arg(
Arg::with_name("cmd:trail")
.raw(true)
.help("Full command to run. -x and -s will be ignored!"),
)
.after_help(footnote.as_str());
fn special_cargo_subc(name: &str) -> App {
SubCommand::with_name(name)
.setting(AppSettings::AllowLeadingHyphen)
.setting(AppSettings::DisableHelpFlags)
.setting(AppSettings::DisableHelpSubcommand)
.setting(AppSettings::DisableVersion)
.setting(AppSettings::Hidden)
.setting(AppSettings::TrailingVarArg)
.arg(Arg::with_name("args").multiple(true))
}
// Allow invocation of cargo-watch with both `cargo-watch watch ARGS`
// (as invoked by cargo) and `cargo-watch ARGS`.
let mut args: Vec<String> = env::args().collect();
if args.get(1).map(|s| s.as_str()) == Some("watch") {
args.remove(1);
}
let matches = match app.get_matches_from_safe_borrow(args) {
Ok(matches) => matches,
Err(err) => {
match err.kind {
ErrorKind::HelpDisplayed => {
println!("{}", err);
process::exit(0);
}
ErrorKind::VersionDisplayed => {
// Unlike HelpDisplayed, VersionDisplayed emits the output
// by itself (clap-rs/clap#1390). It also does so without a
// trailing newline, so we print one ourselves.
println!();
process::exit(0);
}
_ => app.get_matches(),
}
}
};
matches
}