Claude-skill-registry debug-asan-build

Build and test this repo with the CMake preset debug-asan (AddressSanitizer). Use when asked how to configure, build, run, or test with ASAN/debug builds in this project.

install

source · Clone the upstream repo

git clone https://github.com/majiayu000/claude-skill-registry

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/debug-asan-build" ~/.claude/skills/majiayu000-claude-skill-registry-debug-asan-build && rm -rf "$T"

manifest: skills/data/debug-asan-build/SKILL.md

Debug ASAN Build

Configure

Run:
- ```
cmake --preset debug-asan
```
This preset inherits the default binary dir:
```
build/
```
and sets
```
ENABLE_ASAN=ON
```
.

Build

Build everything:
- ```
cmake --build --preset debug-asan
```

Build a specific target:

cmake --build --preset debug-asan --target <target>

Many app targets live under
```
debug-asan/
```
. Use the app target name as the build target.

Run

Preferred binary path pattern:

./build/debug-asan/<target>/<target>_debug

Example:
- ```
./build/debug-asan/cert_ctrl_debug
```

Test

```
ctest --test-dir build/debug-asan
```
Run all tests (with failures shown):

ctest --test-dir build/debug-asan --output-on-failure

List all discovered tests:

```
ctest --test-dir build/debug-asan -N
```
Run a subset by regex:

ctest --test-dir build/debug-asan -R <regex> --output-on-failure

Notes:

CTest filters by registered test names (GoogleTest suite/case), not by the test executable name. For example, the

test_websocket_client

executable registers tests like

WebsocketClientIntegrationTest.*

, so this works:

ctest --test-dir build/debug-asan -R WebsocketClientIntegrationTest --output-on-failure

Run a single gtest binary:

Python (Harnesses / E2E)

Some long-running quality checks are implemented as small Python harnesses (e.g. websocket end-to-end drivers under

tests/e2e/

On some minimal Linux images,

python3 -m venv

python3 -m pip

may not be available by default. Prefer using

uv

for Python-related tasks.

Check uv:
- ```
uv --version
```

Run a one-off script with ephemeral deps (no venv needed):

uv run --with websockets>=12,<14 python tests/e2e/ws_e2e_harness.py --bin ./build/debug-asan/cert_ctrl_debug

uv

is not installed, install it via your standard tooling (for example, your distro package manager or the upstream installer), then rerun the command above.

ASAN Notes

The preset already sets

ASAN_OPTIONS=allocator_may_return_null=1

during configure.

If you need to override runtime ASAN options, export
```
ASAN_OPTIONS
```
before running.