ExplanationΒΆ
Background knowledge, design decisions, and optimization history. These pages help you understand why the codec works the way it does.
The motivation behind the codec: what ZODB pickle gives you, what it costs you, and why JSONB queryability changes the equation.
Internal structure of the codec. Decode and encode pipelines, the PickleValue AST, known-type interception, and the three decode output paths.
Current benchmark results with context. Synthetic micro-benchmarks, FileStorage scans, PG storage path comparisons, and output size data.
Chronological record of every performance optimization from v1.0.0 through v1.5.0. Techniques, insights, measured impact, and lessons learned.
Defense-in-depth measures against malformed pickle data. Length validation, memo caps, recursion limits, and allocation guards.