rust

Fory Rust Benchmark

This benchmark compares Rust serialization and deserialization throughput for Apache Fory and Protocol Buffers using the shared benchmark dataset defined in benchmarks/proto/bench.proto.

Quick Start

Run the complete Rust benchmark pipeline:

cd benchmarks/rust
./run.sh

Run Options

./run.sh --help

Options:
  --data <struct|sample|mediacontent|structlist|samplelist|mediacontentlist>
                               Filter benchmark by data type
  --serializer <fory|protobuf>
                               Filter benchmark by serializer
  --filter <regex>             Custom criterion filter
  --no-report                  Skip Python report generation

Examples:

# Run only Struct benchmarks
./run.sh --data struct

# Run only Protobuf benchmarks
./run.sh --serializer protobuf

# Run only Sample and MediaContent benchmarks for Protobuf
./run.sh --data sample,mediacontent --serializer protobuf

Benchmark Cases

Benchmark case	Description
Struct	Numeric struct with 8 int32 fields
Sample	Mixed primitive and array payload matching the shared benchmark schema
MediaContent	Media and image payload matching the Java/C++ benchmark data
StructList	List of shared Struct payloads
SampleList	List of shared Sample payloads
MediaContentList	List of shared MediaContent payloads

Shared Proto Schema

The Rust benchmark uses the shared protobuf definition at benchmarks/proto/bench.proto, the same benchmark schema used by the C++ benchmark suite.

Manual Commands

Run Criterion benchmarks:

cd benchmarks/rust
cargo bench --bench serialization_bench

Print serialized sizes:

cd benchmarks/rust
cargo run --release --bin fory_profiler -- --print-all-serialized-sizes

Generate the markdown report manually:

cd benchmarks/rust
cargo bench --bench serialization_bench 2>&1 | tee results/cargo_bench.log
cargo run --release --bin fory_profiler -- --print-all-serialized-sizes | tee results/serialized_sizes.txt
python benchmark_report.py --log-file results/cargo_bench.log --size-file results/serialized_sizes.txt --output-dir results

Report Output

The report generator writes:

• results/README.md
• results/throughput.png
• per-datatype plots such as results/struct.png and results/mediacontent.png