mxlib
c++ tools for analyzing astronomical data and other tasks by Jared R. Males. [git repo]
Loading...
Searching...
No Matches
appConfigurator.hpp
Go to the documentation of this file.
1/** \file appConfigurator.hpp
2 * \author Jared R. Males
3 * \brief An application configuration manager
4 *
5 * \ingroup mxApp_files
6 *
7 */
8
9//***********************************************************************//
10// Copyright 2015, 2016, 2017, 2018 Jared R. Males (jaredmales@gmail.com)
11//
12// This file is part of mxlib.
13//
14// mxlib is free software: you can redistribute it and/or modify
15// it under the terms of the GNU General Public License as published by
16// the Free Software Foundation, either version 3 of the License, or
17// (at your option) any later version.
18//
19// mxlib is distributed in the hope that it will be useful,
20// but WITHOUT ANY WARRANTY; without even the implied warranty of
21// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
22// GNU General Public License for more details.
23//
24// You should have received a copy of the GNU General Public License
25// along with mxlib. If not, see <http://www.gnu.org/licenses/>.
26//***********************************************************************//
27
28#ifndef app_appConfigurator_hpp
29#define app_appConfigurator_hpp
30
31#include <list>
32#include <fstream>
33
34#include "../mxError.hpp"
35
36#include "clOptions.hpp"
37#include "iniFile.hpp"
38#include "configTarget.hpp"
39
40namespace mx
41{
42namespace app
43{
44
45/// Class to manage a set of configurable values, and read their values from config/ini files and the command line.
46/**
47 * The configuration files are TOML/ini-style, with sections. That is
48 \verbatim
49 key1=value1
50 key2=value2
51
52 [section1]
53 key3=value3
54 key4=value4,value4.1, value4.2, value4.3
55
56 [section2]
57 key3=value5
58 key3=value5.1
59 key4=value6_over_
60 multiple_lines
61
62 \endverbatim
63 * such that section1.key3 is distinct from section2.key3 (they must have different config-target names though).
64 *
65 * Additional syntax rules:
66 * - Leading whitespace is stripped from the value, so `key=val` and `key= val` are equivalent.
67 * - Additional entries within one file with the same section and key are appended to the previous entry.
68 * So the value of section2.key3 is "value5value5.1".
69 * - Multi-line values are handled such that in the above example the result is key4=value6_over_multiple_lines.
70 * - Vectors are input as comma separated lists, as in section1.key4 above. Leading whitespace is stripped from each
71 * component of the vector.
72 *
73 * \todo add handling of += in subsequent files.
74 * \todo should just swith to strict TOML
75 *
76 * The command line parser handles both short-opt ("-h -vArg -n Arg") and long-opt ("--help --value=Arg --number=Arg")
77 styles.
78 *
79 *
80 * \bug a config=value pair listed in a conf file twice seems to cause a failure, even if they are the same value.
81 *
82 * \ingroup mxApp
83 *
84 */
85struct appConfigurator
86{
87 /// Iterator for the targets unordered_map
88 typedef std::unordered_map<std::string, configTarget>::iterator targetIterator;
89
90 /// Iterator for the clOnlyTargets list.
91 typedef std::list<configTarget>::iterator clOnlyTargetIterator;
92
93 /// The targets are stored in an unordered_map for fast access by key.
94 std::unordered_map<std::string, configTarget> m_targets;
95
96 /// Config file entries present in the file(s), but not corresponding to a target when parsed. Set aside for
97 /// possible analysis.
98 std::unordered_map<std::string, configTarget> m_unusedConfigs;
99
100 /// Targets which are only for the command line are stored separately in a list.
101 std::list<configTarget> clOnlyTargets;
102
103 /// Non-option arguments from the command line.
104 std::vector<std::string> nonOptions;
105
106 /// Running count of options added, used to track order.
107 int nAdded{ 0 };
108
109 /// Flag controlling whether or not to record config sources
110 bool m_sources{ false };
111
112 /// Clear the containers and free up the associated memory.
113 void clear();
114
115 /// Add a configTarget
116 /** Note that if name is a duplicate but the section and keyword are empty, it is handled as command-line only.
117 */
118 void add( const configTarget &tgt /**< [in] The configuration target to add */ );
119
120 /// Add a configTarget
121 /**
122 * \overload
123 */
124 void add( const std::string &n, /**< [in] The name of the target */
125 const std::string &so, /**< [in] The command-line short option (e.g. "f" for -f) */
126 const std::string &lo, /**< [in] The command-line long option (e.g. "file" for --file) */
127 int clt, /**< [in] The command-line option type, argType::false,
128 argType::true, argType::optional, argType::required */
129 const std::string &s, /**< [in] The config file section name, can be empty "" */
130 const std::string &kw, /**< [in] The config file keyword, read in a "keyword=value" pair */
131 bool isReq = false, /**< [in] Whether or not this option is required to be set */
132 const std::string &ht = "", /**< [in] The type to display in the help message */
133 const std::string &he = "" /**< [in] The explanation to display in the help message */
134 );
135
136 /// Parse the command line, updating the targets
137 void parseCommandLine( int argc, /**< [in] standard command line result specifying number
138 of argumetns in argv */
139 char **argv, /**< [in] standard command line result containing the
140 arguments. */
141 const std::string &oneTarget = "" /**< [in] [optional] if not empty, then only this target
142 is extracted by the parser. */
143 );
144
145 /// Read and parse a config/ini file, updating the targets
146 /** \todo handle += here, by appending to the last value as if a vector.
147 */
148 int readConfig( const std::string &fname, ///< [in] the config file name
149 bool reportFileNotFound = true ///< [in] [optiona] control whether a file not found is reported.
150 );
151
152 /// Check if a target has been set by the configuration
153 /**
154 * \returns true if the configuration set at least one value for this target
155 * \returns false if no value was set.
156 */
157 bool isSet( const std::string &name, ///< [in] the target name
158 std::unordered_map<std::string, configTarget> &targets ///< [in] the map of config targets to use
159 );
160
161 /// Check if a target has been set by the configuration
162 /**
163 * \overload
164 *
165 * \returns true if the configuration set at least one value for this target
166 * \returns false if no value was set.
167 */
168 bool isSet( const std::string &name /**< [in] the target name */ );
169
170 /// Get the number of different values set for the specified config target
171 /**
172 * \returns the number of different values set for name.
173 */
174 int count( const std::string &name, ///< [in] the target name
175 std::unordered_map<std::string, configTarget> &targets ///< [in] the map of config targets to use
176 );
177
178 /// Get the number of different values set for the specified config target
179 /**
180 * \overload
181 *
182 * \returns the number of different values set for name.
183 */
184 int count( const std::string &name /**< [in] the target name */ );
185
186 /// Get the command line verbosity count for this option.
187 /** E.g., -v ==> 1, -vv ==> 2, -vvv ==> 3, etc. Note that for this to work
188 * properly, this must be of type mx::argType::True.
189 *
190 * \returns the verbosity count.
191 */
192 int verbosity( const std::string &name, ///< [in] the target name
193 std::unordered_map<std::string, configTarget> &targets ///< [in] the map of config targets to use
194 );
195
196 /// Get the command line verbosity count for this option.
197 /** E.g., -v ==> 1, -vv ==> 2, -vvv ==> 3, etc. Note that for this to work
198 * properly, this must be of type mx::argType::True.
199 *
200 * \overload
201 *
202 * \returns the verbosity count.
203 */
204 int verbosity( const std::string &name /**< [in] the target name */ );
205
206 /// Get the i-th value of the target, converted to the specified type
207 /** The supplied value is only altered if the config target was set, which preserves.
208 * default values.
209 *
210 * \retval 0 on success
211 * \retval -1 on error
212 */
213 template <typename typeT>
214 int get( typeT &v, ///< [out] the variable to store the value in, unaltered if not set.
215 const std::string &name, ///< [in] the config target name
216 size_t i, ///< [in] the number of config specification to get.
217 std::unordered_map<std::string, configTarget> &targets ///< [in] the map of config targets to use
218 );
219
220 /// Get the i-th value of the target from the used set, converted to the specified type
221 /** The supplied value is only altered if the config target was set, which preserves.
222 * default values.
223 *
224 * \overload
225 *
226 * \retval 0 on success
227 * \retval -1 on error
228 */
229 template <typename typeT>
230 int get( typeT &v, ///< [out] the variable to store the value in
231 const std::string &name, ///< [in] the config target name
232 size_t i ///< [in] the number of config specification to get.
233 );
234
235 /// Get the final value of the target, converted to the specified type
236 /** The supplied value is only altered if the config target was set, which preserves.
237 * default values.
238 *
239 * \overload
240 *
241 * \retval 0 on success.
242 * \retval -1 on error.
243 */
244 template <typename typeT>
245 int get( typeT &v, ///< [out] the variable to store the value in
246 const std::string &name, ///< [in] the config target name
247 std::unordered_map<std::string, configTarget> &targets ///< [in] the map of config targets to use
248 );
249
250 /// Get the final value of the target from the used set, converted to the specified type
251 /** The supplied value is only altered if the config target was set, which preserves.
252 * default values.
253 *
254 * \overload
255 *
256 * \retval 0 on success.
257 * \retval -1 on error.
258 */
259 template <typename typeT>
260 int get( typeT &v, ///< [out] the variable to store the value in
261 const std::string &name ///< [in] the config target name
262 );
263
264 /// Get the i-th value of the target, converted to the specified config target
265 /** The vector is only populated if the config target was set. If it is populated,
266 * it is cleared first. Thus if a vector filled with default values is passed
267 * in, it will only be overwritten if the user specified new values.
268 *
269 * \returns 0 on success
270 * \returns -1 on error
271 */
272 template <typename typeT>
273 int get( std::vector<typeT> &v, ///< [out] the vector to populate
274 const std::string &name, ///< [in] the config target name.
275 size_t i, ///< [in] the number of config specification to get.
276 std::unordered_map<std::string, configTarget> &targets ///< [in] the map of config targets to use
277 );
278
279 /// Get the i-th value of the target, converted to the specified config target
280 /** The vector is only populated if the config target was set. If it is populated,
281 * it is cleared first. Thus if a vector filled with default values is passed
282 * in, it will only be overwritten if the user specified new values.
283 *
284 * \returns 0 on success
285 * \returns -1 on error
286 */
287 template <typename typeT>
288 int get( std::vector<typeT> &v, ///< [out] the vector to populate
289 const std::string &name, ///< [in] the config target name.
290 size_t i ///< [in] the number of config specification to get.
291 );
292
293 /// Get the i-th value of the target as a vector containing the specified type.
294 /** The vector is only populated if the config target was set. If it is populated,
295 * it is cleared first. Thus if a vector filled with default values is passed
296 * in, it will only be overwritten if the user specified new values.
297 *
298 * \retval 0 on success.
299 * \retval -1 on error.
300 */
301 template <typename typeT>
302 int get( std::vector<typeT> &v, ///< [out] the vector to populate
303 const std::string &name, ///< [in] the config target name.
304 std::unordered_map<std::string, configTarget> &targets ///< [in] the map of config targets to use
305 );
306
307 /// Get the final value of the target in the used set, as a vector containing the specified type.
308 /** The vector is only populated if the config target was set. If it is populated,
309 * it is cleared first. Thus if a vector filled with default values is passed
310 * in, it will only be overwritten if the user specified new values.
311 *
312 * \retval 0 on success.
313 * \retval -1 on error.
314 */
315 template <typename typeT>
316 int get( std::vector<typeT> &v, ///< [out] the vector to populate
317 const std::string &name ///< [in] the config target name.
318 );
319
320 /// Access operator, configures a value by calling get.
321 /**
322 * \retval 0 on success
323 * \retval -1 on error
324 */
325 template <typename typeT>
326 int
327 operator()( typeT &v, ///< [out] the variable to populate (either scalar or vector), will be unaltered if not set.
328 const std::string &name ///< [in] the config target name.
329 );
330
331 /// Configure a value from the unused map, using the iniFile key.
332 /**
333 * \retval 0 on success
334 * \retval -1 on error
335 */
336 template <typename typeT>
337 int
338 configUnused( typeT &v, ///< [out] the variable to populate (either scalar or vector), will be unaltered if not set.
339 const std::string &key ///< [in] the iniFile key for this target.
340 );
341
342 /// Configure a value from the unused map, using the section and keyword.
343 /**
344 * \retval 0 on success
345 * \retval -1 on error
346 */
347 template <typename typeT>
348 int
349 configUnused( typeT &v, ///< [out] the variable to populate (either scalar or vector), will be unaltered if not set.
350 const std::string &section, ///< [in] the section name for this target
351 const std::string &keyword ///< [in] the keyword for this target.
352 );
353
354 /// Get the unique sections in the unused config targets.
355 /**
356 * \retval 0 on success
357 * \retval -1 on error
358 */
359 int unusedSections( std::vector<std::string> &sections );
360
361 /// Check if a target has been set in the unused configuration
362 /**
363 * \returns true if the unused configuration set at least one value for this target
364 * \returns false if no value was set.
365 */
366 int isSetUnused( const std::string &name /**< [in] the target name */ );
367
368 /// Call an external logging function whenever a config value is accessed by get or operator().
369 /** Only called if this is not a nullptr (the default), otherwise no logging or reporting is done.
370 */
371 void ( *configLog )(
372 const std::string &name, ///< [in] The name of the config target.
373 const int &code, ///< [in] The type code from mx::typeDescription
374 const std::string &valueStr, ///< [in] The value in its string form as found in the configuration
375 const std::string &source ///< [in] The source of the value, either default, command line, or a path.
376 ){ nullptr };
377
378 /// Get the number of unknown options found during config processing.
379 int numUnknownOptions();
380};
381
382template <typename typeT>
383int appConfigurator::get( typeT &v,
384 const std::string &name,
385 size_t i,
386 std::unordered_map<std::string, configTarget> &targets )
387{
388 targets[name].used = true; // This means this was checked.
389
390 if( !isSet( name, targets ) )
391 {
392 if( configLog )
393 {
394 configLog( name, meta::typeDescription<typeT>::code(), ioutils::convertToString( v ), "default" );
395 }
396
397 return 0;
398 }
399
400 if( targets[name].values.size() <= i )
401 {
402 return -1;
403 }
404
405 v = ioutils::convertFromString<typeT>( targets[name].values[i] );
406
407 // Log it here.
408 if( configLog )
409 {
410 if( m_sources )
411 {
412 configLog( name, meta::typeDescription<typeT>::code(), targets[name].values[i], targets[name].sources[i] );
413 }
414 else
415 {
416 configLog( name, meta::typeDescription<typeT>::code(), targets[name].values[i], "" );
417 }
418 }
419
420 return 0;
421}
422// explicits
423extern template int appConfigurator::get<char>( char &v,
424 const std::string &name,
425 size_t i,
426 std::unordered_map<std::string, configTarget> &targets );
427
428extern template int appConfigurator::get<signed char>( signed char &v,
429 const std::string &name,
430 size_t i,
431 std::unordered_map<std::string, configTarget> &targets );
432
433extern template int appConfigurator::get<short>( short &v,
434 const std::string &name,
435 size_t i,
436 std::unordered_map<std::string, configTarget> &targets );
437
438extern template int appConfigurator::get<int>( int &v,
439 const std::string &name,
440 size_t i,
441 std::unordered_map<std::string, configTarget> &targets );
442
443extern template int appConfigurator::get<long>( long &v,
444 const std::string &name,
445 size_t i,
446 std::unordered_map<std::string, configTarget> &targets );
447
448extern template int appConfigurator::get<long long>( long long &v,
449 const std::string &name,
450 size_t i,
451 std::unordered_map<std::string, configTarget> &targets );
452
453extern template int appConfigurator::get<unsigned char>( unsigned char &v,
454 const std::string &name,
455 size_t i,
456 std::unordered_map<std::string, configTarget> &targets );
457
458extern template int appConfigurator::get<unsigned short>( unsigned short &v,
459 const std::string &name,
460 size_t i,
461 std::unordered_map<std::string, configTarget> &targets );
462
463extern template int appConfigurator::get<unsigned int>( unsigned int &v,
464 const std::string &name,
465 size_t i,
466 std::unordered_map<std::string, configTarget> &targets );
467
468extern template int appConfigurator::get<unsigned long>( unsigned long &v,
469 const std::string &name,
470 size_t i,
471 std::unordered_map<std::string, configTarget> &targets );
472
473extern template int appConfigurator::get<unsigned long long>( unsigned long long &v,
474 const std::string &name,
475 size_t i,
476 std::unordered_map<std::string, configTarget> &targets );
477
478extern template int appConfigurator::get<float>( float &v,
479 const std::string &name,
480 size_t i,
481 std::unordered_map<std::string, configTarget> &targets );
482
483extern template int appConfigurator::get<double>( double &v,
484 const std::string &name,
485 size_t i,
486 std::unordered_map<std::string, configTarget> &targets );
487
488extern template int appConfigurator::get<long double>( long double &v,
489 const std::string &name,
490 size_t i,
491 std::unordered_map<std::string, configTarget> &targets );
492
493#ifdef HASQUAD
494extern template int appConfigurator::get<__float128>( __float128 &v,
495 const std::string &name,
496 size_t i,
497 std::unordered_map<std::string, configTarget> &targets );
498#endif
499
500extern template int appConfigurator::get<bool>( bool &v,
501 const std::string &name,
502 size_t i,
503 std::unordered_map<std::string, configTarget> &targets );
504
505extern template int appConfigurator::get<std::string>( std::string &v,
506 const std::string &name,
507 size_t i,
508 std::unordered_map<std::string, configTarget> &targets );
509
510//+++++++++++++++++++++++++++++++++++++
511
512template <typename typeT>
513int appConfigurator::get( typeT &v, const std::string &name, size_t i )
514{
515 return get( v, name, i, m_targets );
516}
517
518// explicits
519extern template int appConfigurator::get<char>( char &v, const std::string &name, size_t i );
520
521extern template int appConfigurator::get<signed char>( signed char &v, const std::string &name, size_t i );
522
523extern template int appConfigurator::get<short>( short &v, const std::string &name, size_t i );
524
525extern template int appConfigurator::get<int>( int &v, const std::string &name, size_t i );
526
527extern template int appConfigurator::get<long>( long &v, const std::string &name, size_t i );
528
529extern template int appConfigurator::get<long long>( long long &v, const std::string &name, size_t i );
530
531extern template int appConfigurator::get<unsigned char>( unsigned char &v, const std::string &name, size_t i );
532
533extern template int appConfigurator::get<unsigned short>( unsigned short &v, const std::string &name, size_t i );
534
535extern template int appConfigurator::get<unsigned int>( unsigned int &v, const std::string &name, size_t i );
536
537extern template int appConfigurator::get<unsigned long>( unsigned long &v, const std::string &name, size_t i );
538
539extern template int
540appConfigurator::get<unsigned long long>( unsigned long long &v, const std::string &name, size_t i );
541
542extern template int appConfigurator::get<float>( float &v, const std::string &name, size_t i );
543
544extern template int appConfigurator::get<double>( double &v, const std::string &name, size_t i );
545
546extern template int appConfigurator::get<long double>( long double &v, const std::string &name, size_t i );
547
548#ifdef HASQUAD
549extern template int appConfigurator::get<__float128>( __float128 &v, const std::string &name, size_t i );
550#endif
551
552extern template int appConfigurator::get<bool>( bool &v, const std::string &name, size_t i );
553
554extern template int appConfigurator::get<std::string>( std::string &v, const std::string &name, size_t i );
555
556//+++++++++++++++++++++++++++++++++++++
557
558template <typename typeT>
559int appConfigurator::get( typeT &v, const std::string &name, std::unordered_map<std::string, configTarget> &targets )
560{
561 targets[name].used = true; // This means this was checked.
562
563 if( !isSet( name, targets ) )
564 {
565 if( configLog )
566 {
567 configLog( name, meta::typeDescription<typeT>::code(), ioutils::convertToString( v ), "default" );
568 }
569
570 return 0;
571 }
572
573 int i = targets[name].values.size() - 1;
574
575 if( i < 0 )
576 return -1;
577
578 return get( v, name, i, targets );
579}
580// explicits:
581
582extern template int
583appConfigurator::get<char>( char &v, const std::string &name, std::unordered_map<std::string, configTarget> &targets );
584
585extern template int appConfigurator::get<signed char>( signed char &v,
586 const std::string &name,
587 std::unordered_map<std::string, configTarget> &targets );
588
589extern template int appConfigurator::get<short>( short &v,
590 const std::string &name,
591 std::unordered_map<std::string, configTarget> &targets );
592
593extern template int
594appConfigurator::get<int>( int &v, const std::string &name, std::unordered_map<std::string, configTarget> &targets );
595
596extern template int
597appConfigurator::get<long>( long &v, const std::string &name, std::unordered_map<std::string, configTarget> &targets );
598
599extern template int appConfigurator::get<long long>( long long &v,
600 const std::string &name,
601 std::unordered_map<std::string, configTarget> &targets );
602
603extern template int appConfigurator::get<unsigned char>( unsigned char &v,
604 const std::string &name,
605 std::unordered_map<std::string, configTarget> &targets );
606
607extern template int appConfigurator::get<unsigned short>( unsigned short &v,
608 const std::string &name,
609 std::unordered_map<std::string, configTarget> &targets );
610
611extern template int appConfigurator::get<unsigned int>( unsigned int &v,
612 const std::string &name,
613 std::unordered_map<std::string, configTarget> &targets );
614
615extern template int appConfigurator::get<unsigned long>( unsigned long &v,
616 const std::string &name,
617 std::unordered_map<std::string, configTarget> &targets );
618
619extern template int appConfigurator::get<unsigned long long>( unsigned long long &v,
620 const std::string &name,
621 std::unordered_map<std::string, configTarget> &targets );
622
623extern template int appConfigurator::get<float>( float &v,
624 const std::string &name,
625 std::unordered_map<std::string, configTarget> &targets );
626
627extern template int appConfigurator::get<double>( double &v,
628 const std::string &name,
629 std::unordered_map<std::string, configTarget> &targets );
630
631extern template int appConfigurator::get<long double>( long double &v,
632 const std::string &name,
633 std::unordered_map<std::string, configTarget> &targets );
634
635#ifdef HASQUAD
636extern template int appConfigurator::get<__float128>( __float128 &v,
637 const std::string &name,
638 std::unordered_map<std::string, configTarget> &targets );
639#endif
640
641extern template int
642appConfigurator::get<bool>( bool &v, const std::string &name, std::unordered_map<std::string, configTarget> &targets );
643
644extern template int appConfigurator::get<std::string>( std::string &v,
645 const std::string &name,
646 std::unordered_map<std::string, configTarget> &targets );
647
648//+++++++++++++++++++++++++++++++++++++
649
650template <typename typeT>
651int appConfigurator::get( typeT &v, const std::string &name )
652{
653 return get( v, name, m_targets );
654}
655// explicits:
656
657extern template int appConfigurator::get<char>( char &v, const std::string &name );
658
659extern template int appConfigurator::get<signed char>( signed char &v, const std::string &name );
660
661extern template int appConfigurator::get<short>( short &v, const std::string &name );
662
663extern template int appConfigurator::get<int>( int &v, const std::string &name );
664
665extern template int appConfigurator::get<long>( long &v, const std::string &name );
666
667extern template int appConfigurator::get<long long>( long long &v, const std::string &name );
668
669extern template int appConfigurator::get<unsigned char>( unsigned char &v, const std::string &name );
670
671extern template int appConfigurator::get<unsigned short>( unsigned short &v, const std::string &name );
672
673extern template int appConfigurator::get<unsigned int>( unsigned int &v, const std::string &name );
674
675extern template int appConfigurator::get<unsigned long>( unsigned long &v, const std::string &name );
676
677extern template int appConfigurator::get<unsigned long long>( unsigned long long &v, const std::string &name );
678
679extern template int appConfigurator::get<float>( float &v, const std::string &name );
680
681extern template int appConfigurator::get<double>( double &v, const std::string &name );
682
683extern template int appConfigurator::get<long double>( long double &v, const std::string &name );
684
685#ifdef HASQUAD
686extern template int appConfigurator::get<__float128>( __float128 &v, const std::string &name );
687#endif
688
689extern template int appConfigurator::get<bool>( bool &v, const std::string &name );
690
691extern template int appConfigurator::get<std::string>( std::string &v, const std::string &name );
692
693//+++++++++++++++++++++++++++++++++++++
694template <typename typeT>
695int appConfigurator::get( std::vector<typeT> &v,
696 const std::string &name,
697 size_t i,
698 std::unordered_map<std::string, configTarget> &targets )
699{
700 targets[name].used = true; // This means this was checked.
701
702 if( !isSet( name, targets ) )
703 {
704 if( configLog )
705 {
706 configLog( name, meta::typeDescription<typeT>::code(), "[need a vector to string]", "default" );
707 }
708
709 return 0;
710 }
711
712 if( targets[name].values.size() <= i )
713 return -1;
714
715 std::string s;
716
717 s = ioutils::convertFromString<std::string>( targets[name].values[i] );
718
719 // if( get<std::string>(s, name, i, targets) < 0) return -1;
720
721 // Case that s was set to be empty.
722 if( s.size() == 0 )
723 {
724 if( configLog )
725 {
726 if( m_sources )
727 {
728 configLog( name, meta::typeDescription<typeT>::code(), "", targets[name].sources[i] );
729 }
730 else
731 {
732 configLog( name, meta::typeDescription<typeT>::code(), "", "" );
733 }
734 }
735
736 v.clear(); // We clear the vector passed as default
737 return 0;
738 }
739
740 size_t st;
741 size_t com;
742
743 st = 0;
744
745 while( ::isspace( s[st] ) && st < s.size() - 1 )
746 ++st;
747
748 com = s.find( ',', st );
749
750 v.clear();
751
752 while( com != std::string::npos )
753 {
754 v.push_back( ioutils::convertFromString<typeT>( s.substr( st, com - st ) ) );
755 st = com + 1;
756 while( ::isspace( s[st] ) && st < s.size() - 1 )
757 ++st;
758
759 com = s.find( ',', st );
760 }
761 v.push_back( ioutils::convertFromString<typeT>( s.substr( st, s.size() - st ) ) );
762
763 // Log it here.
764 if( configLog )
765 {
766 if( m_sources )
767 {
768 configLog( name, meta::typeDescription<typeT>::code(), targets[name].values[i], targets[name].sources[i] );
769 }
770 else
771 {
772 configLog( name, meta::typeDescription<typeT>::code(), targets[name].values[i], "" );
773 }
774 }
775
776 return 0;
777}
778// explicits:
779
780extern template int appConfigurator::get<char>( std::vector<char> &v,
781 const std::string &name,
782 size_t i,
783 std::unordered_map<std::string, configTarget> &targets );
784
785extern template int appConfigurator::get<signed char>( std::vector<signed char> &v,
786 const std::string &name,
787 size_t i,
788 std::unordered_map<std::string, configTarget> &targets );
789
790extern template int appConfigurator::get<short>( std::vector<short> &v,
791 const std::string &name,
792 size_t i,
793 std::unordered_map<std::string, configTarget> &targets );
794
795extern template int appConfigurator::get<int>( std::vector<int> &v,
796 const std::string &name,
797 size_t i,
798 std::unordered_map<std::string, configTarget> &targets );
799
800extern template int appConfigurator::get<long>( std::vector<long> &v,
801 const std::string &name,
802 size_t i,
803 std::unordered_map<std::string, configTarget> &targets );
804
805extern template int appConfigurator::get<long long>( std::vector<long long> &v,
806 const std::string &name,
807 size_t i,
808 std::unordered_map<std::string, configTarget> &targets );
809
810extern template int appConfigurator::get<unsigned char>( std::vector<unsigned char> &v,
811 const std::string &name,
812 size_t i,
813 std::unordered_map<std::string, configTarget> &targets );
814
815extern template int appConfigurator::get<unsigned short>( std::vector<unsigned short> &v,
816 const std::string &name,
817 size_t i,
818 std::unordered_map<std::string, configTarget> &targets );
819
820extern template int appConfigurator::get<unsigned int>( std::vector<unsigned int> &v,
821 const std::string &name,
822 size_t i,
823 std::unordered_map<std::string, configTarget> &targets );
824
825extern template int appConfigurator::get<unsigned long>( std::vector<unsigned long> &v,
826 const std::string &name,
827 size_t i,
828 std::unordered_map<std::string, configTarget> &targets );
829
830extern template int appConfigurator::get<unsigned long long>( std::vector<unsigned long long> &v,
831 const std::string &name,
832 size_t i,
833 std::unordered_map<std::string, configTarget> &targets );
834
835extern template int appConfigurator::get<float>( std::vector<float> &v,
836 const std::string &name,
837 size_t i,
838 std::unordered_map<std::string, configTarget> &targets );
839
840extern template int appConfigurator::get<double>( std::vector<double> &v,
841 const std::string &name,
842 size_t i,
843 std::unordered_map<std::string, configTarget> &targets );
844
845extern template int appConfigurator::get<long double>( std::vector<long double> &v,
846 const std::string &name,
847 size_t i,
848 std::unordered_map<std::string, configTarget> &targets );
849
850#ifdef HASQUAD
851extern template int appConfigurator::get<__float128>( std::vector<__float128> &v,
852 const std::string &name,
853 size_t i,
854 std::unordered_map<std::string, configTarget> &targets );
855#endif
856
857extern template int appConfigurator::get<bool>( std::vector<bool> &v,
858 const std::string &name,
859 size_t i,
860 std::unordered_map<std::string, configTarget> &targets );
861
862extern template int appConfigurator::get<std::string>( std::vector<std::string> &v,
863 const std::string &name,
864 size_t i,
865 std::unordered_map<std::string, configTarget> &targets );
866
867//+++++++++++++++++++++++++++++++++++++
868
869template <typename typeT>
870int appConfigurator::get( std::vector<typeT> &v, const std::string &name, size_t i )
871{
872 return get( v, name, i, m_targets );
873}
874
875// explicits:
876
877extern template int appConfigurator::get<char>( std::vector<char> &v, const std::string &name, size_t i );
878
879extern template int appConfigurator::get<signed char>( std::vector<signed char> &v, const std::string &name, size_t i );
880
881extern template int appConfigurator::get<short>( std::vector<short> &v, const std::string &name, size_t i );
882
883extern template int appConfigurator::get<int>( std::vector<int> &v, const std::string &name, size_t i );
884
885extern template int appConfigurator::get<long>( std::vector<long> &v, const std::string &name, size_t i );
886
887extern template int appConfigurator::get<long long>( std::vector<long long> &v, const std::string &name, size_t i );
888
889extern template int
890appConfigurator::get<unsigned char>( std::vector<unsigned char> &v, const std::string &name, size_t i );
891
892extern template int
893appConfigurator::get<unsigned short>( std::vector<unsigned short> &v, const std::string &name, size_t i );
894
895extern template int
896appConfigurator::get<unsigned int>( std::vector<unsigned int> &v, const std::string &name, size_t i );
897
898extern template int
899appConfigurator::get<unsigned long>( std::vector<unsigned long> &v, const std::string &name, size_t i );
900
901extern template int
902appConfigurator::get<unsigned long long>( std::vector<unsigned long long> &v, const std::string &name, size_t i );
903
904extern template int appConfigurator::get<float>( std::vector<float> &v, const std::string &name, size_t i );
905
906extern template int appConfigurator::get<double>( std::vector<double> &v, const std::string &name, size_t i );
907
908extern template int appConfigurator::get<long double>( std::vector<long double> &v, const std::string &name, size_t i );
909
910#ifdef HASQUAD
911extern template int appConfigurator::get<__float128>( std::vector<__float128> &v, const std::string &name, size_t i );
912#endif
913
914extern template int appConfigurator::get<bool>( std::vector<bool> &v, const std::string &name, size_t i );
915
916extern template int appConfigurator::get<std::string>( std::vector<std::string> &v, const std::string &name, size_t i );
917
918//+++++++++++++++++++++++++++++++++++++
919template <typename typeT>
920int appConfigurator::get( std::vector<typeT> &v,
921 const std::string &name,
922 std::unordered_map<std::string, configTarget> &targets )
923{
924 targets[name].used = true; // This means this was checked.
925
926 if( !isSet( name, targets ) )
927 {
928 if( configLog )
929 {
930 configLog( name, meta::typeDescription<typeT>::code(), "[need a vector to string]", "default" );
931 }
932 return 0;
933 }
934 int i = targets[name].values.size() - 1;
935
936 if( i < 0 )
937 return -1;
938
939 return get( v, name, i, targets );
940}
941// explicits:
942
943extern template int appConfigurator::get<char>( std::vector<char> &v,
944 const std::string &name,
945 std::unordered_map<std::string, configTarget> &targets );
946
947extern template int appConfigurator::get<signed char>( std::vector<signed char> &v,
948 const std::string &name,
949 std::unordered_map<std::string, configTarget> &targets );
950
951extern template int appConfigurator::get<short>( std::vector<short> &v,
952 const std::string &name,
953 std::unordered_map<std::string, configTarget> &targets );
954
955extern template int appConfigurator::get<int>( std::vector<int> &v,
956 const std::string &name,
957 std::unordered_map<std::string, configTarget> &targets );
958
959extern template int appConfigurator::get<long>( std::vector<long> &v,
960 const std::string &name,
961 std::unordered_map<std::string, configTarget> &targets );
962
963extern template int appConfigurator::get<long long>( std::vector<long long> &v,
964 const std::string &name,
965 std::unordered_map<std::string, configTarget> &targets );
966
967extern template int appConfigurator::get<unsigned char>( std::vector<unsigned char> &v,
968 const std::string &name,
969 std::unordered_map<std::string, configTarget> &targets );
970
971extern template int appConfigurator::get<unsigned short>( std::vector<unsigned short> &v,
972 const std::string &name,
973 std::unordered_map<std::string, configTarget> &targets );
974
975extern template int appConfigurator::get<unsigned int>( std::vector<unsigned int> &v,
976 const std::string &name,
977 std::unordered_map<std::string, configTarget> &targets );
978
979extern template int appConfigurator::get<unsigned long>( std::vector<unsigned long> &v,
980 const std::string &name,
981 std::unordered_map<std::string, configTarget> &targets );
982
983extern template int appConfigurator::get<unsigned long long>( std::vector<unsigned long long> &v,
984 const std::string &name,
985 std::unordered_map<std::string, configTarget> &targets );
986
987extern template int appConfigurator::get<float>( std::vector<float> &v,
988 const std::string &name,
989 std::unordered_map<std::string, configTarget> &targets );
990
991extern template int appConfigurator::get<double>( std::vector<double> &v,
992 const std::string &name,
993 std::unordered_map<std::string, configTarget> &targets );
994
995extern template int appConfigurator::get<long double>( std::vector<long double> &v,
996 const std::string &name,
997 std::unordered_map<std::string, configTarget> &targets );
998
999#ifdef HASQUAD
1000extern template int appConfigurator::get<__float128>( std::vector<__float128> &v,
1001 const std::string &name,
1002 std::unordered_map<std::string, configTarget> &targets );
1003#endif
1004
1005extern template int appConfigurator::get<bool>( std::vector<bool> &v,
1006 const std::string &name,
1007 std::unordered_map<std::string, configTarget> &targets );
1008
1009extern template int appConfigurator::get<std::string>( std::vector<std::string> &v,
1010 const std::string &name,
1011 std::unordered_map<std::string, configTarget> &targets );
1012
1013//+++++++++++++++++++++++++++++++++++++
1014
1015template <typename typeT>
1016int appConfigurator::get( std::vector<typeT> &v, const std::string &name )
1017{
1018 return get( v, name, m_targets );
1019}
1020// explicits:
1021
1022extern template int appConfigurator::get<char>( std::vector<char> &v, const std::string &name );
1023
1024extern template int appConfigurator::get<signed char>( std::vector<signed char> &v, const std::string &name );
1025
1026extern template int appConfigurator::get<short>( std::vector<short> &v, const std::string &name );
1027
1028extern template int appConfigurator::get<int>( std::vector<int> &v, const std::string &name );
1029
1030extern template int appConfigurator::get<long>( std::vector<long> &v, const std::string &name );
1031
1032extern template int appConfigurator::get<long long>( std::vector<long long> &v, const std::string &name );
1033
1034extern template int appConfigurator::get<unsigned char>( std::vector<unsigned char> &v, const std::string &name );
1035
1036extern template int appConfigurator::get<unsigned short>( std::vector<unsigned short> &v, const std::string &name );
1037
1038extern template int appConfigurator::get<unsigned int>( std::vector<unsigned int> &v, const std::string &name );
1039
1040extern template int appConfigurator::get<unsigned long>( std::vector<unsigned long> &v, const std::string &name );
1041
1042extern template int appConfigurator::get<unsigned long long>( std::vector<unsigned long long> &v,
1043 const std::string &name );
1044
1045extern template int appConfigurator::get<float>( std::vector<float> &v, const std::string &name );
1046
1047extern template int appConfigurator::get<double>( std::vector<double> &v, const std::string &name );
1048
1049extern template int appConfigurator::get<long double>( std::vector<long double> &v, const std::string &name );
1050
1051#ifdef HASQUAD
1052extern template int appConfigurator::get<__float128>( std::vector<__float128> &v, const std::string &name );
1053#endif
1054
1055extern template int appConfigurator::get<bool>( std::vector<bool> &v, const std::string &name );
1056
1057extern template int appConfigurator::get<std::string>( std::vector<std::string> &v, const std::string &name );
1058
1059//+++++++++++++++++++++++++++++++++++++
1060
1061template <typename typeT>
1062int appConfigurator::operator()( typeT &v, const std::string &name )
1063{
1064 return get( v, name, m_targets );
1065}
1066
1067// explicits:
1068
1069extern template int appConfigurator::operator()<char>( char &v, const std::string &name );
1070
1071extern template int appConfigurator::operator()<signed char>( signed char &v, const std::string &name );
1072
1073extern template int appConfigurator::operator()<short>( short &v, const std::string &name );
1074
1075extern template int appConfigurator::operator()<int>( int &v, const std::string &name );
1076
1077extern template int appConfigurator::operator()<long>( long &v, const std::string &name );
1078
1079extern template int appConfigurator::operator()<long long>( long long &v, const std::string &name );
1080
1081extern template int appConfigurator::operator()<unsigned char>( unsigned char &v, const std::string &name );
1082
1083extern template int appConfigurator::operator()<unsigned short>( unsigned short &v, const std::string &name );
1084
1085extern template int appConfigurator::operator()<unsigned int>( unsigned int &v, const std::string &name );
1086
1087extern template int appConfigurator::operator()<unsigned long>( unsigned long &v, const std::string &name );
1088
1089extern template int appConfigurator::operator()<unsigned long long>( unsigned long long &v, const std::string &name );
1090
1091extern template int appConfigurator::operator()<float>( float &v, const std::string &name );
1092
1093extern template int appConfigurator::operator()<double>( double &v, const std::string &name );
1094
1095extern template int appConfigurator::operator()<long double>( long double &v, const std::string &name );
1096
1097#ifdef HASQUAD
1098extern template int appConfigurator::operator()<__float128>( __float128 &v, const std::string &name );
1099#endif
1100
1101extern template int appConfigurator::operator()<bool>( bool &v, const std::string &name );
1102
1103extern template int appConfigurator::operator()<std::string>( std::string &v, const std::string &name );
1104
1105//+++++++++++++++++++++++++++++++++++++
1106
1107template <typename typeT>
1108int appConfigurator::configUnused( typeT &v, const std::string &key )
1109{
1110 return get( v, key, m_unusedConfigs );
1111}
1112
1113extern template int appConfigurator::configUnused<char>( char &v, const std::string &key );
1114
1115extern template int appConfigurator::configUnused<signed char>( signed char &v, const std::string &key );
1116
1117extern template int appConfigurator::configUnused<short>( short &v, const std::string &key );
1118
1119extern template int appConfigurator::configUnused<int>( int &v, const std::string &key );
1120
1121extern template int appConfigurator::configUnused<long>( long &v, const std::string &key );
1122
1123extern template int appConfigurator::configUnused<long long>( long long &v, const std::string &key );
1124
1125extern template int appConfigurator::configUnused<unsigned char>( unsigned char &v, const std::string &key );
1126
1127extern template int appConfigurator::configUnused<unsigned short>( unsigned short &v, const std::string &key );
1128
1129extern template int appConfigurator::configUnused<unsigned int>( unsigned int &v, const std::string &key );
1130
1131extern template int appConfigurator::configUnused<unsigned long>( unsigned long &v, const std::string &key );
1132
1133extern template int appConfigurator::configUnused<unsigned long long>( unsigned long long &v, const std::string &key );
1134
1135extern template int appConfigurator::configUnused<float>( float &v, const std::string &key );
1136
1137extern template int appConfigurator::configUnused<double>( double &v, const std::string &key );
1138
1139extern template int appConfigurator::configUnused<long double>( long double &v, const std::string &key );
1140
1141#ifdef HASQUAD
1142extern template int appConfigurator::configUnused<__float128>( __float128 &v, const std::string &key );
1143#endif
1144
1145extern template int appConfigurator::configUnused<bool>( bool &v, const std::string &key );
1146
1147extern template int appConfigurator::configUnused<std::string>( std::string &v, const std::string &key );
1148//+++++++++++++++++++++++++++++++++++++
1149
1150template <typename typeT>
1151int appConfigurator::configUnused( typeT &v, const std::string &section, const std::string &keyword )
1152{
1153 return configUnused( v, iniFile::makeKey( section, keyword ) );
1154}
1155
1156extern template int
1157appConfigurator::configUnused<char>( char &v, const std::string &section, const std::string &keyword );
1158
1159extern template int
1160appConfigurator::configUnused<signed char>( signed char &v, const std::string &section, const std::string &keyword );
1161
1162extern template int
1163appConfigurator::configUnused<short>( short &v, const std::string &section, const std::string &keyword );
1164
1165extern template int
1166appConfigurator::configUnused<int>( int &v, const std::string &section, const std::string &keyword );
1167
1168extern template int
1169appConfigurator::configUnused<long>( long &v, const std::string &section, const std::string &keyword );
1170
1171extern template int
1172appConfigurator::configUnused<long long>( long long &v, const std::string &section, const std::string &keyword );
1173
1174extern template int appConfigurator::configUnused<unsigned char>( unsigned char &v,
1175 const std::string &section,
1176 const std::string &keyword );
1177
1178extern template int appConfigurator::configUnused<unsigned short>( unsigned short &v,
1179 const std::string &section,
1180 const std::string &keyword );
1181
1182extern template int
1183appConfigurator::configUnused<unsigned int>( unsigned int &v, const std::string &section, const std::string &keyword );
1184
1185extern template int appConfigurator::configUnused<unsigned long>( unsigned long &v,
1186 const std::string &section,
1187 const std::string &keyword );
1188
1189extern template int appConfigurator::configUnused<unsigned long long>( unsigned long long &v,
1190 const std::string &section,
1191 const std::string &keyword );
1192
1193extern template int
1194appConfigurator::configUnused<float>( float &v, const std::string &section, const std::string &keyword );
1195
1196extern template int
1197appConfigurator::configUnused<double>( double &v, const std::string &section, const std::string &keyword );
1198
1199extern template int
1200appConfigurator::configUnused<long double>( long double &v, const std::string &section, const std::string &keyword );
1201
1202#ifdef HASQUAD
1203extern template int
1204appConfigurator::configUnused<__float128>( __float128 &v, const std::string &section, const std::string &keyword );
1205#endif
1206
1207extern template int
1208appConfigurator::configUnused<bool>( bool &v, const std::string &section, const std::string &keyword );
1209
1210extern template int
1211appConfigurator::configUnused<std::string>( std::string &v, const std::string &section, const std::string &keyword );
1212
1213//+++++++++++++++++++++++++++++++++++++
1214
1215/// A simple config file writing function, useful for testing.
1216/** Write a config file to the path specified by `fname`. Each of the parameters
1217 * is a vector, and each component is required of each vector.
1218 *
1219 * Example:
1220 *\code
1221 writeConfigFile( "/tmp/test.conf", {"", "", "sect1", "sect1", "sect2", "sect2"},
1222 {"key0", "key1", "key2", "key3", "key4", "key5"},
1223 {"val0", "val1", "val2", "val3", "val4", "val5"} );
1224
1225 *\endcode
1226 *results in the file `/tmp/test.conf' containing
1227 * \verbatim
1228 key0=val0
1229 key1=val1
1230
1231 [sect1]
1232 key2=val2
1233 key3=val3
1234
1235 [sect2]
1236 key4=val4
1237 key5=val5
1238
1239 * \endverbatim
1240 *
1241 * No error checking is done.
1242 */
1243void writeConfigFile( const std::string &fname, ///< [in] the complete path for the output file.
1244 const std::vector<std::string> &sections, ///< [in] sections, one per config value
1245 const std::vector<std::string> &keywords, ///< [in] keywords, one per config value
1246 const std::vector<std::string> &values ///< [in] the values
1247);
1248
1249} // namespace app
1250} // namespace mx
1251
1252#endif // app_appConfigurator_hpp
mx::app::writeConfigFile
void writeConfigFile(const std::string &fname, const std::vector< std::string > &sections, const std::vector< std::string > &keywords, const std::vector< std::string > &values)
A simple config file writing function, useful for testing.
Definition appConfigurator.cpp:892
clOptions.hpp
A command line parser.
configTarget.hpp
Targets for the configuration manager, and utiltities.
mx::ioutils::convertToString
std::string convertToString(const typeT &value, int precision=0)
Convert a numerical value to a string.
Definition stringUtils.hpp:83
iniFile.hpp
Declares and defines an ini-style (toml) file parser.
mx
The mxlib c++ namespace.
Definition mxError.hpp:106
mx::app::appConfigurator
Class to manage a set of configurable values, and read their values from config/ini files and the com...
Definition appConfigurator.hpp:86
mx::app::appConfigurator::m_targets
std::unordered_map< std::string, configTarget > m_targets
The targets are stored in an unordered_map for fast access by key.
Definition appConfigurator.hpp:94
mx::app::appConfigurator::readConfig
int readConfig(const std::string &fname, bool reportFileNotFound=true)
Read and parse a config/ini file, updating the targets.
Definition appConfigurator.cpp:149
mx::app::appConfigurator::operator()
int operator()(typeT &v, const std::string &name)
Access operator, configures a value by calling get.
Definition appConfigurator.hpp:1062
mx::app::appConfigurator::add
void add(const configTarget &tgt)
Add a configTarget.
Definition appConfigurator.cpp:43
mx::app::appConfigurator::m_sources
bool m_sources
Flag controlling whether or not to record config sources.
Definition appConfigurator.hpp:110
mx::app::appConfigurator::get
int get(typeT &v, const std::string &name, size_t i, std::unordered_map< std::string, configTarget > &targets)
Get the i-th value of the target, converted to the specified type.
Definition appConfigurator.hpp:383
mx::app::appConfigurator::nonOptions
std::vector< std::string > nonOptions
Non-option arguments from the command line.
Definition appConfigurator.hpp:104
mx::app::appConfigurator::configUnused
int configUnused(typeT &v, const std::string &key)
Configure a value from the unused map, using the iniFile key.
Definition appConfigurator.hpp:1108
mx::app::appConfigurator::configLog
void(* configLog)(const std::string &name, const int &code, const std::string &valueStr, const std::string &source)
Call an external logging function whenever a config value is accessed by get or operator().
Definition appConfigurator.hpp:371
mx::app::appConfigurator::verbosity
int verbosity(const std::string &name, std::unordered_map< std::string, configTarget > &targets)
Get the command line verbosity count for this option.
Definition appConfigurator.cpp:246
mx::app::appConfigurator::targetIterator
std::unordered_map< std::string, configTarget >::iterator targetIterator
Iterator for the targets unordered_map.
Definition appConfigurator.hpp:88
mx::app::appConfigurator::isSetUnused
int isSetUnused(const std::string &name)
Check if a target has been set in the unused configuration.
Definition appConfigurator.cpp:887
mx::app::appConfigurator::isSet
bool isSet(const std::string &name, std::unordered_map< std::string, configTarget > &targets)
Check if a target has been set by the configuration.
Definition appConfigurator.cpp:220
mx::app::appConfigurator::clear
void clear()
Clear the containers and free up the associated memory.
Definition appConfigurator.cpp:35
mx::app::appConfigurator::unusedSections
int unusedSections(std::vector< std::string > &sections)
Get the unique sections in the unused config targets.
Definition appConfigurator.cpp:858
mx::app::appConfigurator::numUnknownOptions
int numUnknownOptions()
Get the number of unknown options found during config processing.
mx::app::appConfigurator::clOnlyTargets
std::list< configTarget > clOnlyTargets
Targets which are only for the command line are stored separately in a list.
Definition appConfigurator.hpp:101
mx::app::appConfigurator::count
int count(const std::string &name, std::unordered_map< std::string, configTarget > &targets)
Get the number of different values set for the specified config target.
Definition appConfigurator.cpp:235
mx::app::appConfigurator::parseCommandLine
void parseCommandLine(int argc, char **argv, const std::string &oneTarget="")
Parse the command line, updating the targets.
Definition appConfigurator.cpp:74
mx::app::appConfigurator::nAdded
int nAdded
Running count of options added, used to track order.
Definition appConfigurator.hpp:107
mx::app::appConfigurator::m_unusedConfigs
std::unordered_map< std::string, configTarget > m_unusedConfigs
Definition appConfigurator.hpp:98
mx::app::appConfigurator::clOnlyTargetIterator
std::list< configTarget >::iterator clOnlyTargetIterator
Iterator for the clOnlyTargets list.
Definition appConfigurator.hpp:91
mx::app::configTarget
A configuration target.
Definition configTarget.hpp:53
mx::app::iniFile::makeKey
static std::string makeKey(const std::string &section, const std::string &name)
Return a key generated from the section and name.
Definition iniFile.hpp:57
mx::meta::typeDescription
Struct which contains static members describing a type.
Definition typeDescription.hpp:43