clap/tests/derive_order.rs

mod utils;

use std::str;

use clap::{App, AppSettings, Arg};

static NO_DERIVE_ORDER: &str = "test 1.2

USAGE:
    test [FLAGS] [OPTIONS]

FLAGS:
        --flag_a     second flag
        --flag_b     first flag
    -h, --help       Prints help information
    -V, --version    Prints version information

OPTIONS:
        --option_a <option_a>    second option
        --option_b <option_b>    first option";

static DERIVE_ORDER: &str = "test 1.2

USAGE:
    test [FLAGS] [OPTIONS]

FLAGS:
        --flag_b     first flag
        --flag_a     second flag
    -h, --help       Prints help information
    -V, --version    Prints version information

OPTIONS:
        --option_b <option_b>    first option
        --option_a <option_a>    second option";

static UNIFIED_HELP: &str = "test 1.2

USAGE:
    test [OPTIONS]

OPTIONS:
        --flag_a                 second flag
        --flag_b                 first flag
    -h, --help                   Prints help information
        --option_a <option_a>    second option
        --option_b <option_b>    first option
    -V, --version                Prints version information";

static UNIFIED_HELP_AND_DERIVE: &str = "test 1.2

USAGE:
    test [OPTIONS]

OPTIONS:
        --flag_b                 first flag
        --option_b <option_b>    first option
        --flag_a                 second flag
        --option_a <option_a>    second option
    -h, --help                   Prints help information
    -V, --version                Prints version information";

static DERIVE_ORDER_SC_PROP: &str = "test-sub 1.2

USAGE:
    test sub [FLAGS] [OPTIONS]

FLAGS:
        --flag_b     first flag
        --flag_a     second flag
    -h, --help       Prints help information
    -V, --version    Prints version information

OPTIONS:
        --option_b <option_b>    first option
        --option_a <option_a>    second option";

static UNIFIED_SC_PROP: &str = "test-sub 1.2

USAGE:
    test sub [OPTIONS]

OPTIONS:
        --flag_a                 second flag
        --flag_b                 first flag
    -h, --help                   Prints help information
        --option_a <option_a>    second option
        --option_b <option_b>    first option
    -V, --version                Prints version information";

static UNIFIED_DERIVE_SC_PROP: &str = "test-sub 1.2

USAGE:
    test sub [OPTIONS]

OPTIONS:
        --flag_b                 first flag
        --option_b <option_b>    first option
        --flag_a                 second flag
        --option_a <option_a>    second option
    -h, --help                   Prints help information
    -V, --version                Prints version information";

static UNIFIED_DERIVE_SC_PROP_EXPLICIT_ORDER: &str = "test-sub 1.2

USAGE:
    test sub [OPTIONS]

OPTIONS:
        --flag_a                 second flag
        --flag_b                 first flag
        --option_b <option_b>    first option
        --option_a <option_a>    second option
    -h, --help                   Prints help information
    -V, --version                Prints version information";

#[test]
fn no_derive_order() {
    let app = App::new("test").version("1.2").args(&[
        Arg::with_name("flag_b").long("flag_b").help("first flag"),
        Arg::with_name("option_b")
            .long("option_b")
            .takes_value(true)
            .help("first option"),
        Arg::with_name("flag_a").long("flag_a").help("second flag"),
        Arg::with_name("option_a")
            .long("option_a")
            .takes_value(true)
            .help("second option"),
    ]);

    assert!(utils::compare_output(
        app,
        "test --help",
        NO_DERIVE_ORDER,
        false
    ));
}

#[test]
fn derive_order() {
    let app = App::new("test")
        .setting(AppSettings::DeriveDisplayOrder)
        .version("1.2")
        .args(&[
            Arg::with_name("flag_b").long("flag_b").help("first flag"),
            Arg::with_name("option_b")
                .long("option_b")
                .takes_value(true)
                .help("first option"),
            Arg::with_name("flag_a").long("flag_a").help("second flag"),
            Arg::with_name("option_a")
                .long("option_a")
                .takes_value(true)
                .help("second option"),
        ]);

    assert!(utils::compare_output(
        app,
        "test --help",
        DERIVE_ORDER,
        false
    ));
}

