\autotoc
+
\section console_intro Introduction
There are three parts to the Config/console library:
commands which set their respective parameter, however the library allows commands to do much
more than just that.
+
\section console_example Example
The following example shows a \e very short summary on how to integrate the config/console
\see \ref console_testserver for a complete example application
+
\section intro_usage Access
There are several ways to access the node tree:
\see console_access
+
\section intro_nodes The node tree
The basic idea is, that the console/config library manages a directory structure of parameters
\autotoc
+
\section console_access_config Configuration support
The configuration support of the Console/Config library revolves around the ConfigSource
node used during parsing and it is also possible to restrict parsing to a command subset. See
\ref console_access_partial.
+
\subsection console_access_file Configuration files
<table class="senf fixedwidth">
and a user specific configuration file) see \ref console_access_multiple and add one (or more)
senf::console::FileConfig() source to a senf::console::ConfigBundle.
+
\subsubsection console_access_file_syntax Configuration file syntax
Configuration files are written in a simple configuration language. This language is almost
\see \ref console_parser
+
\subsection console_access_options Command line options
<table class="senf fixedwidth">
See \ref senf::console::ProgramOptions for the source specific additional parameters. These
apply to senf::console::ProgramOptions and to the senf::console::OptionsConfig() source.
+
\subsubsection console_access_options_syntax Options syntax
Command line options are primarily parsed as long-options. Long options start with '--'. Further
(Beware, that the second argument to \c alias() is \e not shell quoted).
+
\subsection console_access_root Changing the root node
When used in it's default state, parsing will always interpret all commands relative to the
selectively choose commands from the node tree which are to be made accessible for
configuration. See \ref node_tree.
+
\subsection console_access_partial Partial / incremental configuration
Another feature provided by senf::console::ConfigBundle and all helper classes is partial
important: It allows a subsystem to parse it's configuration parameters irrespective of any
links pointing to nodes of that subsystem.
+
\subsection console_access_multiple Multiple sources
Most of the time, an application will utilize multiple configuration sources: A global
order they are specified, so in this case, the command line options will override any options
specified in one of the configuration files.
+
\section console_access_console The network console
To make the network console accessible, it must be initialized when the program is started:
</pre>
\endhtmlonly
+ It is possible to start multiple server consoles by calling \c start() multiple times with
+ different ports/addresses. Each server can be configured separately (e.g. root node, mode ...).q
+
+
\subsection console_serverclient Server and Client objects
The senf::console::Server and senf::console::Client objects offer further API calls. To access
a path component will be completed automatically and transparently to the corresponding full
name.
+
\subsection console_noninteractive Non-interactive network console
After a new connection is established, the console server waits a short time for data to arrive.
\autotoc
+
\section console_cmdadd Adding commands and setting attributes
Basically, all commands are added using senf::console::DirectoryNode::add(). What exactly
To greatly simplify parsing complex commands, we turn to automatic argument parsing.
+
\subsection console_autoadd Adding
Automatically parsed commands are registered by just adding a callback which has the correct
</pre>
\endhtmlonly
+
\subsection command_overload Overloading
Automatically parsed commands can be overloaded: You can register multiple commands under the
\see senf::console::VariableAttributor for the complete attribute interface
+
\subsection console_varchange Change notification
A \e handler can be set to be called, whenever the variable is changed. It will be called with a
After this setup, \c varChanged will be called, whenever the value has changed.
- \section console_args Registering special argument types
+ \section console_args Special argument types
By default, argument types which can be read and written using \c iostreams are automatically
supported. Other types need to be registered explicitly
+ \subsection console_args_bool Boolean arguments and return values
+
+ The console library by default formats boolean values using the strings \c true and \c false for
+ their representation. When parsing a boolean value, most sensible representations will be
+ accepted:
+
+ <table class="senf">
+ <tr><td>\c true</td> <td>\c false</td> <td>\ref senf::console::formatTrueFalse</td></tr>
+ <tr><td>\c on</td> <td>\c off</td> <td>\ref senf::console::formatOnOff</td></tr>
+ <tr><td>\c enabled</td> <td>\c disabled</td> <td>\ref senf::console::formatEnabledDisabled</td></tr>
+ <tr><td>\c yes</td> <td>\c no</td> <td>\ref senf::console::formatYesNo</td></tr>
+ <tr><td><em>non-zero integer</em></td><td>\c 0</td><td>\ref senf::console::formatOneZero</td></tr>
+ </table>
+
+ The boolean parser will accept these values in any (mixed) case and accepts any unique initial
+ substring (e.g. \c Y / \c N).
+
+ The last column lists explicit formatters which can be set to customize the return value
+ formatting of a registered overload accordingly.
+
+
\subsection console_args_enum Registering enum types
Enum types are a special case, since it is not possible, to find a string representation for the
\endhtmlonly
- \subsection console_args_custom Customizing argument and return value parsing/formatting
+ \subsection console_args_custom Extending the library to support additional types
To support or customize parsing/formatting of other types, they need to be registered. In it's
simplest case, this works, by just providing an appropriate overload for
projects / senf.git / blobdiff