Position rest arguments before required arguments

[KAAtheWiseGit]

Good day!

clap requires the rest arguments to be placed last. So, the following setup doesn't work:

struct Cp {
    src: Vec<PathBuf>,
    dst: PathBuf,
}

// Found non-required positional argument with a lower index than a required positional argument: "paths" index Some(1)

Is there a way to bypass this behavior? And if not, is it possible to overwrite the usage text, so that it shows [SRC]... <DST> regardless of the actual underlying arguments? I tried the following, but it didn't work very well:

struct Cp {
    #[arg(id = "[PATHS]... <DST>")]
    paths: Vec<PathBuf>,
}

// Usage: cp [OPTIONS] [[PATHS]... <DST>]...

[epage]

Clap does not support that. We have very limited support for optional non-last argument.

To override the usage, Command::override_usage can be used as an attribute #[command(override_usage = "")]

[KAAtheWiseGit]

Thanks! override_usage, along with a creative use of \r, gave me this:

#[command(override_usage = "cp [OPTIONS] [SRC]... <DST>")]
struct Cp {
    #[arg(help = "Objects to copy\n\r  <DST>     Destination directory")]
    src: Vec<PathBuf>,
}

// Usage: cp [OPTIONS] [SRC]... <DST>
// 
// Arguments:
//   [SRC]...  Objects to copy
//   <DST>     Destination directory