#include <wpi/util/argparse.hpp>

Classes
class	MutuallyExclusiveGroup

Public Member Functions
	ArgumentParser (std::string program_name={}, std::string version="1.0", default_arguments add_args=default_arguments::all, bool exit_on_default_arguments=true, std::ostream &os=std::cout)
	~ArgumentParser ()=default
	ArgumentParser (const ArgumentParser &other)=delete
ArgumentParser &	operator= (const ArgumentParser &other)=delete
	ArgumentParser (ArgumentParser &&) noexcept=delete
ArgumentParser &	operator= (ArgumentParser &&)=delete
	operator bool () const
template<typename... Targs>
Argument &	add_argument (Targs... f_args)
MutuallyExclusiveGroup &	add_mutually_exclusive_group (bool required=false)
template<typename... Targs>
ArgumentParser &	add_parents (const Targs &... f_args)
ArgumentParser &	add_usage_newline ()
ArgumentParser &	add_group (std::string group_name)
ArgumentParser &	add_description (std::string description)
ArgumentParser &	add_epilog (std::string epilog)
ArgumentParser &	add_hidden_alias_for (Argument &arg, std::string_view alias)
template<typename T = Argument>
T &	at (std::string_view name)
ArgumentParser &	set_prefix_chars (std::string prefix_chars)
ArgumentParser &	set_assign_chars (std::string assign_chars)
void	parse_args (const std::vector< std::string > &arguments)
std::vector< std::string >	parse_known_args (const std::vector< std::string > &arguments)
void	parse_args (int argc, const char *const argv[])
auto	parse_known_args (int argc, const char *const argv[])
template<typename T = std::string>
T	get (std::string_view arg_name) const
template<typename T = std::string>
auto	present (std::string_view arg_name) const -> std::optional< T >
auto	is_used (std::string_view arg_name) const
auto	is_subcommand_used (std::string_view subcommand_name) const
auto	is_subcommand_used (const ArgumentParser &subparser) const
Argument &	operator[] (std::string_view arg_name) const
auto	help () const -> std::stringstream
ArgumentParser &	set_usage_max_line_width (size_t w)
ArgumentParser &	set_usage_break_on_mutex ()
auto	usage () const -> std::string
std::string	print_help () const
void	add_subparser (ArgumentParser &parser)
void	set_suppress (bool suppress)

Protected Types
using	argument_it = std::list<Argument>::iterator
using	mutex_group_it = std::vector<MutuallyExclusiveGroup>::iterator
using	argument_parser_it

Protected Member Functions
const MutuallyExclusiveGroup *	get_belonging_mutex (const Argument *arg) const
bool	is_valid_prefix_char (char c) const
char	get_any_valid_prefix_char () const
std::vector< std::string >	preprocess_arguments (const std::vector< std::string > &raw_arguments) const
void	parse_args_internal (const std::vector< std::string > &raw_arguments)
std::vector< std::string >	parse_known_args_internal (const std::vector< std::string > &raw_arguments)
std::size_t	get_length_of_longest_argument () const
void	index_argument (argument_it it)

Protected Attributes
std::string	m_program_name
std::string	m_version
std::string	m_description
std::string	m_epilog
bool	m_exit_on_default_arguments = true
std::string	m_prefix_chars {"-"}
std::string	m_assign_chars {"="}
bool	m_is_parsed = false
std::list< Argument >	m_positional_arguments
std::list< Argument >	m_optional_arguments
std::map< std::string, argument_it >	m_argument_map
std::string	m_parser_path
std::list< std::reference_wrapper< ArgumentParser > >	m_subparsers
std::map< std::string, argument_parser_it >	m_subparser_map
std::map< std::string, bool >	m_subparser_used
std::vector< MutuallyExclusiveGroup >	m_mutually_exclusive_groups
bool	m_suppress = false
std::size_t	m_usage_max_line_width = (std::numeric_limits<std::size_t>::max)()
bool	m_usage_break_on_mutex = false
int	m_usage_newline_counter = 0
std::vector< std::string >	m_group_names

