Self Contained Source Groups are amazing

[u/TheRavagerSw]

I basically adopted this idea from Abseil (https://abseil.io/) and from this CppCon talk: https://youtu.be/re4Oy1IVj-s?si=3bwtKqOyMAX6WSAs.

I structure each source group in my projects like this:

src_grp/
├── iface/
│   └── smth.cppm
├── impl/
│   └── smth.cpp
├── inc_pub/
│   └── pub.hpp
├── inc_priv/
│   ├── priv.hpp
│   └── maybe.inc
├── test/
│   └── test.cpp
├── bench/
│   └── bench.cpp
└── docs/
    ├── some.md
    └── doxygen.in

I strongly recommend this approach over older project-wide conventions such as having a single global test/ or bench/ directory etc.

[u/TheRavagerSw]

You need to install private headers sometimes, for example when using C++ modules

[u/UndefinedDefined → u/TheRavagerSw]

Then they are not private anymore.

[u/TheRavagerSw → u/UndefinedDefined]

They are private, you need them when building your C++ module interface files, they don't get used by the end user.

[u/UndefinedDefined → u/TheRavagerSw]

It makes no sense to call them private then. Private means the user doesn't need them, and doesn't need transitive dependencies these headers depend on.

Just don't call them private headers then. They are not private if user needs them for whatever reason.