async.hpp File Reference

The asynchronous primitives, on their own — the cheap include. More...

#include "callback_scope.hpp"
#include "completion.hpp"
#include "executor.hpp"
#include "strand.hpp"

Go to the source code of this file.

Detailed Description

The asynchronous primitives, on their own — the cheap include.

Completion, IExecutor and its implementations, the strands and CallbackScope are useful without a model, a registry, a wire envelope or a schema, and they are the part of morph that costs almost nothing to compile. Nothing here reaches glaze.

Measured with clang 22.1.8, -O2 -fsyntax-only, one translation unit per header, best of three:

header	CPU s	preprocessed lines
core/executor.hpp	1.16	124,855
core/completion.hpp	1.20	127,450
core/strand.hpp	1.20	127,217
core/bridge.hpp	3.76	267,827

A consumer that wants the primitives and reaches for bridge.hpp — the obvious header, and the one every example includes — pays roughly three times over for a schema generator and a JSON codec it never calls. This header exists so the cheap path has a name.

It is a facade and nothing else: it declares no symbol of its own, so including it is exactly equivalent to including the four headers below.

Definition in file async.hpp.