The GOptions class manages command-line options and switches. More...

#include <goptions.h>

Collaboration diagram for GOptions:

Public Member Functions
	GOptions ()
	Default constructor.

	GOptions (std::string name)
	Constructor for verbosity and debug options.

	GOptions (int argc, char *argv[], const GOptions &user_defined_options=GOptions())
	Library–based constructor.

	~GOptions ()

void	defineSwitch (const std::string &name, const std::string &description)
	Defines and adds a command–line switch.

void	defineOption (const GVariable &gvar, const std::string &help)
	Defines and adds a scalar option.

void	defineOption (const std::string &name, const std::string &description, const std::vector< GVariable > &gvars, const std::string &help)
	Defines and adds a structured (map/sequence) option.

int	getScalarInt (const std::string &tag) const
	Retrieves the value of a scalar integer option.

double	getScalarDouble (const std::string &tag) const
	Retrieves the value of a scalar double option.

std::string	getScalarString (const std::string &tag) const
	Retrieves the value of a scalar string option.

bool	getSwitch (const std::string &tag) const
	Retrieves the status of a switch.

YAML::Node	getOptionNode (const std::string &tag) const
	Retrieves the YAML node for the specified option.

YAML::Node	getOptionMapInNode (const std::string &option_name, const std::string &map_key) const
	Retrieves a map option’s value from within a YAML node.

int	getVerbosityFor (const std::string &tag) const
	Retrieves the verbosity level for the specified tag.

int	getDebugFor (const std::string &tag) const
	Retrieves the debug level for the specified tag.

const std::vector< GOption > &	getOptions () const
	Returns the list of defined options.

const std::map< std::string, GSwitch > &	getSwitches () const
	Returns the map of defined switches.

void	addGOptions (const GOptions &src)
	Adds options from another GOptions object.

void	addOptionTitle (const std::string &name)

template<typename T >
T	get_variable_in_option (const YAML::Node &node, const std::string &variable_name, const T &default_value)
	Retrieves a variable from a YAML node within an option.

std::vector< std::string >	getYamlFiles () const
	Retrieves the list of YAML file paths.

bool	doesOptionExist (const std::string &tag) const
	Checks if the specified option exists.

Data Fields
std::string	option_verbosity_name {UNINITIALIZEDSTRINGQUANTITY}

std::vector< GVariable >	option_verbosity_names

Detailed Description

This class provides methods to define, access, and manage configuration options and switches for command-line applications. Options can be scalar or sequence-based and are stored in YAML format.

Definition at line 24 of file goptions.h.

Constructor & Destructor Documentation

◆ GOptions() [1/3]

GOptions::GOptions ( )

inline

Creates an empty GOptions object, typically used for defining user–defined options.

Definition at line 31 of file goptions.h.

◆ GOptions() [2/3]

GOptions::GOptions ( std::string name )

inlineexplicit

Parameters

name	verbosity and debug option name

Definition at line 39 of file goptions.h.

◆ GOptions() [3/3]

GOptions::GOptions	(	int	argc,
		char *	argv[],
		const GOptions &	user_defined_options = GOptions() )

Constructs a GOptions object.

Constructs a GOptions object by initializing built–in options and switches, loading user-defined options, parsing YAML files, and processing command line arguments.

Parameters

argc	Number of command–line arguments.
argv	Array of command–line argument strings.
user_defined_options	A GOptions object containing user–defined options.

This constructor performs the following tasks:

Loads user-defined options.
Defines built-in options and switches.
Parses YAML configuration files.
Processes command-line arguments (supporting both YAML–style and dot–notation).
Saves the final configuration to a YAML file.

Parameters

argc	Number of command-line arguments.
argv	Array of command-line argument strings.
user_defined_options	A GOptions object containing user-defined options.

Definition at line 29 of file goptions.cc.

◆ ~GOptions()

GOptions::~GOptions ( )

inline

Definition at line 54 of file goptions.h.

Member Function Documentation

◆ addGOptions()

void GOptions::addGOptions ( const GOptions & src )

inline

Parameters

src	The GOptions object to add.

Definition at line 170 of file goptions.h.

◆ addOptionTitle()

void GOptions::addOptionTitle ( const std::string & name )

inline

Definition at line 201 of file goptions.h.

◆ defineOption() [1/2]

void GOptions::defineOption	(	const GVariable &	gvar,
		const std::string &	help )

Parameters

gvar	A GVariable representing the option.
help	Help text for the option.
gvar	The GVariable representing the option.
help	Help text for the option.

Definition at line 188 of file goptions.cc.

◆ defineOption() [2/2]

void GOptions::defineOption	(	const std::string &	name,
		const std::string &	description,
		const std::vector< GVariable > &	g_vars,
		const std::string &	help )

Defines and adds a structured option.

Parameters