Friends
auto	operator<< (std::ostream &stream, const ArgumentParser &parser) -> std::ostream &

Member Typedef Documentation

◆ argument_it

using wpi::util::ArgumentParser::argument_it = std::list<Argument>::iterator

protected

◆ argument_parser_it

using wpi::util::ArgumentParser::argument_parser_it

protected

Initial value:

std::list<std::reference_wrapper<ArgumentParser>>::iterator

◆ mutex_group_it

using wpi::util::ArgumentParser::mutex_group_it = std::vector<MutuallyExclusiveGroup>::iterator

protected

Constructor & Destructor Documentation

◆ ArgumentParser() [1/3]

wpi::util::ArgumentParser::ArgumentParser	(	std::string	program_name = {},
		std::string	version = "1.0",
		default_arguments	add_args = default_arguments::all,
		bool	exit_on_default_arguments = true,
		std::ostream &	os = std::cout )

inlineexplicit

◆ ~ArgumentParser()

wpi::util::ArgumentParser::~ArgumentParser ( )

default

◆ ArgumentParser() [2/3]

wpi::util::ArgumentParser::ArgumentParser ( const ArgumentParser & other )

delete

◆ ArgumentParser() [3/3]

wpi::util::ArgumentParser::ArgumentParser ( ArgumentParser && )

deletenoexcept

Member Function Documentation

◆ add_argument()

template<typename... Targs>

Argument & wpi::util::ArgumentParser::add_argument ( Targs... f_args )

inline

◆ add_description()

ArgumentParser & wpi::util::ArgumentParser::add_description ( std::string description )

inline

◆ add_epilog()

ArgumentParser & wpi::util::ArgumentParser::add_epilog ( std::string epilog )

inline

◆ add_group()

ArgumentParser & wpi::util::ArgumentParser::add_group ( std::string group_name )

inline

◆ add_hidden_alias_for()

ArgumentParser & wpi::util::ArgumentParser::add_hidden_alias_for	(	Argument &	arg,
		std::string_view	alias )

inline

◆ add_mutually_exclusive_group()

MutuallyExclusiveGroup & wpi::util::ArgumentParser::add_mutually_exclusive_group ( bool required = false )

inline

◆ add_parents()

template<typename... Targs>

ArgumentParser & wpi::util::ArgumentParser::add_parents ( const Targs &... f_args )

inline

◆ add_subparser()

void wpi::util::ArgumentParser::add_subparser ( ArgumentParser & parser )

inline

◆ add_usage_newline()

ArgumentParser & wpi::util::ArgumentParser::add_usage_newline ( )

inline

◆ at()

template<typename T = Argument>

T & wpi::util::ArgumentParser::at ( std::string_view name )

inline

◆ get()

template<typename T = std::string>

T wpi::util::ArgumentParser::get ( std::string_view arg_name ) const

inline

◆ get_any_valid_prefix_char()

char wpi::util::ArgumentParser::get_any_valid_prefix_char ( ) const

inlineprotected

◆ get_belonging_mutex()

const MutuallyExclusiveGroup * wpi::util::ArgumentParser::get_belonging_mutex ( const Argument * arg ) const

inlineprotected

◆ get_length_of_longest_argument()

std::size_t wpi::util::ArgumentParser::get_length_of_longest_argument ( ) const

inlineprotected

◆ help()

auto wpi::util::ArgumentParser::help ( ) const->std::stringstream

inline

◆ index_argument()

void wpi::util::ArgumentParser::index_argument ( argument_it it )

inlineprotected

◆ is_subcommand_used() [1/2]

auto wpi::util::ArgumentParser::is_subcommand_used ( const ArgumentParser & subparser ) const

inline

◆ is_subcommand_used() [2/2]

