21#include "StringTools.hpp"
40 std::vector<std::string> tmp =
parents;
41 tmp.emplace_back(
name);
42 return detail::join(tmp,
".");
49 std::vector<ConfigItem> items{};
53 virtual std::string
to_config(
const App *,
bool,
bool, std::string)
const = 0;
56 virtual std::vector<ConfigItem>
from_config(std::istream &)
const = 0;
60 if(item.inputs.size() == 1) {
61 return item.inputs.at(0);
63 if(item.inputs.empty()) {
66 throw ConversionError::TooManyInputsFlag(item.fullname());
70 CLI11_NODISCARD std::vector<ConfigItem>
from_file(
const std::string &name)
const {
71 std::ifstream input{name};
73 throw FileError::Missing(name);
110 to_config(
const App * ,
bool default_also,
bool write_description, std::string prefix)
const override;
112 std::vector<ConfigItem>
from_config(std::istream &input)
const override;
172using ConfigTOML = ConfigBase;
Creates a command line program, with very few defaults.
Definition App.hpp:90
This converter works with INI/TOML files; to write INI files use ConfigINI.
Definition ConfigFwd.hpp:83
std::vector< ConfigItem > from_config(std::istream &input) const override
Convert a configuration into an app.
std::string configSection
Specify the configuration section that should be used.
Definition ConfigFwd.hpp:106
ConfigBase * comment(char cchar)
Specify the configuration for comment characters.
Definition ConfigFwd.hpp:114
ConfigBase * arrayDelimiter(char aSep)
Specify the delimiter character for an array.
Definition ConfigFwd.hpp:125
ConfigBase * quoteCharacter(char qString, char literalChar)
Specify the quote characters used around strings and literal strings.
Definition ConfigFwd.hpp:135
char arraySeparator
the character used to separate elements in an array
Definition ConfigFwd.hpp:92
std::string & sectionRef()
get a reference to the configuration section
Definition ConfigFwd.hpp:151
ConfigBase * arrayBounds(char aStart, char aEnd)
Specify the start and end characters for an array.
Definition ConfigFwd.hpp:119
std::string to_config(const App *, bool default_also, bool write_description, std::string prefix) const override
Convert an app into a configuration.
ConfigBase * maxLayers(uint8_t layers)
Specify the maximum number of parents.
Definition ConfigFwd.hpp:141
CLI11_NODISCARD const std::string & section() const
get the section
Definition ConfigFwd.hpp:153
char stringQuote
the character to use around strings
Definition ConfigFwd.hpp:96
ConfigBase * section(const std::string §ionName)
specify a particular section of the configuration file to use
Definition ConfigFwd.hpp:155
ConfigBase * valueSeparator(char vSep)
Specify the delimiter between a name and value.
Definition ConfigFwd.hpp:130
uint8_t maximumLayers
the maximum number of layers to allow
Definition ConfigFwd.hpp:100
char valueDelimiter
the character used separate the name from the value
Definition ConfigFwd.hpp:94
char arrayStart
the character used to start an array '\0' is a default to not use
Definition ConfigFwd.hpp:88
char parentSeparatorChar
the separator used to separator parent layers
Definition ConfigFwd.hpp:102
CLI11_NODISCARD int16_t index() const
get the section index
Definition ConfigFwd.hpp:163
char literalQuote
the character to use around single characters and literal strings
Definition ConfigFwd.hpp:98
ConfigBase * index(int16_t sectionIndex)
specify a particular index in the section to use (-1) for all sections to use
Definition ConfigFwd.hpp:165
int16_t & indexRef()
get a reference to the configuration index
Definition ConfigFwd.hpp:161
char arrayEnd
the character used to end an array '\0' is a default to not use
Definition ConfigFwd.hpp:90
ConfigBase * parentSeparator(char sep)
Specify the separator to use for parent layers.
Definition ConfigFwd.hpp:146
int16_t configIndex
Specify the configuration index to use for arrayed sections.
Definition ConfigFwd.hpp:104
char commentChar
the character used for comments
Definition ConfigFwd.hpp:86
This class provides a converter for configuration files.
Definition ConfigFwd.hpp:47
virtual CLI11_NODISCARD std::string to_flag(const ConfigItem &item) const
Get a flag value.
Definition ConfigFwd.hpp:59
virtual std::string to_config(const App *, bool, bool, std::string) const =0
Convert an app into a configuration.
CLI11_NODISCARD std::vector< ConfigItem > from_file(const std::string &name) const
Parse a config file, throw an error (ParseError:ConfigParseError or FileError) on failure.
Definition ConfigFwd.hpp:70
virtual ~Config()=default
Virtual destructor.
virtual std::vector< ConfigItem > from_config(std::istream &) const =0
Convert a configuration into an app.
ConfigINI generates a "standard" INI compliant output.
Definition ConfigFwd.hpp:175
Holds values to load into Options.
Definition ConfigFwd.hpp:29
std::vector< std::string > inputs
Listing of inputs.
Definition ConfigFwd.hpp:36
std::string name
This is the name.
Definition ConfigFwd.hpp:34
CLI11_NODISCARD std::string fullname() const
The list of parents and name joined by ".".
Definition ConfigFwd.hpp:39
std::vector< std::string > parents
This is the list of parents.
Definition ConfigFwd.hpp:31