#[test]
fn unified_help() {
    let app = App::new("test")
        .setting(AppSettings::UnifiedHelpMessage)
        .version("1.2")
        .args(&[
            Arg::with_name("flag_b").long("flag_b").help("first flag"),
            Arg::with_name("option_b")
                .long("option_b")
                .takes_value(true)
                .help("first option"),
            Arg::with_name("flag_a").long("flag_a").help("second flag"),
            Arg::with_name("option_a")
                .long("option_a")
                .takes_value(true)
                .help("second option"),
        ]);

    assert!(utils::compare_output(
        app,
        "test --help",
        UNIFIED_HELP,
        false
    ));
}

#[test]
fn unified_help_and_derive_order() {
    let app = App::new("test")
        .setting(AppSettings::DeriveDisplayOrder)
        .setting(AppSettings::UnifiedHelpMessage)
        .version("1.2")
        .args(&[
            Arg::with_name("flag_b").long("flag_b").help("first flag"),
            Arg::with_name("option_b")
                .long("option_b")
                .takes_value(true)
                .help("first option"),
            Arg::with_name("flag_a").long("flag_a").help("second flag"),
            Arg::with_name("option_a")
                .long("option_a")
                .takes_value(true)
                .help("second option"),
        ]);

    assert!(utils::compare_output(
        app,
        "test --help",
        UNIFIED_HELP_AND_DERIVE,
        false
    ));
}

#[test]
fn derive_order_subcommand_propagate() {
    let app = App::new("test")
        .global_setting(AppSettings::DeriveDisplayOrder)
        .version("1.2")
        .subcommand(
            App::new("sub").version("1.2").args(&[
                Arg::with_name("flag_b").long("flag_b").help("first flag"),
                Arg::with_name("option_b")
                    .long("option_b")
                    .takes_value(true)
                    .help("first option"),
                Arg::with_name("flag_a").long("flag_a").help("second flag"),
                Arg::with_name("option_a")
                    .long("option_a")
                    .takes_value(true)
                    .help("second option"),
            ]),
        );

    assert!(utils::compare_output(
        app,
        "test sub --help",
        DERIVE_ORDER_SC_PROP,
        false
    ));
}

#[test]
fn unified_help_subcommand_propagate() {
    let app = App::new("test")
        .global_setting(AppSettings::UnifiedHelpMessage)
        .subcommand(
            App::new("sub").version("1.2").args(&[
                Arg::with_name("flag_b").long("flag_b").help("first flag"),
                Arg::with_name("option_b")
                    .long("option_b")
                    .takes_value(true)
                    .help("first option"),
                Arg::with_name("flag_a").long("flag_a").help("second flag"),
                Arg::with_name("option_a")
                    .long("option_a")
                    .takes_value(true)
                    .help("second option"),
            ]),
        );

    assert!(utils::compare_output(
        app,
        "test sub --help",
        UNIFIED_SC_PROP,
        false
    ));
}

#[test]
fn unified_help_and_derive_order_subcommand_propagate() {
    let app = App::new("test")
        .global_setting(AppSettings::DeriveDisplayOrder)
        .global_setting(AppSettings::UnifiedHelpMessage)
        .subcommand(
            App::new("sub").version("1.2").args(&[
                Arg::with_name("flag_b").long("flag_b").help("first flag"),
                Arg::with_name("option_b")
                    .long("option_b")
                    .takes_value(true)
                    .help("first option"),
                Arg::with_name("flag_a").long("flag_a").help("second flag"),
                Arg::with_name("option_a")
                    .long("option_a")
                    .takes_value(true)
                    .help("second option"),
            ]),
        );

    assert!(utils::compare_output(
        app,
        "test sub --help",
        UNIFIED_DERIVE_SC_PROP,
        false
    ));
}

#[test]
fn unified_help_and_derive_order_subcommand_propagate_with_explicit_display_order() {
    let app = App::new("test")
        .global_setting(AppSettings::DeriveDisplayOrder)
        .global_setting(AppSettings::UnifiedHelpMessage)
        .subcommand(
            App::new("sub").version("1.2").args(&[
                Arg::with_name("flag_b").long("flag_b").help("first flag"),
                Arg::with_name("option_b")
                    .long("option_b")
                    .takes_value(true)
                    .help("first option"),
                Arg::with_name("flag_a")
                    .long("flag_a")
                    .help("second flag")
                    .display_order(0),
                Arg::with_name("option_a")
                    .long("option_a")
                    .takes_value(true)
                    .help("second option"),
            ]),
        );

    assert!(utils::compare_output(
        app,
        "test sub --help",
        UNIFIED_DERIVE_SC_PROP_EXPLICIT_ORDER,
        false
    ));
}