short_example.cpp

#include <clapp/argument.h>
#include <clapp/build_info.h>
#include <clapp/main_parser.h>
#include <clapp/option.h>
#include <unistd.h>

#include <iostream>

[[noreturn]] void print_version_and_exit();

[[noreturn]] void print_version_and_exit() {
    std::cout << clapp::build_info::build_info_string << std::endl;
    clapp::basic_main_parser_t::exit(EXIT_SUCCESS);
}

class cli_parser_t : public clapp::basic_main_parser_t {
   public:
    cli_parser_t(int argc, const char *const *argv) {
        parse_and_validate(argc, argv);
    }

    explicit cli_parser_t(const cli_parser_t &) = delete;
    explicit cli_parser_t(cli_parser_t &&) noexcept = delete;
    cli_parser_t &operator=(const cli_parser_t &) = delete;
    cli_parser_t &operator=(cli_parser_t &&) noexcept = delete;

    ~cli_parser_t() override;

    // if help is given, help is printed and exit(EXIT_SUCCESS) is called
    clapp::help_option_t help{*this, std::vector<std::string>{"help", "usage"},
                              std::vector<char>{'h', '?'},
                              "Show help options."};

    // if version is given, print_version_and_exit() is called.
    clapp::bool_option_t version{
        *this, std::vector<std::string>{"version", "vers"}, 'v',
        "Show version info",
        clapp::value::found_func_t{print_version_and_exit}};

    // first mandatory argument of string
    clapp::string_argument_t string_arg{*this, "string-arg", "String argument"};

    // second mandatory argument of int32_t
    clapp::int32_argument_t int_arg{
        *this, "int-arg", "Int argument",
        clapp::min_max_value_t<std::int32_t>{5, 10}};

    // third optional variadic arguments of strings
    clapp::variadic_string_argument_t variadic_string_arg{
        *this, "variadic-string-arg", "Variadic String argument",
        purpose_t::optional};

    // mandatory string option
    clapp::string_param_option_t string_param{
        *this, "string", std::vector<char>{'s', '1'}, "String option 1.",
        purpose_t::mandatory};

    // optional string option (multiple string vectors)
    clapp::vector_string_param_option_t string_vector_param{
        *this, "string-vector", "String vector param."};
};

cli_parser_t::~cli_parser_t() = default;

int main(int argc, char *argv[]) {
    try {
        cli_parser_t cp{argc, argv};  // parses and validates cli-arguments

        Expects(cp.string_arg);  // parser ensures mandatory arguments are given
        std::cout << "string-arg: " << cp.string_arg.value() << std::endl;