« Changelog History


CLI11 v2.0 Release Notes

  • 🗄 This version focuses on cleaning up deprecated functionality, and some minor 0️⃣ default changes. The config processing is TOML compliant now. Atomics and 👍 complex numbers are directly supported, along with other container improvements. A new version flag option has finally been added. Subcommands are significantly 👌 improved with new features and bugfixes for corner cases. This release contains ✅ a lot of backend cleanup, including a complete overhaul of the testing system and single file generation system.

    • Built-in config format is TOML compliant now #435
      • Support multiline TOML #528
      • Support for configurable quotes #599
      • Support short/positional options in config mode #443
    • 👍 More powerful containers, support for %% separator #423
    • 👌 Support atomic types #520 and complex types natively #423
    • ➕ Add a type validator CLI::TypeValidator<TYPE> #526
    • ➕ Add a version flag easily #452, with help message #601
    • 👌 Support ->silent() on subcommands. #529
    • ➕ Add alias section to help for subcommands #545
    • 👍 Allow quotes to specify a program name #605
    • Backend: redesigned MakeSingleFiles to have a higher level of manual control, to support future features. #546
    • 🚚 Backend: moved testing from GTest to Catch2 #574
    • 🛠 Bugfix: avoid duplicated and missed calls to the final callback #584
    • 🛠 Bugfix: support embedded newlines in more places #592
    • 🛠 Bugfix: avoid listing helpall as a required flag #530
    • 🛠 Bugfix: avoid a clash with WINDOWS define #563
    • 🛠 Bugfix: the help flag didn't get processed when a config file was required #606
    • 🛠 Bugfix: fix description of non-configurable subcommands in config #604
    • 🏗 Build: support pkg-config #523

    Converting from CLI11 1.9

    🚚 > - Removed deprecated set commands, use validators instead. #565 0️⃣ > - The final "defaulted" bool has been removed, use ->capture_default_str() 0️⃣ > instead. Use app.option_defaults()->always_capture_default() to set this for all future options. #597

    • Use add_option on a complex number instead of add_complex, which has 🚚 > been removed.