catch3/src/catch2/internal/catch_clara.hpp, branch 0.2.0 Progmasoft Catch3: an independently maintained C++17 test framework with a parallel runner, property checks, snapshots and structured results. Add some missing CATCH_MOVEs 2026-09-11T09:27:33+00:00 Martin Hořeňovský 2026-09-11T07:41:58+00:00 b7f1a83ff0c36990a9840bcb3de56a848d24a893 






Use template variables for our trait-likes in Clara
2025-07-15T09:49:39+00:00

Martin Hořeňovský

2025-07-15T09:49:39+00:00

b9c018b38a98f7f9d15e4f6b9e60ec90cd393b7b












Fix adding Opts with | to lvalue Parser
2024-01-02T22:27:13+00:00

Martin Hořeňovský

2024-01-02T22:27:13+00:00

863c662c0eff026300f4d729a7054e90d6d12cdd

This is the recommended way of adding new Opts in our documentation
for using custom main, but we did not compile the code to see if it
works. We now compile the example as part of the BUILD_EXAMPLES
option.

Fixes #2787





This is the recommended way of adding new Opts in our documentation
for using custom main, but we did not compile the code to see if it
works. We now compile the example as part of the BUILD_EXAMPLES
option.

Fixes #2787







Avoid copying TokenStreams while parsing
2023-12-27T20:14:12+00:00

Martin Hořeňovský

2023-12-27T20:11:34+00:00

eaafd076743407e930a11297425f33c1f78220b0

The code is now even worse mess than before, due to the ad-hoc
implementation of Result-ish type based on virtual functions in
Clara, but it has dropped the allocations for empty binary down
to 151.





The code is now even worse mess than before, due to the ad-hoc
implementation of Result-ish type based on virtual functions in
Clara, but it has dropped the allocations for empty binary down
to 151.







Args and TokenStream use StringRefs instead of std::strings
2023-12-27T15:24:33+00:00

Martin Hořeňovský

2023-12-27T15:19:49+00:00

5d637d4c6b72dc21e2e198894ba0527729fba535

Because TokenStream is copied around a lot, moving it to use
`StringRef` removes _a lot_ of allocations per `Opt` in the parser.
Args are not copied around much, but changing them as well makes it
obvious that they do not participate in the ownership.

The changes add up to removing ~180 allocations for "empty"
invocation of the test binary.
(`./tests/ExtraTests/NoTests --allow-running-no-tests -o /dev/null`
is down to 317 allocs)





Because TokenStream is copied around a lot, moving it to use
`StringRef` removes _a lot_ of allocations per `Opt` in the parser.
Args are not copied around much, but changing them as well makes it
obvious that they do not participate in the ownership.

The changes add up to removing ~180 allocations for "empty"
invocation of the test binary.
(`./tests/ExtraTests/NoTests --allow-running-no-tests -o /dev/null`
is down to 317 allocs)







Use StringRef for Opt's optNames
2023-12-26T15:03:22+00:00

Martin Hořeňovský

2023-12-26T13:01:15+00:00

cd3c7ebe873c3da91ce57c6b2221ba95ee7f93e6

Removes another ~70 allocations.





Removes another ~70 allocations.







Enable moving Opts into Parser
2023-12-26T14:41:07+00:00

Martin Hořeňovský

2023-12-26T10:57:38+00:00

5d5f42f99b7409b6b051182fae69fd22f8877a6d

This also required keeping the reference type in the fluent interface
for Opts.

Removes another ~40 allocations.





This also required keeping the reference type in the fluent interface
for Opts.

Removes another ~40 allocations.







Avoid copying Clara::Parser for every inserted Opt
2023-12-26T14:11:48+00:00

Martin Hořeňovský

2023-12-26T10:55:19+00:00

c57e349d1d62fcdf96aef576a5c200ae2078daad

This prevents the full construction from being O(N^2) in number
of `Opt`s, and also reduces the number of allocations for running
no tests significantly:

`tests/SelfTest`: 7705 -> 6095
`tests/ExtraTests/NoTests` 2215 -> 605





This prevents the full construction from being O(N^2) in number
of `Opt`s, and also reduces the number of allocations for running
no tests significantly:

`tests/SelfTest`: 7705 -> 6095
`tests/ExtraTests/NoTests` 2215 -> 605







Cleanup help string construction in Clara
2023-12-26T13:57:29+00:00

Martin Hořeňovský

2023-12-23T15:06:30+00:00

822c44a20395c6194d527110d59f7513a55b885c

* Clara::Opt::getHelpColumns returns single item

  It could never return multiple items, but for some reason it
  was wrapping that single item in a vector.

* Use ReusableStringStream in Clara
* Reserve HelpColumns ahead of time
* Use StringRef for descriptions in HelpColumn type

The combination of these changes ends up removing about 7% (~200)
of allocations when Catch2 has to prepare output for `-h`.





* Clara::Opt::getHelpColumns returns single item

  It could never return multiple items, but for some reason it
  was wrapping that single item in a vector.

* Use ReusableStringStream in Clara
* Reserve HelpColumns ahead of time
* Use StringRef for descriptions in HelpColumn type

The combination of these changes ends up removing about 7% (~200)
of allocations when Catch2 has to prepare output for `-h`.







Store Opt/Arg hint and description as StringRef
2023-12-26T13:40:45+00:00

Martin Hořeňovský

2023-12-23T15:02:37+00:00

2295d2c8ccc0dba4b35adb95ef8946a05996df87

There is no good reason for these to be std::strings, as these
are just (optional) constants for nice user output. This ends up
reducing the allocations significantly.

When measuring allocations when running no tests, the changes are
`tests/SelfTest` 9213 -> 7705
`tests/ExtraTests/NoTests` 3723 -> 2215





There is no good reason for these to be std::strings, as these
are just (optional) constants for nice user output. This ends up
reducing the allocations significantly.

When measuring allocations when running no tests, the changes are
`tests/SelfTest` 9213 -> 7705
`tests/ExtraTests/NoTests` 3723 -> 2215