Cmdargs

Command-line and config files parsing single header-file library for C++17.

Only long option names is supported.

The idea

Cmdargs this is an attempt to implement the concept of if the code is successfully compiled - it works correctly and no room for error and zero boilerplate code.

Capabilities

• default values for options
• optional and required options.
• option relations: and, or, not.
• predefined converters for std::vector/std::list/std::set/std::map

Command line example

// using the whole group

// declaring key-words
struct: cmdargs::kwords_group {
    CMDARGS_OPTION_ADD(fname, std::string, "source file name")
    CMDARGS_OPTION_ADD(fsize, std::size_t, "source file size", optional)
} const kwords;

int main(int argc, char **argv) {
    std::string emsg;
    auto args = cmdargs::parse_args(&emsg, argc, argv, kwords);
    if ( !emsg.empty() ) {
        std::cout << "cmdline parse error: " << emsg << std::endl;

        return EXIT_FAILURE;
    }

    const auto fname = args.get(kwords.fname);

    assert(args.is_set(kwords.fsize));
    const auto fsize = args.get(kwords.fsize);
}

// using structure bindings

// declaring key-words
struct: cmdargs::kwords_group {
    CMDARGS_OPTION_ADD(fname, std::string, "source file name")
    CMDARGS_OPTION_ADD(fsize, std::size_t, "source file size", optional)
} const kwords;

int main(int argc, char **argv) {
    std::string emsg;
    
    // 'fname' - std::optional<std::string>
    // 'fsize' - std::optional<std::size_t>
    const auto [fname, fsize] = cmdargs::parse_args(&emsg, argc, argv, kwords).optionals(); // or `.values()` can be used
    if ( !emsg.empty() ) {
        std::cout << "cmdline parse error: " << emsg << std::endl;

        return EXIT_FAILURE;
    }

    std::cout << "fname: is set=" << static_cast<bool>(fname) << ", v=" << fname.value() << std::endl;
    if ( fsize ) {
        std::cout << "fsize: is set=true, v=" << fsize.value() << std::endl;
    } else {
        std::cout << "fsize: is set=false, v=<UNINITIALIZED>" << std::endl;
    }
}

// using part of the options

// declaring key-words
struct: cmdargs::kwords_group {
    CMDARGS_OPTION_ADD(fname, std::string, "source file name")
    CMDARGS_OPTION_ADD(fsize, std::size_t, "source file size", optional)
    CMDARGS_OPTION_ADD(fmode, std::string, "processing mode")
} const kwords;

int main(int argc, char **argv) {
    std::string emsg;
    auto args = cmdargs::parse_args(&emsg, argc, argv, kwords.fname, kwords.fmode);
    if ( !emsg.empty() ) {
        std::cout << "cmdline parse error: " << emsg << std::endl;

        return EXIT_FAILURE;
    }

    const auto fname = args.get(kwords.fname);
    const auto fmode = args.get(kwords.fmode);
}

Config-file example

// declaring key-words
struct: cmdargs::kwords_group {
    CMDARGS_OPTION_ADD(fname, std::string, "source file name")
    CMDARGS_OPTION_ADD(fsize, std::size_t, "source file size", optional)
} const kwords;

int main(int argc, char **argv) {
    std::ifstream is;
    std::string emsg;
    auto set = cmdargs::from_file(&emsg, is, kwords.fname, kwords.fsize);
    if ( !emsg.empty() ) {
        std::cout << "file parse error: " << emsg << std::endl;

        return EXIT_FAILURE;
    }

    const auto fname = args.get(kwords.fname);
    const auto fsize = args.get(kwords.fsize);
}

Show help message

// for all the keywords

// declaring key-words
struct: cmdargs::kwords_group {
    CMDARGS_OPTION_ADD(fname, std::string, "source file name")
    CMDARGS_OPTION_ADD(fsize, std::size_t, "source file size", optional)
} const kwords;

int main(int argc, char **argv) {
    cmdargs::show_help(std::cout, argv[0], kwords);
}

// for selected keywords only

// declaring key-words
struct: cmdargs::kwords_group {
    CMDARGS_OPTION_ADD(fname, std::string, "source file name")
    CMDARGS_OPTION_ADD(fsize, std::size_t, "source file size", optional)
} const kwords;

int main(int argc, char **argv) {
    std::string emsg;
    auto args = cmdargs::parse_args(&emsg, argc, argv, kwords.fname, kwords.fsize);

    cmdargs::show_help(std::cout, argv[0], args);
}

TODO

• to implement check for child options