auto wpi::util::ArgumentParser::is_subcommand_used ( std::string_view subcommand_name ) const

inline

◆ is_used()

auto wpi::util::ArgumentParser::is_used ( std::string_view arg_name ) const

inline

◆ is_valid_prefix_char()

bool wpi::util::ArgumentParser::is_valid_prefix_char ( char c ) const

inlineprotected

◆ operator bool()

wpi::util::ArgumentParser::operator bool ( ) const

inlineexplicit

◆ operator=() [1/2]

ArgumentParser & wpi::util::ArgumentParser::operator= ( ArgumentParser && )

delete

◆ operator=() [2/2]

ArgumentParser & wpi::util::ArgumentParser::operator= ( const ArgumentParser & other )

delete

◆ operator[]()

Argument & wpi::util::ArgumentParser::operator[] ( std::string_view arg_name ) const

inline

◆ parse_args() [1/2]

void wpi::util::ArgumentParser::parse_args ( const std::vector< std::string > & arguments )

inline

◆ parse_args() [2/2]

void wpi::util::ArgumentParser::parse_args	(	int	argc,
		const char *const	argv[] )

inline

◆ parse_args_internal()

void wpi::util::ArgumentParser::parse_args_internal ( const std::vector< std::string > & raw_arguments )

inlineprotected

◆ parse_known_args() [1/2]

std::vector< std::string > wpi::util::ArgumentParser::parse_known_args ( const std::vector< std::string > & arguments )

inline

◆ parse_known_args() [2/2]

auto wpi::util::ArgumentParser::parse_known_args	(	int	argc,
		const char *const	argv[] )

inline

◆ parse_known_args_internal()

std::vector< std::string > wpi::util::ArgumentParser::parse_known_args_internal ( const std::vector< std::string > & raw_arguments )

inlineprotected

◆ preprocess_arguments()

std::vector< std::string > wpi::util::ArgumentParser::preprocess_arguments ( const std::vector< std::string > & raw_arguments ) const

inlineprotected

◆ present()

template<typename T = std::string>

auto wpi::util::ArgumentParser::present ( std::string_view arg_name ) const->std::optional< T >

inline

◆ print_help()

std::string wpi::util::ArgumentParser::print_help ( ) const

inline

◆ set_assign_chars()

ArgumentParser & wpi::util::ArgumentParser::set_assign_chars ( std::string assign_chars )

inline

◆ set_prefix_chars()

ArgumentParser & wpi::util::ArgumentParser::set_prefix_chars ( std::string prefix_chars )

inline

◆ set_suppress()

void wpi::util::ArgumentParser::set_suppress ( bool suppress )

inline

◆ set_usage_break_on_mutex()

ArgumentParser & wpi::util::ArgumentParser::set_usage_break_on_mutex ( )

inline

◆ set_usage_max_line_width()

ArgumentParser & wpi::util::ArgumentParser::set_usage_max_line_width ( size_t w )

inline

◆ usage()

auto wpi::util::ArgumentParser::usage ( ) const->std::string

inline

◆ operator<<

auto operator<<	(	std::ostream &	stream,
		const ArgumentParser &	parser )->std::ostream &

friend

Member Data Documentation

◆ m_argument_map

std::map<std::string, argument_it> wpi::util::ArgumentParser::m_argument_map

protected

◆ m_assign_chars

std::string wpi::util::ArgumentParser::m_assign_chars {"="}

protected

◆ m_description

std::string wpi::util::ArgumentParser::m_description

protected

◆ m_epilog

std::string wpi::util::ArgumentParser::m_epilog

protected

◆ m_exit_on_default_arguments

bool wpi::util::ArgumentParser::m_exit_on_default_arguments = true

protected

◆ m_group_names

std::vector<std::string> wpi::util::ArgumentParser::m_group_names

protected

◆ m_is_parsed

bool wpi::util::ArgumentParser::m_is_parsed = false

protected

◆ m_mutually_exclusive_groups

