weaselab/weaseldb
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update design.md

Browse Source
This commit is contained in:
Andrew Noyes
2025-08-15 20:39:45 -04:00
parent ea5da5fae1
commit b67666b97a
1 changed files with 5 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
design.md
View File

@@ -83,14 +83,14 @@ The system implements a RESTful API with three core endpoints:
#### Memory Allocation #### Memory Allocation
- **~1ns allocation time** vs standard allocators - **~1ns allocation time** vs standard allocators
- **Bulk deallocation** eliminates individual free() calls - **Bulk deallocation** eliminates individual free() calls
- **Geometric growth** minimizes allocation frequency - **Optimized geometric growth** uses current block size for doubling strategy
- **Alignment-aware** allocation prevents performance penalties - **Alignment-aware** allocation prevents performance penalties
#### JSON Parsing #### JSON Parsing
- **Streaming parser** handles large payloads efficiently - **Streaming parser** handles large payloads efficiently
- **Incremental processing** suitable for network protocols - **Incremental processing** suitable for network protocols
- **Arena storage** eliminates string allocation overhead - **Arena storage** eliminates string allocation overhead
- **Base64 decoding** integrated into parsing pipeline - **SIMD-accelerated base64 decoding** using simdutf for maximum performance
### Design Principles ### Design Principles
@@ -112,11 +112,13 @@ The project includes comprehensive testing infrastructure:
Build targets: Build targets:
- `test_arena_allocator`: Arena allocator functionality tests - `test_arena_allocator`: Arena allocator functionality tests
- `test_commit_request`: JSON parsing and validation tests - `test_commit_request`: JSON parsing and validation tests
- `bench_arena_allocator`: Performance benchmarking - `weaseldb`: Main application demonstrating configuration and parsing
- Various benchmark executables for performance testing
### Dependencies ### Dependencies
- **weaseljson**: High-performance streaming JSON parser - **weaseljson**: High-performance streaming JSON parser
- **simdutf**: SIMD-accelerated UTF-8 validation and base64 encoding/decoding
- **toml11**: TOML configuration file parsing - **toml11**: TOML configuration file parsing
- **doctest**: Lightweight testing framework - **doctest**: Lightweight testing framework
- **nanobench**: Micro-benchmarking library - **nanobench**: Micro-benchmarking library