serdec

A Serialization/Deserialization library for JSON, in C.

Status: Work in progress

Architecture

┌─────────────────────────────────────────┐
│   Layer 4: High-Level API               │
│   (serdec_parse, serdec_stringify)      │
├─────────────────────────────────────────┤
│   Layer 3: DOM API                      │
│   (object/array access, queries)        │
├─────────────────────────────────────────┤
│   Layer 2: SAX/Event API                │
│   (callbacks, pull parser, streaming)   │
├─────────────────────────────────────────┤
│   Layer 1: Lexer/Parser Core            │  <-- In Progress
│   (tokenization, structural validation) │
├─────────────────────────────────────────┤
│   Layer 0: Foundation                   │  <-- Done
│   (memory, buffers, error handling)     │
└─────────────────────────────────────────┘

Building

Requires CMake 4.2.3+ and a C23 compiler.

make build

Build Options

Option	Description
-DSERDEC_ENABLE_SANITIZERS=ON	Enable ASan + UBSan
-DSERDEC_ENABLE_ASAN=ON	Enable AddressSanitizer only
-DSERDEC_ENABLE_UBSAN=ON	Enable UndefinedBehaviorSanitizer only

Testing

# Build and run all tests
make test

# Build with sanitizers and run tests
make sanitize

# Run specific suite
./build/tests/serdec_tests buffer
./build/tests/serdec_tests arena

Development

make build     # Configure + build
make test      # Build + run tests
make sanitize  # Build with ASan/UBSan + run tests
make clean     # Remove build directory
make rebuild   # Clean + build