std::vector<MutuallyExclusiveGroup> wpi::util::ArgumentParser::m_mutually_exclusive_groups

protected

◆ m_optional_arguments

std::list<Argument> wpi::util::ArgumentParser::m_optional_arguments

protected

◆ m_parser_path

std::string wpi::util::ArgumentParser::m_parser_path

protected

◆ m_positional_arguments

std::list<Argument> wpi::util::ArgumentParser::m_positional_arguments

protected

◆ m_prefix_chars

std::string wpi::util::ArgumentParser::m_prefix_chars {"-"}

protected

◆ m_program_name

std::string wpi::util::ArgumentParser::m_program_name

protected

◆ m_subparser_map

std::map<std::string, argument_parser_it> wpi::util::ArgumentParser::m_subparser_map

protected

◆ m_subparser_used

std::map<std::string, bool> wpi::util::ArgumentParser::m_subparser_used

protected

◆ m_subparsers

std::list<std::reference_wrapper<ArgumentParser> > wpi::util::ArgumentParser::m_subparsers

protected

◆ m_suppress

bool wpi::util::ArgumentParser::m_suppress = false

protected

◆ m_usage_break_on_mutex

bool wpi::util::ArgumentParser::m_usage_break_on_mutex = false

protected

◆ m_usage_max_line_width

std::size_t wpi::util::ArgumentParser::m_usage_max_line_width = (std::numeric_limits<std::size_t>::max)()

protected

◆ m_usage_newline_counter

int wpi::util::ArgumentParser::m_usage_newline_counter = 0

protected

◆ m_version

std::string wpi::util::ArgumentParser::m_version

protected

The documentation for this class was generated from the following file:

wpi/util/argparse.hpp

Classes

Public Member Functions

Protected Types

Protected Member Functions

Protected Attributes

Friends

Member Typedef Documentation

◆ argument_it

◆ argument_parser_it

◆ mutex_group_it

Constructor & Destructor Documentation

◆ ArgumentParser() [1/3]

◆ ~ArgumentParser()

◆ ArgumentParser() [2/3]

◆ ArgumentParser() [3/3]

Member Function Documentation

◆ add_argument()

◆ add_description()

◆ add_epilog()

◆ add_group()

◆ add_hidden_alias_for()

◆ add_mutually_exclusive_group()

◆ add_parents()

◆ add_subparser()

◆ add_usage_newline()

◆ at()

◆ get()

◆ get_any_valid_prefix_char()

◆ get_belonging_mutex()

◆ get_length_of_longest_argument()

◆ help()

◆ index_argument()

◆ is_subcommand_used() [1/2]

◆ is_subcommand_used() [2/2]

◆ is_used()

◆ is_valid_prefix_char()

◆ operator bool()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ operator[]()

◆ parse_args() [1/2]

◆ parse_args() [2/2]

◆ parse_args_internal()

◆ parse_known_args() [1/2]

◆ parse_known_args() [2/2]

◆ parse_known_args_internal()

◆ preprocess_arguments()

◆ present()

◆ print_help()

◆ set_assign_chars()

◆ set_prefix_chars()

◆ set_suppress()

◆ set_usage_break_on_mutex()

◆ set_usage_max_line_width()

◆ usage()

Friends And Related Symbol Documentation

◆ operator<<

Member Data Documentation

◆ m_argument_map

◆ m_assign_chars

◆ m_description

◆ m_epilog

◆ m_exit_on_default_arguments

◆ m_group_names

◆ m_is_parsed

◆ m_mutually_exclusive_groups

◆ m_optional_arguments

◆ m_parser_path

◆ m_positional_arguments

◆ m_prefix_chars

◆ m_program_name

◆ m_subparser_map

◆ m_subparser_used

◆ m_subparsers

◆ m_suppress

◆ m_usage_break_on_mutex

◆ m_usage_max_line_width

◆ m_usage_newline_counter

◆ m_version