Пользовательские заголовки Rust Clap

Я использую библиотеку rust Clap для анализа аргументов командной строки. При отображении текста справки я хочу отделить обязательные аргументы от необязательных аргументов и поместить их в отдельные заголовки. Что-то вроде этого:

HELP:
    Example header 1:
        Arg 1
        Arg 2

    Example header 2:
        Arg 3
        Arg 4

Это возможно.

Прочитав это, this и this Я думаю, что это возможно, но я не уверен, как это сделать.

РЕДАКТИРОВАТЬ:
Итак, комментатор попросил меня обновить сообщение желаемым результатом, поэтому ниже приведен пример одной из приведенных выше ссылок. Я хотел бы иметь два раздела параметров и называть их.

$ myprog --help
My Super Program 1.0
Kevin K. <[email protected]>
Does awesome things

USAGE:
    MyApp [FLAGS] [OPTIONS] <INPUT> [SUBCOMMAND]

FLAGS:
    -h, --help       Prints this message
    -v               Sets the level of verbosity
    -V, --version    Prints version information

OPTIONS:
    -c, --config <FILE>    Sets a custom config file

ARGS:
    INPUT    The input file to use

SUBCOMMANDS:
    help    Prints this message
    test    Controls testing features

Итак, изменив раздел OPTIONS выше, чтобы он был:

OPTIONS-1:
    -c, --config <FILE>    Sets a custom config file.

OPTIONS-2:
    -a, --another <FILE>    Another example command.

rust clap
person Joh1998    schedule 07.06.2020    source источник
comment
Не могли бы вы уточнить желаемый результат, добавив в свой пост конкретные параметры примера?   -  person raindev    schedule 07.06.2020

Ответы (1)


arrow_upward
1
arrow_downward

Думаю, вы ищете help_heading. Кажется, это было добавлено недавно, поэтому вам нужно будет взять самую последнюю фиксацию.

cargo.toml

[dependencies]
clap = { git = "https://github.com/clap-rs/clap", rev = "8145717" }

main.rs

use clap::Clap;

#[derive(Clap, Debug)]
#[clap(
    name = "My Application",
    version = "1.0",
    author = "Jason M.",
    about = "Stack Overflow"
)]
struct Opts {
    #[clap(
        help_heading = Some("OPTIONS-1"),
        short,
        long,
        value_name="FILE",
        about = "Sets a custom config file"
    )]
    config: String,
    #[clap(
        help_heading = Some("OPTIONS-2"),
        short,
        long,
        value_name="FILE",
        about = "Another example command"
    )]
    another: String,
}

fn main() {
    let opts: Opts = Opts::parse();
}

use clap::{App, Arg};

fn main() {
    let app = App::new("My Application")
        .version("1.0")
        .author("Jason M.")
        .about("Stack Overflow")
        .help_heading("OPTIONS-1")
        .arg(
            Arg::new("config")
                .short('c')
                .long("config")
                .value_name("FILE")
                .about("Sets a custom config file"),
        )
        .help_heading("OPTIONS-2")
        .arg(
            Arg::new("another")
                .short('a')
                .long("another")
                .value_name("FILE")
                .about("Another example command"),
        );

    app.get_matches();
}

Любой из вышеперечисленных при запуске cargo run -- --help сгенерирует следующее:

My Application 1.0
Jason M.
Stack Overflow

USAGE:
    clap_headings --config <FILE> --another <FILE>

FLAGS:
    -h, --help       Prints help information
    -V, --version    Prints version information

OPTIONS-1:
    -c, --config <FILE>    Sets a custom config file

OPTIONS-2:
    -a, --another <FILE>    Another example command
person Jason    schedule 17.06.2020