1379 Commits

Author SHA1 Message Date
Philip Top
3914826ef8 Version update (#1219)
update changelog for 2.6 release

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
v2.6.0
2025-10-20 06:07:51 -07:00
Theodor Nesfeldt Engøy
8225a6ad4e ci(cifuzz): keep dry-run until google/oss-fuzz#14131 merges (#1232)
Flip CIFuzz out of dry‑run now that cli11 exists in OSS‑Fuzz.

---------

Co-authored-by: TheodorNEngoy <[email protected]>
2025-10-19 06:11:33 -07:00
allcontributors[bot]
3b84cbae64 📝 Add TheodorNEngoy as a contributor for infra (#1231)
Adds @TheodorNEngoy as a contributor for infra.

This was requested by phlptp [in this
comment](https://github.com/CLIUtils/CLI11/pull/1225#issuecomment-3418608931)

[skip ci]

---------

Co-authored-by: allcontributors[bot] <46447321+allcontributors[bot]@users.noreply.github.com>
2025-10-18 10:48:50 -07:00
Theodor Nesfeldt Engøy
0c4cd5f079 ci: add CIFuzz (#1225)
Add OSS-Fuzz CIFuzz workflow to run fuzzers on PRs for project 'cli11'.

---------

Co-authored-by: TheodorNEngoy <[email protected]>
2025-10-18 10:48:36 -07:00
Philip Top
16a2840b4e Add CodeQL analysis workflow configuration (#1230)
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2025-10-18 10:47:57 -07:00
Philip Top
3388e8ea49 Help spacing (#1229)
Fix the help spacing and double printing of footers in certain
circumstances

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2025-10-18 08:45:09 -07:00
Volker Christian
0104dceb17 Option callback priority v2 (#1226)
Extension allowing all possible priority combinations.
Add a field callback_priority to OptionBase.

---------

Co-authored-by: Philip Top <phlptp@gmail.com>
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2025-10-18 06:52:55 -07:00
pre-commit-ci[bot]
a41ba814b3 chore(deps): pre-commit.ci autoupdate (#1220)
<!--pre-commit.ci start-->
updates:
- https://github.com/psf/blackhttps://github.com/psf/black-pre-commit-mirror
<!--pre-commit.ci end-->

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2025-10-07 05:48:42 -07:00
Philip Top
e591f4aac5 ensure the parse order is reset on clear() (#1218)
Fixes #1216
2025-10-03 06:08:47 -07:00
pre-commit-ci[bot]
e83695fb10 chore(deps): pre-commit.ci autoupdate (#1215)
<!--pre-commit.ci start-->
updates:
- [github.com/pre-commit/mirrors-clang-format: v21.1.1 →
v21.1.2](https://github.com/pre-commit/mirrors-clang-format/compare/v21.1.1...v21.1.2)
<!--pre-commit.ci end-->

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2025-09-30 05:05:00 -07:00
pre-commit-ci[bot]
5248d5b352 chore(deps): pre-commit.ci autoupdate (#1210)
<!--pre-commit.ci start-->
updates:
- [github.com/psf/black: 25.1.0 →
25.9.0](https://github.com/psf/black/compare/25.1.0...25.9.0)
- [github.com/pre-commit/mirrors-clang-format: v21.1.0 →
v21.1.1](https://github.com/pre-commit/mirrors-clang-format/compare/v21.1.0...v21.1.1)
<!--pre-commit.ci end-->

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2025-09-23 10:40:30 -07:00
allcontributors[bot]
89dc726939 📝 Add romanholidaypancakes as a contributor for code (#1208)
Adds @romanholidaypancakes as a contributor for code.

This was requested by phlptp [in this
comment](https://github.com/CLIUtils/CLI11/pull/1206#issuecomment-3292000117)

[skip ci]

---------

Co-authored-by: allcontributors[bot] <46447321+allcontributors[bot]@users.noreply.github.com>
2025-09-15 07:34:09 -07:00
romanholidaypancakes
8bc29b83e9 Update App.hpp (#1206)
Compatible compile option: /GR-
2025-09-15 05:52:01 -07:00
Philip Top
be52eb6972 Contrib update (#1205)
update contributors
2025-09-08 05:24:24 -07:00
Philip Top
c8dc5f627a add permission validators as an Extra Validator (#1203)
an update of #250 

Fixes #249

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2025-09-08 05:16:49 -07:00
Philip Top
ee326d647b Fuzzer issues (#1202)
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2025-09-02 07:07:01 -07:00
pre-commit-ci[bot]
dd99ec7752 chore(deps): pre-commit.ci autoupdate (#1201)
<!--pre-commit.ci start-->
updates:
- [github.com/pre-commit/mirrors-clang-format: v20.1.8 →
v21.1.0](https://github.com/pre-commit/mirrors-clang-format/compare/v20.1.8...v21.1.0)
<!--pre-commit.ci end-->

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2025-09-02 04:49:34 -07:00
Philip Top
8c77664bd0 move some of the Validators to an ExtraValidators file (#1192)
Rework some of the validator locations, add documentation, and fix some
lingering issues with validators.
The extra will will enable additions of some new validators and reduce
compile times for those that are not needed.

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2025-09-01 05:13:21 -07:00
Philip Top
1ab8646760 duplicate footer (#1200)
fix an issue with duplicate footers being printed with help_all

Fixes #1183

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2025-08-29 12:38:46 -07:00
Philip Top
f7e4695ed8 fix edge case with config files pointer (#1199)
generating a seg fault if no default and no config file provided.

Fixes #1197 

This was likely introduced by the combination of fixes for some issues
with the config parsing and some updates to the as<T> method a while
back. This edge case on the handling of the config pointer with as was
not overlooked in the earlier testing.

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2025-08-28 17:11:03 -07:00
Philip Top
399e729a55 Fix issue with multiline array interpretation for toml (#1196)
if the first line only contained a single character.

Fixes #1195
2025-08-27 17:40:51 -07:00
Radim Krčmář
e7e8de0346 formatter: add long_option_alignment_ratio (#1185)
The default formatter has hardcoded ratio at which the long options are
aligned. It's currently 1/3 of the column, which makes the default look
awkward:
```
  -h,     --help              Print
          --option            Something
```
A ->long_option_alignment_ratio(6/30.f) allows output to look like this:
```
  -h, --help                  Print
      --option                Something
```
The 1/3 ratio is also bad if you want to print "descriptive" long
options on a single line, because then you might want to increase the
column width, but that means you waste more space on short options.

e.g. ->column_width(46)
```
  -l,          --very-descriptive-long-option  Something
```
vs. ->column_width(38)
```
  -l,       --very-descriptive-long-option
                                      Something
```
vs. ->column_width(38) ->long_option_alignment_ratio(6/38.f)
```
  -l, --very-descriptive-long-option  Something
```
Any absolute offset `X` can be set as `X/column_width`, so provide a
ratio-based interface.

I would have prefered to give an absolute integer offset, but we still
have to preserve the functionality that does 1/3 if user changed
nothing, which means that ratio-based interface is simpler.

I don't have a good idea for the name, "short_option_ratio" might work
as well.
The setter does not sanity check that the value is in [0;1] range.

---------

Signed-off-by: Radim Krčmář <radim@krcmar.dev>
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2025-08-27 05:17:20 -07:00
pre-commit-ci[bot]
6e9b07734c chore(deps): pre-commit.ci autoupdate (#1193)
<!--pre-commit.ci start-->
updates:
- [github.com/pre-commit/pre-commit-hooks: v5.0.0 →
v6.0.0](https://github.com/pre-commit/pre-commit-hooks/compare/v5.0.0...v6.0.0)
<!--pre-commit.ci end-->

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2025-08-12 05:15:12 -07:00
Philip Top
dfd3d90078 use of string_view in as<T> method (#1187)
Address Issue #881, allowing use of string_view in the as<XX> method on
options.

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2025-08-09 10:42:18 -04:00
Henry Schreiner
bb9bd85e3b chore: require CMake 3.14+ (#1182)
3.15 is a good minimum these days, and what pybind11, etc. now use.
(Edit: we are using some really old docker containers, so let's do 3.14+
for now).

---------

Signed-off-by: Henry Schreiner <henryschreineriii@gmail.com>
2025-07-25 10:09:07 -04:00
Henry Schreiner
e351ddd522 chore: add CMake presets (#1181)
Add two presets (default and tidy).

---------

Signed-off-by: Henry Schreiner <henryschreineriii@gmail.com>
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2025-07-25 10:05:37 -04:00
Philip Top
2a59b281f0 reorder the processing of requirements and callbacks. (#1186)
Check the requirements first.
Previously the callbacks were done first, but with custom callbacks this
cause side effects unexpectedly.

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2025-07-25 06:53:17 -07:00
Prashanth Mundkur
a9b7b96701 Update version in license to match source. (#1180)
For packagers that need to install license files, it helps when the
version in the license matches the version of the source used in the
package.
2025-07-24 06:28:37 -07:00
Philip Top
c5153634db Fix warnings and small issues (#1178)
try some things with no standard libraries
Add arm64 and freebsd build and tests
fix a discrepancy in the handling of chars on Arm processors

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2025-07-18 07:18:26 -07:00
pre-commit-ci[bot]
587129a170 chore(deps): pre-commit.ci autoupdate (#1177)
<!--pre-commit.ci start-->
updates:
- [github.com/pre-commit/mirrors-clang-format: v20.1.7 →
v20.1.8](https://github.com/pre-commit/mirrors-clang-format/compare/v20.1.7...v20.1.8)
<!--pre-commit.ci end-->

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2025-07-15 05:25:51 -07:00
pre-commit-ci[bot]
d0ac90b5f2 chore(deps): pre-commit.ci autoupdate (#1174)
<!--pre-commit.ci start-->
updates:
- [github.com/pre-commit/mirrors-clang-format: v20.1.6 →
v20.1.7](https://github.com/pre-commit/mirrors-clang-format/compare/v20.1.6...v20.1.7)
<!--pre-commit.ci end-->

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2025-07-14 11:30:33 -07:00
Dominik Nussbaumer
7a7ba4b9ca Allow rvalue references to be use with add_flag with no assignment (#1173)
I am starting to use CLI11 in a project and I came across an
inconvenience in code like this

```c++
const std::string description(std::format("description"));
app.add_flag("--flag", description);
```
As far as I can tell. I cannot directly use the description here. The
reason seems to be to distinguish between assignment and description. So
only `const std::string` or `const char*` and so on can be used here.
But a `const std::string &&` can not be used.

With the changes in the PR the code can also be written like this:
```c++
app.add_flag("--flag", std::format("description"));
```

The `add_flag` function can then be used with a const string or an
rvalue reference to a string.


A bit OT: I was a bit confused by this part of the existing comment ` if
a variable string is passed that variable will be assigned the results
from the flag` I think this might be wrong, but I am not sure.

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2025-06-27 06:36:06 -07:00
Philip Top
13658df9e1 remove use of windows-2019 image in azure CI tests (#1172)
Azure windows 2019 image is being deprecated, shift CI to windows-2022
and windows 2025 images
add tests for coverage and a few missing checks for duplication options.

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2025-06-18 20:19:28 -07:00
Philip Top
26bb3f2e30 More fuzzing2 (#1170)
add mechanic for fuzzing subcommands, and several fixes for found issues
from longer fuzzer runs

This includes some issues with option group positional name ambiguity, issue with join multioption policy and config files, and a few edge cases for configuration of multiline output interpretation.

Also added complex variables to the options, no issues found from this addition. 

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2025-06-18 05:21:18 -07:00
pre-commit-ci[bot]
569ca73b0b chore(deps): pre-commit.ci autoupdate (#1171)
<!--pre-commit.ci start-->
updates:
- [github.com/pre-commit/mirrors-clang-format: v20.1.5 →
v20.1.6](https://github.com/pre-commit/mirrors-clang-format/compare/v20.1.5...v20.1.6)
<!--pre-commit.ci end-->

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2025-06-17 06:07:57 -07:00
Philip Top
328ac68432 Subcommand plurality (#1169)
Partially address #1168 fix subcommand plurality when subcommand_max count is 0

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2025-06-05 17:48:01 -07:00
Theo Paris
542ef71d8d build: improve meson build (#1167)
Allows building the precompiled library as a shared library. This can be
toggled with the `default_library` meson option. Additionally I added
pkgconfig support and installation of the headers.
2025-06-03 08:07:20 -07:00
pre-commit-ci[bot]
4a4039d05c chore(deps): pre-commit.ci autoupdate (#1166)
<!--pre-commit.ci start-->
updates:
- [github.com/pre-commit/mirrors-clang-format: v20.1.4 →
v20.1.5](https://github.com/pre-commit/mirrors-clang-format/compare/v20.1.4...v20.1.5)
<!--pre-commit.ci end-->

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2025-05-29 04:56:00 -07:00
Philip Top
c4a6f31bd9 Tests (#1165)
Handle RTTI in a consistent way for locale inclusion for integral conversion.  
Resolve some missing code coverage lines.

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: Alexander Galanin <agalanin@nvidia.com>
2025-05-26 10:35:22 -07:00
Alexander Galanin
3d9eb4e0a0 Default value conversion error if the application locale is set (#1160)
**Short description**
Application fails with `CLI::ConversionError` in some locales if the
application locale is set.

**Root cause**
CLI11 uses `std::stringstream` to format default value and
`strtol`/`strtod` to parse them back. The first method adds
locale-specific thousand separators but the second method parses the
number only up to the first separator. This causes an exception when the
same value is converted to string representation and then parsed back.

Examples: in _en_US_ locale 1234.56 is "1,234.56" and in de_DE locale
1234.56 is "1.234,56".

**Reproduction**
```c++
#include <string>
#include <CLI/CLI.hpp>

int main(int argc, const char **argv)
{
    std::locale::global(std::locale(""));
    CLI::App app{"Bug report app"};
    long foo;

    app.add_option("FOO", foo, "Foo option")
        ->envname("FOO")
        ->default_val(1234567);
    CLI11_PARSE(app, argc, argv);

    return 0;
}
```
Output:
```
$ g++ -Wall -Wextra -I CLI11/include/ cli11-bug-locale-string.cpp -o cli11-bug-locale-string
$ for locale in C en_US de_DE fr_FR de_CH; do echo "locale $locale"; LC_NUMERIC=$locale.UTF-8 ./cli11-bug-locale-string && echo OK; echo; done
locale C
OK

locale en_US
terminate called after throwing an instance of 'CLI::ConversionError'
what():  The value FOO is not an allowed value for given default value("1,234,567") produces an error : Could not convert: FOO = 1,234,567
Aborted (core dumped)

locale de_DE
terminate called after throwing an instance of 'CLI::ConversionError'
what():  The value FOO is not an allowed value for given default value("1.234.567") produces an error : Could not convert: FOO = 1.234.567
Aborted (core dumped)

locale fr_FR
terminate called after throwing an instance of 'CLI::ConversionError'
what():  The value FOO is not an allowed value for given default value("1 234 567") produces an error : Could not convert: FOO = 1 234 567
Aborted (core dumped)

locale de_CH
OK
```

**Fix description**
The fix strips group separators from the input string. This extends a
bit the logic introduced in change #968 for `_` and `'` separators.
There are no unit tests for the change because it requires to have all
mentioned locales to be installed in the system.

---------

Co-authored-by: Philip Top <phlptp@gmail.com>
2025-05-25 16:26:47 -07:00
Philip Top
5602f2b438 add an example of finding close matches (#1152)
continue discussion on #1149 
Adds subcommand prefix matching as a modifier to CLI.  
Adds an example of close matching logic for further exploration.

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2025-05-21 19:39:00 -07:00
Philip Top
50591fb666 Fuzz fail new (#1164)
Additional fuzz failures from longer runs of fuzzer.
Ran the fuzzer for a couple hours. Picked up a few interesting bug particularly in the config out and return.

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2025-05-21 19:37:28 -07:00
Philip Top
2c787a50ed add flags on the formatter to disable formatting (#1150)
add flags on the formatter to disable formatting for the description and
footer to allow things like word art or custom formatting.

One possible solution for #1145

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2025-05-19 05:25:00 -07:00
pre-commit-ci[bot]
1df96c852d chore(deps): pre-commit.ci autoupdate (#1163)
<!--pre-commit.ci start-->
updates:
- [github.com/pre-commit/mirrors-clang-format: v20.1.3 →
v20.1.4](https://github.com/pre-commit/mirrors-clang-format/compare/v20.1.3...v20.1.4)
<!--pre-commit.ci end-->

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2025-05-13 06:25:48 -07:00
Philip Top
990956f4f8 add checks and fixes for extrasError argument order (#1162)
Adds tests and checks for Extras Error 
Builds on #1158

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2025-05-09 08:06:25 -07:00
Alexander Galanin
1364746d4c Fix the order of arguments in command-line parsing error message (#1158)
CLI11 code prints the command-line arguments in reversed order in the
error message.

Code to reproduce:
```c++
#include <string>
#include <CLI/CLI.hpp>

int main(int argc, const char **argv)
{
    CLI::App app{"Bug report app"};
    std::string foo;

    app.add_option("--foo", foo, "Foo option");
    CLI11_PARSE(app, argc, argv);

    return 0;
}
```

Reproduction:
```
$ g++ -Wall -Wextra -I CLI11/include/ cli11-bug-order-in-error.cpp -o cli11-bug-order-in-error && ./cli11-bug-order-in-error --foo bar --fizz buzz
The following arguments were not expected: buzz --fizz
Run with --help for more information.
```
Expected result:
```
The following arguments were not expected: --fizz buzz
Run with --help for more information.
```
2025-05-09 05:35:05 -07:00
Philip Top
c31476b01a Multiple footer printing in help (#1161)
Fixes #1156 

For option groups removes inheritance of the footer and help option, so
those are not printed by default for option groups. It is still possible
to set them again on the option group.

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2025-05-08 06:17:18 -07:00
pre-commit-ci[bot]
f6328ccc7a chore(deps): pre-commit.ci autoupdate (#1159)
<!--pre-commit.ci start-->
updates:
- [github.com/pre-commit/mirrors-clang-format: v20.1.0 →
v20.1.3](https://github.com/pre-commit/mirrors-clang-format/compare/v20.1.0...v20.1.3)
<!--pre-commit.ci end-->

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2025-05-06 04:39:46 -07:00
Philip Top
3ed270937e fix an issue with default strings of arrays and config out. (#1155)
Fixes #1154

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2025-04-28 17:39:29 -07:00
Philip Top
cbbf20ed93 Ci build update (#1151)
update ci build images, remove ubuntu 20.04 and update a few others, fix some newer clang-tidy warnings

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2025-04-19 09:14:59 -07:00