History

Loretta 73d81ea580 [LOADED_DOCS: 7 files, no new loads] AcBinary: add framing doc, buffer growth fixes, doc updates - Added `BINARY_WHYUSE.md` for architectural framing and value proposition - Updated `BINARY_FEATURES.md` and `README.md` to reference and prioritize the new doc - Documented AsyncPipeWriterOutput chunk-size limitation and workarounds in `BINARY_ASYNCPIPE_ISSUES.md` - Refactored buffer growth logic in `AcBinarySerializer.BinarySerializationContext.cs` to validate capacity after grow and throw clear exceptions on under-provisioning; removed dead method - Fixed chunk size alignment bug in `AsyncPipeWriterOutput.cs` to prevent buffer under-provisioning - Added `AYCODE_NATIVEAOT` build config support in `Program.cs` - Improved documentation clarity and error diagnostics for streaming/buffered serialization edge cases		2026-05-11 13:28:43 +02:00
..
AyCode.Core.Serializers.Console.csproj	[LOADED_DOCS: 2 files, no new loads]	2026-05-04 07:02:13 +02:00
Program.cs	[LOADED_DOCS: 7 files, no new loads]	2026-05-11 13:28:43 +02:00
README.md	Document AcBinary wire format, sync docs, update conventions	2026-03-29 09:11:57 +02:00

README.md

AyCode.Core.Serializers.Console

Standalone benchmark console application for comparing serializer performance. Targets .NET 9. Measures serialize/deserialize speed, output size, and compression across multiple serializers and data shapes.

Compared Serializers

AcBinary — Multiple configurations: Default, NoRef, FastMode, NoIntern, with/without source generation
MessagePack
MemoryPack

(System.Text.Json and Newtonsoft.Json comparisons exist but are currently commented out.)

Key Files

Program.cs — Benchmark runner. Modes: all (default), quick (fewer iterations), serialize, deserialize, profiler (memory profiler warmup). Outputs results to Test_Benchmark_Results/Benchmark/. Iterations: 5000 warmup + 1000 test (Release), 0+1 (Debug).
BenchmarkTestDataProvider.cs — Test data factory producing 5 data shapes:
- Small (2x2x2x2), Medium (3x3x3x4), Large (5x5x5x10)
- Repeated Strings (10 items, string deduplication testing)
- Deep Nested (2x4x4x8, depth stress test)
- Uses TestOrder model from AyCode.Core.Tests with configurable IId reference percentages.

Dependencies

Dependency	Purpose
`AyCode.Core`	Core library with AcBinary serializer
`AyCode.Core.Tests`	Test models (`TestOrder`, `TestDataFactory`, etc.)
`MemoryPack`	Competitor benchmark
`MessagePack`	Competitor benchmark
`Newtonsoft.Json`	Competitor benchmark