Software Open Access

CLIUtils/CLI11: ## Version 2.2: Option and Configuration Flexibility

Henry Schreiner; Philip Top; Christoph Bachhuber; Marcus Brinkmann; Jonas Nilsson; Doug Johnston; Lucas Czech; Rafi Wiener; Andreas Deininger; Andrew Hardin; Daniel Mensinger; Jesus Briales; Sam Hocevar; Sean Fisk; fpeng1985; ayum; Alex Dewar; Anton; Benjamin Beichler; D. Fleury; Dan Barowy; Dominik Steinberger; Eli Schwartz; Fred Helmesjö; Isabella Muerte; Jakob Lover; James Gerity

New features include support for output of an empty vector, a summing option policy that can be applied more broadly, and an option to validate optional arguments to discriminate from positional arguments. A new validator to check for files on a default path is included to allow one or more default paths for configuration files or other file arguments. A number of bug fixes and code cleanup for various build configurations. Clean up of some error outputs and extension of existing capability to new types or situations.

There is a possible minor breaking change in behavior of certain types which wrapped an integer, such as std::atomic<int> or std::optional<int> when used in a flag. The default behavior is now as a single argument value vs. summing all the arguments. The default summing behavior is now restricted to pure integral types, int64_t, int, uint32_t, etc. Use the new sum multi option policy to revert to the older behavior. The summing behavior on wrapper types was not originally intended.

  • Add MultiOptionPolicy::Sum and refactor the add_flag to fix a bug when using std::optional<bool> as type. #709
  • Add support for an empty vector result in TOML and as a default string. #660
  • Add .validate_optional_arguments() to support discriminating positional arguments from vector option arguments. #668
  • Add CLI::FileOnDefaultPath to check for files on a specified default path. #698
  • Change default value display in help messages from =XXXX to [XXXXX] to make it clearer. #666
  • Modify the Range Validator to support additional types and clean up the error output. #690
  • Bugfix: The trigger on parse modifier did not work on positional argument.s #713
  • Bugfix: The single header file generation was missing custom namespace generation. #707
  • Bugfix: Clean up File Error handling in the argument processing. #678
  • Bugfix: Fix a stack overflow error if nameless commands had fallthrough. #665
  • Bugfix: A subcommand callback could be executed multiple times if it was a member of an option group. #666
  • Bugfix: Fix an issue with vectors of multi argument types where partial argument sets did not result in an error. #661
  • Bugfix: Fix an issue with type the template matching on C++20 and add some CI builds for C++20. #663
  • Bugfix: Fix typo in C++20 detection on MSVC. #706
  • Bugfix: An issue where the detection of RTTI being disabled on certain MSVC platforms did not disable the use of dynamic cast calls. #666
  • Bugfix: Resolve strict-overflow warning on some GCC compilers. #666
  • Backend: Add additional tests concerning the use of aliases for option groups in config files. #666
  • Build: Add support for testing in meson and cleanup symbolic link generation. #701, #697
  • Build: Support building in WebAssembly. #679
Files (351.4 kB)
Name Size
351.4 kB Download
All versions This version
Views 1,20739
Downloads 1480
Data volume 26.9 MB0 Bytes
Unique views 1,10336
Unique downloads 520


Cite as