#pragma once // Delusions of generality, but it's really just for Klammertext commands. #include #include #include #include #include inline std::map regex_symbols { {"'text'", R"((^[^-](?:\s|.)*))" }, {"'word'", R"((([^\s]+)))" }, {"'list'", R"((^[^-]?(?:\s|.)*))" }, // {"int", R"((\d))" }, // {"ints", R"((\d[ \d]*))" }, {"'verbosity'", R"(([01234]))" }, // {"targets", R"((html|tex|pdf|txt))" }, //{"'katom_display'", R"((none ?|all ?|type ?|index ?|ignored ?|replaced ?)*)" }, {"'katom_display'", R"(( *|none|all|type|index|ignored|replaced)*)" }, }; inline std::map regex_desc { {"'verbosity'", "Verbosity during processing (0,1,2,3,4); default is 0." } }; std::regex make_regex(const std::string& key); class Arg { public: std::string symbol(); void make_regex(const std::string& key); std::string m_type {}; std::string m_name {}; std::string m_pattern {}; std::string m_rgx_symbol {}; std::regex m_rgx {}; std::string m_default_value {}; std::string m_parameter {}; std::string m_syntax {}; std::string m_desc {}; std::string m_value {}; }; std::ostream& operator<<(std::ostream& os, const Arg& arg); class Argv { public: static std::string delimiter; void flag(const std::string& name, const std::string& desc); void req(const std::string& name, const std::string& desc, const std::string& regex_pattern="'text'"); void opt(const std::string& name, const std::string& desc="", const std::string& parameter="", const std::string& default_value="", const std::string& regex_pattern="text"); // A variadic option: --name collects every following word up to the // next -/-- token (zero or more). get(name) returns the words // space-joined; given(name) distinguishes "--name with no words" // from an absent --name. Used for subcommand-style interfaces // (kdesc --font install ). void var(const std::string& name, const std::string& desc); void update_width(Arg arg); void check_flags_and_options(std::string command, std::vector& words); void parse_flags(std::vector& words, std::map& named_args); void parse_optional(std::vector& words, std::map& named_args); void parse_vars(std::vector& words, std::map& named_args); // True when the named variadic option appeared on the command line // (even with no following words). bool given(const std::string& name) { return m_given.contains(name); }; void parse_positional( std::string command, // std::vector words, std::string pos_args, std::map& named_args); std::map classify_arguments(int argc, char* argv[], bool full_parse=true); void check_required( const std::vector& req_args, const std::string& command_name); void check_flags(const std::map& arg_map, const std::string& command_name); void parse(int argc, char* argv[], bool full_parse=true); std::string get(const std::string& name, bool missing_is_error=true); bool as_bool(const std::string& name); int as_int(const std::string& name); int as_integer_range(const std::string& name, int low, int high); int as_verbosity(const std::string& name); std::string as_string(const std::string& name); std::vector as_vector(const std::string& name); std::pair> as_input(const std::string& name, bool allow_empty=false); void usage_line(Arg arg); void usage(const std::string& command_name); void describe(); // void describe(Argv original); bool is_flag(std::string name) { return std::ranges::count(m_flag_names, name) > 0; } bool is_opt(std::string name) { return std::ranges::count(m_opt_names, name) > 0; } std::string m_command {}; std::map m_args {}; std::vector m_names {}; std::vector m_req_names {}; std::vector m_flag_names {}; std::vector m_opt_names {}; std::vector m_var_names {}; std::set m_given {}; std::vector m_hyphen_markers {}; // Original argv word boundaries for multi-word arguments (the single // positional list and variadic --name options). as_vector() returns // these, so a shell-quoted filename containing spaces stays one // element; the space-joined m_value remains only for get()/describe(). std::map> m_vectors {}; long unsigned int m_syntax_size = 0; };