pbw-moon v0.1.5
pbw-moon
Overview
Another implementation of protobuf writer for protobuf.js, with smaller javascript heap memory usage. Tested on protobufjs v7.2.6.
When to use
- encode large Javascript objects
How to use
import * as protos from './protos/proto'
import { Writer } from 'pbw-moon'
// pass to the second argument
protos.partialsketch.Layer.encode(p, new Writer()).finish()Testing
Unit tests and fuzz test
The result of the offical protobuf writer is compared to verify its correctness. See packages/testing-units for details.
Conformance tests
Protobuf has conformance tests for testing the completeness and correctness of Protocol Buffers implementations. Repository protobuf-conformance runs the protocol buffers conformance test suite against various implementations, which include protobuf.js. This repository was forked to test the writer. See protobuf-conformance/impl/protobuf.js for details.
Benchmark
Currently, encoding small objects is slower than the official writer (in Node.js), but encoding large objects (30 MB) is faster. Run pnpm benchmark to see the result.
[Offical] encode bench
time 8552.496789008379 ms
heapTotal increase 10.5 MB
[pbw-moon] encode bench
time 9201.273878991604 ms
heapTotal increase 0 MB
[Offical] encode partialSketch
time 931.2965700030327 ms
heapTotal increase 316 MB
[pbw-moon] encode partialSketch
time 268.0517299771309 ms
heapTotal increase 11 MBLicense
Apache-2.0