cpp_utils

Header-only C++20 utilities for performance-sensitive projects. Each utility lives in its own folder, has no external dependencies, and can be used standalone or alongside others.

Utilities

Utility	What it does	Deps	Doc
ansi_colors	ANSI escape codes, TTY-aware color helpers	—	doc
ct_string	Compile-time string NTTP, FNV-1a hash	—	doc
parameters	O(1) named parameter registry	ct_string	doc
timer	High-res timer, Welford stats, thread-safe registry	ct_string	doc
stats_registry	Counters, gauges, histograms + timers	timer	doc
logger	Thread-safe logger, sync/async, level filtering	ansi_colors	doc
benchmarking	Micro-benchmark framework with statistics	ansi_colors	doc
testing	Unit-test framework with fluent expectations	ansi_colors	doc
argparser	CLI argument parser with TOML config overlay	parameters	doc
binary_set	Packed bitset, O(1) ops, word-at-a-time algebra	—	doc
interval	Closed interval [lo, hi] for arithmetic types	—	doc
scope_guard	RAII scope-exit/fail/success guard	—	doc
limits	Cooperative time and memory limits	—	doc

Dependency Graph

ct_string ──┬──→ parameters ──→ argparser
            └──→ timer ──→ stats_registry

ansi_colors ──┬──→ logger
              ├──→ benchmarking
              └──→ testing

binary_set, interval, scope_guard, limits   (no dependencies)

Transitive dependency summary:

Utility	Files needed
ansi_colors	ansi_colors.hxx
ct_string	ct_string.hxx
parameters	parameters.hxx, ct_string.hxx
timer	timer.hxx, ct_string.hxx
stats_registry	stats_registry.hxx, timer.hxx, ct_string.hxx
logger	logger.hxx, ansi_colors.hxx
benchmarking	benchmark.hxx, bench_main.hpp, ansi_colors.hxx
testing	test_framework.hxx, test_main.hpp, ansi_colors.hxx
argparser	argparser.hxx, parameters.hxx, ct_string.hxx
binary_set	binary_set.hxx
interval	interval.hxx
scope_guard	scope_guard.hxx
limits	limits.hxx

Copying Headers into Your Project

copy_util.py copies a utility and all its transitive dependencies into a flat destination folder, rewriting cross-project #include paths so everything works from a single directory.

python copy_util.py <project> [<project> ...] <dest>

Examples:

# Copy just the logger (also copies ansi_colors automatically)
python copy_util.py logger ~/my_project/include

# Copy argparser (also copies parameters + ct_string)
python copy_util.py argparser /tmp/headers

# Copy multiple utilities at once (shared deps are copied once)
python copy_util.py stats_registry logger ~/my_project/include

# Copy a standalone utility
python copy_util.py binary_set ~/my_project/include

After copying, include headers directly — the rewritten paths are flat:

#include "logger.hxx"       // was: #include "../logger/logger.hxx"
#include "ansi_colors.hxx"  // automatically included, path rewritten

The script resolves transitive dependencies automatically and deduplicates them, so copying stats_registry does not re-copy ct_string.hxx if it was already collected.

Destination files are always overwritten — re-running the script is safe and updates existing headers to the current version.

Build Requirements

• Standard: C++20 — all library headers compile under C++20
• Dependencies: standard library only — no external packages
• Threads: -pthread required for logger (async mode), timer, and stats_registry

# Typical compile flags
g++ -std=c++20 -O2 -pthread your_file.cpp -o output

Headers are self-contained — just drop them in your include path and #include them.