name	The name of the option.
description	A summary description of the option.
gvars	A vector of GVariable objects representing the option elements.
help	Help text for the option.
name	The name of the option.
description	Summary description of the option.
g_vars	Vector of GVariable objects representing the option elements.
help	Help text for the option.

Definition at line 206 of file goptions.cc.

◆ defineSwitch()

void GOptions::defineSwitch	(	const std::string &	name,
		const std::string &	description )

Defines and adds a command-line switch.

Parameters

name	The name of the switch.
description	The description of the switch.

Definition at line 172 of file goptions.cc.

◆ doesOptionExist()

bool GOptions::doesOptionExist ( const std::string & tag ) const

Parameters

tag	The name of the option.

Returns: True if the option exists; false otherwise.

Definition at line 311 of file goptions.cc.

◆ get_variable_in_option()

template<typename T >

template bool GOptions::get_variable_in_option< bool >	(	const YAML::Node &	node,
		const std::string &	variable_name,
		const T &	default_value )

Template function to retrieve a variable from a YAML node.

Template Parameters

T	The type of the variable.

Parameters

node	The YAML node.
variable_name	The name of the variable.
default_value	The default value if the variable is not found.

Returns: The variable value.

Definition at line 454 of file goptions.cc.

◆ getDebugFor()

int GOptions::getDebugFor ( const std::string & tag ) const

Accepts values as either booleans ("true"/"false") or integers.

Parameters

tag	The name of the debug option.

Returns: The debug level as an integer.

Definition at line 494 of file goptions.cc.

◆ getOptionMapInNode()

YAML::Node GOptions::getOptionMapInNode	(	const std::string &	option_name,
		const std::string &	map_key ) const

Parameters

option_name	The name of the option.
map_key	The key within the option.

Returns: The YAML::Node corresponding to the specified map key.

Parameters

option_name	The name of the option.
map_key	The key to look up within the option.

Returns: The YAML::Node corresponding to the specified map key.

Definition at line 430 of file goptions.cc.

◆ getOptionNode()

YAML::Node GOptions::getOptionNode ( const std::string & tag ) const

inline

Parameters

tag	The name of the option.

Returns: The YAML::Node containing the option's value.

Definition at line 121 of file goptions.h.

◆ getOptions()

const std::vector< GOption > & GOptions::getOptions ( ) const

inline

Returns: A vector of GOption objects.

Definition at line 158 of file goptions.h.

◆ getScalarDouble()

double GOptions::getScalarDouble ( const std::string & tag ) const

Parameters

tag	The name of the option.

Returns: The double value.

Definition at line 239 of file goptions.cc.

◆ getScalarInt()

int GOptions::getScalarInt ( const std::string & tag ) const

Parameters

tag	The name of the option.

Returns: The integer value.

Definition at line 223 of file goptions.cc.

◆ getScalarString()

std::string GOptions::getScalarString ( const std::string & tag ) const

Parameters

tag	The name of the option.

Returns: The string value.

Definition at line 255 of file goptions.cc.

◆ getSwitch()

bool GOptions::getSwitch ( const std::string & tag ) const

Retrieves the status of the specified switch.

Parameters

tag	The name of the switch.

Returns: True if the switch is on; false otherwise.

Definition at line 412 of file goptions.cc.

◆ getSwitches()

const std::map< std::string, GSwitch > & GOptions::getSwitches ( ) const

inline

Returns: A map of switches.

Definition at line 164 of file goptions.h.

◆ getVerbosityFor()

int GOptions::getVerbosityFor ( const std::string & tag ) const

Parameters

tag	The name of the verbosity option.

Returns: The verbosity level as an integer.

Definition at line 473 of file goptions.cc.

◆ getYamlFiles()

std::vector< std::string > GOptions::getYamlFiles ( ) const

inline

Returns: A vector of YAML file paths as strings.

Definition at line 221 of file goptions.h.

Field Documentation

◆ option_verbosity_name

std::string GOptions::option_verbosity_name {UNINITIALIZEDSTRINGQUANTITY}

Definition at line 198 of file goptions.h.

◆ option_verbosity_names

std::vector<GVariable> GOptions::option_verbosity_names

Definition at line 199 of file goptions.h.

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

Public Member Functions

Data Fields

Detailed Description

Constructor & Destructor Documentation

◆ GOptions() [1/3]

◆ GOptions() [2/3]

◆ GOptions() [3/3]

◆ ~GOptions()

Member Function Documentation

◆ addGOptions()

◆ addOptionTitle()

◆ defineOption() [1/2]

◆ defineOption() [2/2]

◆ defineSwitch()

◆ doesOptionExist()

◆ get_variable_in_option()

◆ getDebugFor()

◆ getOptionMapInNode()

◆ getOptionNode()

◆ getOptions()

◆ getScalarDouble()

◆ getScalarInt()

◆ getScalarString()

◆ getSwitch()

◆ getSwitches()

◆ getVerbosityFor()

◆ getYamlFiles()

Field Documentation

◆ option_verbosity_name

◆ option_verbosity_names