mirror of
https://github.com/RGBCube/serenity
synced 2025-07-24 21:57:35 +00:00
LibCore: Rewrite CArgsParser
This is a complete reimplementation of CArgsParser with a different API. Now, CArgsParser properly supports and distinguishes between: * Positional arguments (required or not) * Options Options can be short and/or long. The API allows you to add custom option and argument types. A few types are pre-implemented for convenience: * Boolean options (take no value) * String and integer options (take a required value) * String and integer arguments * Vector-of-string arguments This commit doesn't include changes for all the users of CArgsParser (see next commit for that).
This commit is contained in:
Sergey Bugaev
Andreas Kling
parent
e7512ae2d1
commit
9276582535
2 changed files with 303 additions and 257 deletions
|
|
@ -1,5 +1,5 @@
|
||||||
/*
|
/*
|
||||||
* Copyright (c) 2018-2020, Andreas Kling <kling@serenityos.org>
|
* Copyright (c) 2020, Sergey Bugaev <bugaevc@serenityos.org>
|
||||||
* All rights reserved.
|
* All rights reserved.
|
||||||
*
|
*
|
||||||
* Redistribution and use in source and binary forms, with or without
|
* Redistribution and use in source and binary forms, with or without
|
||||||
|
|
@ -27,239 +27,295 @@
|
||||||
#include "CArgsParser.h"
|
#include "CArgsParser.h"
|
||||||
#include <AK/StringBuilder.h>
|
#include <AK/StringBuilder.h>
|
||||||
|
|
||||||
|
#include <getopt.h>
|
||||||
#include <stdio.h>
|
#include <stdio.h>
|
||||||
|
|
||||||
bool CArgsParserResult::is_present(const String& arg_name) const
|
CArgsParser::CArgsParser()
|
||||||
{
|
{
|
||||||
return m_args.contains(arg_name);
|
add_option(m_show_help, "Display this message", "help", 0);
|
||||||
}
|
}
|
||||||
|
|
||||||
String CArgsParserResult::get(const String& arg_name) const
|
void CArgsParser::parse(int argc, char** argv)
|
||||||
{
|
{
|
||||||
return m_args.get(arg_name).value_or({});
|
auto print_usage_and_exit = [this, argv] {
|
||||||
}
|
print_usage(stderr, argv[0]);
|
||||||
|
exit(1);
|
||||||
|
};
|
||||||
|
Vector<option> long_options;
|
||||||
|
StringBuilder short_options_builder;
|
||||||
|
|
||||||
const Vector<String>& CArgsParserResult::get_single_values() const
|
int index_of_found_long_option = -1;
|
||||||
{
|
|
||||||
return m_single_values;
|
|
||||||
}
|
|
||||||
|
|
||||||
CArgsParser::Arg::Arg(const String& name, const String& description, bool required)
|
for (int i = 0; i < m_options.size(); i++) {
|
||||||
: name(name)
|
auto& opt = m_options[i];
|
||||||
, description(description)
|
if (opt.long_name) {
|
||||||
, required(required)
|
option long_opt {
|
||||||
{
|
opt.long_name,
|
||||||
}
|
opt.requires_argument ? required_argument : no_argument,
|
||||||
|
&index_of_found_long_option,
|
||||||
|
i
|
||||||
|
};
|
||||||
|
long_options.append(long_opt);
|
||||||
|
}
|
||||||
|
if (opt.short_name) {
|
||||||
|
short_options_builder.append(opt.short_name);
|
||||||
|
if (opt.requires_argument)
|
||||||
|
short_options_builder.append(':');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
long_options.append({ 0, 0, 0, 0 });
|
||||||
|
|
||||||
CArgsParser::Arg::Arg(const String& name, const String& value_name, const String& description, bool required)
|
String short_options = short_options_builder.build();
|
||||||
: name(name)
|
|
||||||
, description(description)
|
|
||||||
, value_name(value_name)
|
|
||||||
, required(required)
|
|
||||||
{
|
|
||||||
}
|
|
||||||
|
|
||||||
CArgsParser::CArgsParser(const String& program_name)
|
while (true) {
|
||||||
: m_program_name(program_name)
|
int c = getopt_long(argc, argv, short_options.characters(), long_options.data(), nullptr);
|
||||||
, m_prefix("-")
|
if (c == -1) {
|
||||||
{
|
// We have reached the end.
|
||||||
}
|
break;
|
||||||
|
} else if (c == '?') {
|
||||||
CArgsParserResult CArgsParser::parse(int argc, char** argv)
|
// There was an error, and getopt() has already
|
||||||
{
|
// printed its error message.
|
||||||
CArgsParserResult res;
|
print_usage_and_exit();
|
||||||
|
|
||||||
// We should have at least one parameter
|
|
||||||
if (argc < 2)
|
|
||||||
return {};
|
|
||||||
|
|
||||||
// We parse the first parameter at the index 1
|
|
||||||
if (parse_next_param(1, argv, argc - 1, res) != 0)
|
|
||||||
return {};
|
|
||||||
|
|
||||||
if (!check_required_args(res))
|
|
||||||
return {};
|
|
||||||
|
|
||||||
return res;
|
|
||||||
}
|
|
||||||
|
|
||||||
int CArgsParser::parse_next_param(int index, char** argv, const int params_left, CArgsParserResult& res)
|
|
||||||
{
|
|
||||||
ASSERT(params_left >= 0);
|
|
||||||
if (params_left == 0)
|
|
||||||
return 0;
|
|
||||||
|
|
||||||
String param = argv[index];
|
|
||||||
|
|
||||||
// We check if the prefix is found at the beginning of the param name
|
|
||||||
if (is_param_valid(param)) {
|
|
||||||
auto prefix_length = m_prefix.length();
|
|
||||||
String param_name = param.substring(prefix_length, param.length() - prefix_length);
|
|
||||||
|
|
||||||
auto arg = m_args.find(param_name);
|
|
||||||
if (arg == m_args.end()) {
|
|
||||||
printf("Unknown arg \"");
|
|
||||||
if (!param_name.is_null())
|
|
||||||
printf("%s", param_name.characters());
|
|
||||||
printf("\"\n");
|
|
||||||
return -1;
|
|
||||||
}
|
}
|
||||||
|
|
||||||
// If this parameter must be followed by a value, we look for it
|
// Let's see what option we just found.
|
||||||
if (!arg->value.value_name.is_null()) {
|
Option* found_option = nullptr;
|
||||||
if (params_left < 2) {
|
if (c == 0) {
|
||||||
printf("Missing value for argument %s\n", arg->value.name.characters());
|
// It was a long option.
|
||||||
return -1;
|
ASSERT(index_of_found_long_option >= 0);
|
||||||
|
found_option = &m_options[index_of_found_long_option];
|
||||||
|
index_of_found_long_option = -1;
|
||||||
|
} else {
|
||||||
|
// It was a short option, look it up.
|
||||||
|
auto it = m_options.find([c](auto& opt) { return c == opt.short_name; });
|
||||||
|
ASSERT(!it.is_end());
|
||||||
|
found_option = &*it;
|
||||||
|
}
|
||||||
|
ASSERT(found_option);
|
||||||
|
|
||||||
|
const char* arg = found_option->requires_argument ? optarg : nullptr;
|
||||||
|
if (!found_option->accept_value(arg)) {
|
||||||
|
fprintf(stderr, "Invalid value for option %s\n", found_option->name_for_display().characters());
|
||||||
|
print_usage_and_exit();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// We're done processing options, now let's parse positional arguments.
|
||||||
|
|
||||||
|
int values_left = argc - optind;
|
||||||
|
int num_values_for_arg[m_positional_args.size()];
|
||||||
|
int total_values_required = 0;
|
||||||
|
for (int i = 0; i < m_positional_args.size(); i++) {
|
||||||
|
auto& arg = m_positional_args[i];
|
||||||
|
num_values_for_arg[i] = arg.min_values;
|
||||||
|
total_values_required += arg.min_values;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (total_values_required > values_left)
|
||||||
|
print_usage_and_exit();
|
||||||
|
int extra_values_to_distribute = values_left - total_values_required;
|
||||||
|
|
||||||
|
for (int i = 0; i < m_positional_args.size(); i++) {
|
||||||
|
auto& arg = m_positional_args[i];
|
||||||
|
int extra_values_to_this_arg = min(arg.max_values - arg.min_values, extra_values_to_distribute);
|
||||||
|
num_values_for_arg[i] += extra_values_to_this_arg;
|
||||||
|
extra_values_to_distribute -= extra_values_to_this_arg;
|
||||||
|
if (extra_values_to_distribute == 0)
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (extra_values_to_distribute > 0) {
|
||||||
|
// We still have too many values :(
|
||||||
|
print_usage_and_exit();
|
||||||
|
}
|
||||||
|
|
||||||
|
for (int i = 0; i < m_positional_args.size(); i++) {
|
||||||
|
auto& arg = m_positional_args[i];
|
||||||
|
for (int j = 0; j < num_values_for_arg[i]; j++) {
|
||||||
|
const char* value = argv[optind++];
|
||||||
|
if (!arg.accept_value(value)) {
|
||||||
|
fprintf(stderr, "Invalid value for argument %s\n", arg.name);
|
||||||
|
print_usage_and_exit();
|
||||||
}
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
String next = String(argv[index + 1]);
|
// We're done parsing! :)
|
||||||
|
// Now let's show help if requested.
|
||||||
|
if (m_show_help) {
|
||||||
|
print_usage(stdout, argv[0]);
|
||||||
|
exit(0);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
if (is_param_valid(next)) {
|
void CArgsParser::print_usage(FILE* file, const char* argv0)
|
||||||
printf("Missing value for argument %s\n", arg->value.name.characters());
|
{
|
||||||
return -1;
|
fprintf(file, "Usage:\n\t%s", argv0);
|
||||||
|
|
||||||
|
for (auto& opt : m_options) {
|
||||||
|
if (opt.long_name && !strcmp(opt.long_name, "help"))
|
||||||
|
continue;
|
||||||
|
if (opt.requires_argument)
|
||||||
|
fprintf(file, " [%s %s]", opt.name_for_display().characters(), opt.value_name);
|
||||||
|
else
|
||||||
|
fprintf(file, " [%s]", opt.name_for_display().characters());
|
||||||
|
}
|
||||||
|
for (auto& arg : m_positional_args) {
|
||||||
|
bool required = arg.min_values > 0;
|
||||||
|
bool repeated = arg.max_values > 1;
|
||||||
|
|
||||||
|
if (required && repeated)
|
||||||
|
fprintf(file, " <%s...>", arg.name);
|
||||||
|
else if (required && !repeated)
|
||||||
|
fprintf(file, " <%s>", arg.name);
|
||||||
|
else if (!required && repeated)
|
||||||
|
fprintf(file, " [%s...]", arg.name);
|
||||||
|
else if (!required && !repeated)
|
||||||
|
fprintf(file, " [%s]", arg.name);
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!m_options.is_empty())
|
||||||
|
fprintf(file, "\nOptions:\n");
|
||||||
|
|
||||||
|
for (auto& opt : m_options) {
|
||||||
|
auto print_argument = [&]() {
|
||||||
|
if (opt.value_name) {
|
||||||
|
if (opt.requires_argument)
|
||||||
|
fprintf(file, " %s", opt.value_name);
|
||||||
|
else
|
||||||
|
fprintf(file, " [%s]", opt.value_name);
|
||||||
}
|
}
|
||||||
|
};
|
||||||
res.m_args.set(arg->value.name, next);
|
fprintf(file, "\t");
|
||||||
return parse_next_param(index + 2, argv, params_left - 2, res);
|
if (opt.short_name) {
|
||||||
|
fprintf(file, "-%c", opt.short_name);
|
||||||
|
print_argument();
|
||||||
|
}
|
||||||
|
if (opt.short_name && opt.long_name)
|
||||||
|
fprintf(file, ", ");
|
||||||
|
if (opt.long_name) {
|
||||||
|
fprintf(file, "--%s", opt.long_name);
|
||||||
|
print_argument();
|
||||||
}
|
}
|
||||||
|
|
||||||
// Single argument, not followed by a value
|
if (opt.help_string)
|
||||||
res.m_args.set(arg->value.name, "");
|
fprintf(file, "\t%s", opt.help_string);
|
||||||
return parse_next_param(index + 1, argv, params_left - 1, res);
|
fprintf(file, "\n");
|
||||||
}
|
}
|
||||||
|
|
||||||
// Else, it's a value alone, a file name parameter for example
|
if (!m_positional_args.is_empty())
|
||||||
res.m_single_values.append(param);
|
fprintf(file, "\nArguments:\n");
|
||||||
return parse_next_param(index + 1, argv, params_left - 1, res);
|
|
||||||
|
for (auto& arg : m_positional_args) {
|
||||||
|
fprintf(file, "\t%s", arg.name);
|
||||||
|
if (arg.help_string)
|
||||||
|
fprintf(file, "\t%s", arg.help_string);
|
||||||
|
fprintf(file, "\n");
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
bool CArgsParser::is_param_valid(const String& param_name)
|
void CArgsParser::add_option(Option&& option)
|
||||||
{
|
{
|
||||||
return param_name.length() >= m_prefix.length() &&
|
m_options.append(move(option));
|
||||||
param_name.substring(0, m_prefix.length()) == m_prefix;
|
|
||||||
}
|
}
|
||||||
|
|
||||||
bool CArgsParser::check_required_args(const CArgsParserResult& res)
|
void CArgsParser::add_option(bool& value, const char* help_string, const char* long_name, char short_name)
|
||||||
{
|
{
|
||||||
for (auto& it : m_args) {
|
Option option {
|
||||||
if (it.value.required) {
|
false,
|
||||||
if (!res.is_present(it.value.name))
|
help_string,
|
||||||
return false;
|
long_name,
|
||||||
|
short_name,
|
||||||
|
nullptr,
|
||||||
|
[&value](const char* s) {
|
||||||
|
ASSERT(s == nullptr);
|
||||||
|
value = true;
|
||||||
|
return true;
|
||||||
}
|
}
|
||||||
}
|
};
|
||||||
|
add_option(move(option));
|
||||||
|
}
|
||||||
|
|
||||||
int required_arguments = 0;
|
void CArgsParser::add_option(const char*& value, const char* help_string, const char* long_name, char short_name, const char* value_name)
|
||||||
for (const auto& a : m_single_args) {
|
{
|
||||||
if (a.required) {
|
Option option {
|
||||||
required_arguments++;
|
true,
|
||||||
|
help_string,
|
||||||
|
long_name,
|
||||||
|
short_name,
|
||||||
|
value_name,
|
||||||
|
[&value](const char* s) {
|
||||||
|
value = s;
|
||||||
|
return true;
|
||||||
}
|
}
|
||||||
}
|
};
|
||||||
|
add_option(move(option));
|
||||||
if (required_arguments != 0) {
|
|
||||||
if (res.m_single_values.size() < required_arguments)
|
|
||||||
return false;
|
|
||||||
}
|
|
||||||
|
|
||||||
return true;
|
|
||||||
}
|
}
|
||||||
|
|
||||||
void CArgsParser::add_required_arg(const String& name, const String& description)
|
void CArgsParser::add_option(int& value, const char* help_string, const char* long_name, char short_name, const char* value_name)
|
||||||
{
|
{
|
||||||
m_args.set(name, Arg(name, description, true));
|
Option option {
|
||||||
}
|
true,
|
||||||
|
help_string,
|
||||||
void CArgsParser::add_required_arg(const String& name, const String& value_name, const String& description)
|
long_name,
|
||||||
{
|
short_name,
|
||||||
m_args.set(name, Arg(name, value_name, description, true));
|
value_name,
|
||||||
}
|
[&value](const char* s) {
|
||||||
|
bool ok;
|
||||||
void CArgsParser::add_arg(const String& name, const String& description)
|
value = StringView(s).to_int(ok);
|
||||||
{
|
return ok;
|
||||||
m_args.set(name, Arg(name, description, false));
|
|
||||||
}
|
|
||||||
|
|
||||||
void CArgsParser::add_arg(const String& name, const String& value_name, const String& description)
|
|
||||||
{
|
|
||||||
m_args.set(name, Arg(name, value_name, description, false));
|
|
||||||
}
|
|
||||||
|
|
||||||
void CArgsParser::add_single_value(const String& name)
|
|
||||||
{
|
|
||||||
m_single_args.append(SingleArg { name, false });
|
|
||||||
}
|
|
||||||
|
|
||||||
void CArgsParser::add_required_single_value(const String& name)
|
|
||||||
{
|
|
||||||
if (m_single_args.size() != 0) {
|
|
||||||
// adding required arguments after non-required arguments would be nonsensical
|
|
||||||
ASSERT(m_single_args.last().required);
|
|
||||||
}
|
|
||||||
m_single_args.append(SingleArg { name, true });
|
|
||||||
}
|
|
||||||
|
|
||||||
String CArgsParser::get_usage() const
|
|
||||||
{
|
|
||||||
StringBuilder sb;
|
|
||||||
|
|
||||||
sb.append("usage : ");
|
|
||||||
sb.append(m_program_name);
|
|
||||||
sb.append(" ");
|
|
||||||
|
|
||||||
for (auto& it : m_args) {
|
|
||||||
if (it.value.required)
|
|
||||||
sb.append("<");
|
|
||||||
else
|
|
||||||
sb.append("[");
|
|
||||||
|
|
||||||
sb.append(m_prefix);
|
|
||||||
sb.append(it.value.name);
|
|
||||||
|
|
||||||
if (!it.value.value_name.is_null()) {
|
|
||||||
sb.append(" ");
|
|
||||||
sb.append(it.value.value_name);
|
|
||||||
}
|
}
|
||||||
|
};
|
||||||
if (it.value.required)
|
add_option(move(option));
|
||||||
sb.append("> ");
|
|
||||||
else
|
|
||||||
sb.append("] ");
|
|
||||||
}
|
|
||||||
|
|
||||||
for (auto& arg : m_single_args) {
|
|
||||||
if (arg.required)
|
|
||||||
sb.append("<");
|
|
||||||
else
|
|
||||||
sb.append("[");
|
|
||||||
|
|
||||||
sb.append(arg.name);
|
|
||||||
|
|
||||||
if (arg.required)
|
|
||||||
sb.append("> ");
|
|
||||||
else
|
|
||||||
sb.append("] ");
|
|
||||||
}
|
|
||||||
|
|
||||||
sb.append("\n");
|
|
||||||
|
|
||||||
for (auto& it : m_args) {
|
|
||||||
sb.append(" ");
|
|
||||||
sb.append(m_prefix);
|
|
||||||
sb.append(it.value.name);
|
|
||||||
|
|
||||||
if (!it.value.value_name.is_null()) {
|
|
||||||
sb.append(" ");
|
|
||||||
sb.append(it.value.value_name);
|
|
||||||
}
|
|
||||||
|
|
||||||
sb.append(" : ");
|
|
||||||
sb.append(it.value.description);
|
|
||||||
sb.append("\n");
|
|
||||||
}
|
|
||||||
|
|
||||||
return sb.to_string();
|
|
||||||
}
|
}
|
||||||
|
|
||||||
void CArgsParser::print_usage() const
|
void CArgsParser::add_positional_argument(Arg&& arg)
|
||||||
{
|
{
|
||||||
printf("%s\n", get_usage().characters());
|
m_positional_args.append(move(arg));
|
||||||
|
}
|
||||||
|
|
||||||
|
void CArgsParser::add_positional_argument(const char*& value, const char* help_string, const char* name, Required required)
|
||||||
|
{
|
||||||
|
Arg arg {
|
||||||
|
help_string,
|
||||||
|
name,
|
||||||
|
required == Required::Yes ? 1 : 0,
|
||||||
|
1,
|
||||||
|
[&value](const char* s) {
|
||||||
|
value = s;
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
add_positional_argument(move(arg));
|
||||||
|
}
|
||||||
|
|
||||||
|
void CArgsParser::add_positional_argument(int& value, const char* help_string, const char* name, Required required)
|
||||||
|
{
|
||||||
|
Arg arg {
|
||||||
|
help_string,
|
||||||
|
name,
|
||||||
|
required == Required::Yes ? 1 : 0,
|
||||||
|
1,
|
||||||
|
[&value](const char* s) {
|
||||||
|
bool ok;
|
||||||
|
value = StringView(s).to_int(ok);
|
||||||
|
return ok;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
add_positional_argument(move(arg));
|
||||||
|
}
|
||||||
|
|
||||||
|
void CArgsParser::add_positional_argument(Vector<const char*>& values, const char* help_string, const char* name, Required required)
|
||||||
|
{
|
||||||
|
Arg arg {
|
||||||
|
help_string,
|
||||||
|
name,
|
||||||
|
required == Required::Yes ? 1 : 0,
|
||||||
|
INT_MAX,
|
||||||
|
[&values](const char* s) {
|
||||||
|
values.append(s);
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
add_positional_argument(move(arg));
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
/*
|
/*
|
||||||
* Copyright (c) 2018-2020, Andreas Kling <kling@serenityos.org>
|
* Copyright (c) 2020, Sergey Bugaev <bugaevc@serenityos.org>
|
||||||
* All rights reserved.
|
* All rights reserved.
|
||||||
*
|
*
|
||||||
* Redistribution and use in source and binary forms, with or without
|
* Redistribution and use in source and binary forms, with or without
|
||||||
|
|
@ -26,70 +26,60 @@
|
||||||
|
|
||||||
#pragma once
|
#pragma once
|
||||||
|
|
||||||
|
#include <AK/Function.h>
|
||||||
#include <AK/String.h>
|
#include <AK/String.h>
|
||||||
#include <AK/HashMap.h>
|
|
||||||
#include <AK/Vector.h>
|
#include <AK/Vector.h>
|
||||||
|
#include <stdio.h>
|
||||||
/*
|
|
||||||
The class ArgsParser provides a way to parse arguments by using a given list that describes the possible
|
|
||||||
types of arguments (name, description, required or not, must be followed by a value...).
|
|
||||||
Call the add_arg() functions to describe your arguments.
|
|
||||||
|
|
||||||
The class ArgsParserResult is used to manipulate the arguments (checking if an arg has been provided,
|
|
||||||
retrieve its value...). In case of error (missing required argument) an empty structure is returned as result.
|
|
||||||
*/
|
|
||||||
|
|
||||||
class CArgsParserResult {
|
|
||||||
public:
|
|
||||||
bool is_present(const String& arg_name) const;
|
|
||||||
String get(const String& arg_name) const;
|
|
||||||
const Vector<String>& get_single_values() const;
|
|
||||||
|
|
||||||
private:
|
|
||||||
HashMap<String, String> m_args;
|
|
||||||
Vector<String> m_single_values;
|
|
||||||
|
|
||||||
friend class CArgsParser;
|
|
||||||
};
|
|
||||||
|
|
||||||
class CArgsParser {
|
class CArgsParser {
|
||||||
public:
|
public:
|
||||||
CArgsParser(const String& program_name);
|
CArgsParser();
|
||||||
|
|
||||||
CArgsParserResult parse(int argc, char** argv);
|
enum class Required {
|
||||||
|
Yes,
|
||||||
|
No
|
||||||
|
};
|
||||||
|
|
||||||
void add_required_arg(const String& name, const String& description);
|
struct Option {
|
||||||
void add_required_arg(const String& name, const String& value_name, const String& description);
|
bool requires_argument { true };
|
||||||
void add_arg(const String& name, const String& description);
|
const char* help_string { nullptr };
|
||||||
void add_arg(const String& name, const String& value_name, const String& description);
|
const char* long_name { nullptr };
|
||||||
void add_single_value(const String& name);
|
char short_name { 0 };
|
||||||
void add_required_single_value(const String& name);
|
const char* value_name { nullptr };
|
||||||
String get_usage() const;
|
Function<bool(const char*)> accept_value;
|
||||||
void print_usage() const;
|
|
||||||
|
String name_for_display() const
|
||||||
|
{
|
||||||
|
if (long_name)
|
||||||
|
return String::format("--%s", long_name);
|
||||||
|
return String::format("-%c", short_name);
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
struct Arg {
|
||||||
|
const char* help_string { nullptr };
|
||||||
|
const char* name { nullptr };
|
||||||
|
int min_values { 0 };
|
||||||
|
int max_values { 1 };
|
||||||
|
Function<bool(const char*)> accept_value;
|
||||||
|
};
|
||||||
|
|
||||||
|
void parse(int argc, char** argv);
|
||||||
|
void print_usage(FILE*, const char* argv0);
|
||||||
|
|
||||||
|
void add_option(Option&&);
|
||||||
|
void add_option(bool& value, const char* help_string, const char* long_name, char short_name);
|
||||||
|
void add_option(const char*& value, const char* help_string, const char* long_name, char short_name, const char* value_name);
|
||||||
|
void add_option(int& value, const char* help_string, const char* long_name, char short_name, const char* value_name);
|
||||||
|
|
||||||
|
void add_positional_argument(Arg&&);
|
||||||
|
void add_positional_argument(const char*& value, const char* help_string, const char* name, Required required = Required::Yes);
|
||||||
|
void add_positional_argument(int& value, const char* help_string, const char* name, Required required = Required::Yes);
|
||||||
|
void add_positional_argument(Vector<const char*>& value, const char* help_string, const char* name, Required required = Required::Yes);
|
||||||
|
|
||||||
private:
|
private:
|
||||||
struct Arg {
|
Vector<Option> m_options;
|
||||||
inline Arg() {}
|
Vector<Arg> m_positional_args;
|
||||||
Arg(const String& name, const String& description, bool required);
|
|
||||||
Arg(const String& name, const String& value_name, const String& description, bool required);
|
|
||||||
|
|
||||||
String name;
|
bool m_show_help { false };
|
||||||
String description;
|
|
||||||
String value_name;
|
|
||||||
bool required;
|
|
||||||
};
|
|
||||||
|
|
||||||
int parse_next_param(int index, char** argv, const int params_left, CArgsParserResult& res);
|
|
||||||
bool is_param_valid(const String& param_name);
|
|
||||||
bool check_required_args(const CArgsParserResult& res);
|
|
||||||
|
|
||||||
String m_program_name;
|
|
||||||
String m_prefix;
|
|
||||||
|
|
||||||
struct SingleArg {
|
|
||||||
String name;
|
|
||||||
bool required;
|
|
||||||
};
|
|
||||||
Vector<SingleArg> m_single_args;
|
|
||||||
HashMap<String, Arg> m_args;
|
|
||||||
};
|
};
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue