register classes by reflection in C++26

[jll63]

Closes #89.

When the compiler supports C++26 reflection (P2996), the library can find the
classes taking part in dispatch on its own, and BOOST_OPENMETHOD_CLASSES
becomes unnecessary in most cases.

What's new

• use_classes_in<^^Namespace, Registry> (core.hpp) — a registrar that
  scans a namespace by reflection for the classes involved in dispatch, plus
  their bases, and registers them. Virtual and multiple inheritance are
  supported; unlike use_classes, repeated inheritance is not an error here —
  an ambiguous base cannot take part in dispatch, so it is left out.
• BOOST_OPENMETHOD_CLASSES_IN(NAMESPACE, ...) (macros.hpp) — the macro
  wrapper. Reflection sees only what precedes it, so it goes at the bottom of
  the file. Without reflection it expands to nothing, so a file that also calls
  BOOST_OPENMETHOD_CLASSES builds under either standard.
• policies::explicit_class_registration (preamble.hpp) — opts a registry
  out, restoring the C++17 behaviour where every class must be registered by
  hand. The registry exposes has_reflected_class_registration. The policy has
  no effect if the compiler does not support reflection.

Methods are found through the names that denote them — the using declaration
BOOST_OPENMETHOD now emits, a hand-written one, or any registrar object. A
core-interface method whose method<...> type is spelled out in full at every
use, with neither a using declaration nor an overrider, is named by nothing
and is not found; its classes still need use_classes.

Detection is automatic, from __cpp_impl_reflection — nothing about the C++17
build changes.

Tests

test_classes.hpp adds BOOST_OPENMETHOD_TEST_CLASSES, which expands to
BOOST_OPENMETHOD_CLASSES in C++17 and to nothing under reflection. Tests that
are not about class registration use it and add a trailing
BOOST_OPENMETHOD_CLASSES_IN(::), so a C++26 run exercises reflection-based
registration across the whole suite: the classes go unregistered and every test
still has to pass. Tests that check what happens when a class is not
registered keep BOOST_OPENMETHOD_CLASSES and put
explicit_class_registration in their registry.

test_reflection.cpp covers the scan itself.

Build

• CMake: BOOST_OPENMETHOD_ENABLE_REFLECTION=ON probes for -std=c++26 and
  -std=c++26 -freflection, and applies whichever works per target (not through
  CMAKE_CXX_FLAGS — CMake probes the compiler before CMAKE_CXX_STANDARD
  takes effect, and GCC rejects -freflection under any other standard).
• b2: <toolset>gcc,<cxxstd>26:<cxxflags>-freflection.
• CI: a new reflection job builds and runs the suite with GCC 16.

Verified locally in both configurations: C++17/clang 153/153, and C++26
reflection (g++-16 -freflection) 148/148.

[cppalliance-bot]

An automated preview of the documentation is available at https://94.openmethod.prtest3.cppalliance.org/libs/openmethod/doc/html/index.html

If more commits are pushed to the pull request, the docs will rebuild at the same URL.

2026-08-29 19:36:06 UTC

[codecov]

Codecov Report

❌ Patch coverage is 99.17355% with 1 line in your changes missing coverage. Please review.
✅ Project coverage is 93.02%. Comparing base (b3bec3b) to head (77996d8).
⚠️ Report is 1 commits behind head on develop.

Files with missing lines	Patch %	Lines
include/boost/openmethod/core.hpp	98.07%	0 Missing and 1 partial ⚠️

Additional details and impacted files

@@             Coverage Diff             @@
##           develop      #94      +/-   ##
===========================================
- Coverage    94.94%   93.02%   -1.93%     
===========================================
  Files           99       22      -77     
  Lines         4373     1634    -2739     
  Branches      2168      504    -1664     
===========================================
- Hits          4152     1520    -2632     
+ Misses         162       66      -96     
+ Partials        59       48      -11     

Files with missing lines	Coverage Δ
include/boost/openmethod/default_registry.hpp	100.00% <ø> (ø)
include/boost/openmethod/detail/ostdstream.hpp	96.77% <100.00%> (+0.10%)	⬆️
include/boost/openmethod/detail/static_list.hpp	96.22% <ø> (ø)
include/boost/openmethod/initialize.hpp	92.02% <100.00%> (+0.03%)	⬆️
include/boost/openmethod/inplace_vptr.hpp	100.00% <100.00%> (ø)
include/boost/openmethod/interop/boost_any.hpp	100.00% <ø> (ø)
...e/boost/openmethod/interop/boost_intrusive_ptr.hpp	94.44% <ø> (ø)
...de/boost/openmethod/interop/boost_type_erasure.hpp	100.00% <100.00%> (ø)
include/boost/openmethod/interop/std_any.hpp	100.00% <ø> (ø)
...nclude/boost/openmethod/interop/std_shared_ptr.hpp	94.73% <ø> (ø)
... and 6 more

... and 77 files with indirect coverage changes

---

Continue to review full report in Codecov by Harness.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update dd2c86f...77996d8. Read the comment docs.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.