#criterion #measurement #benchmark #throughput #criterion-rs

criterion-decimal-throughput

Criterion.rs的decimal-throughput测量(MB/s、GB/s等)

3个稳定版本

1.0.2 2022年8月29日
1.0.0 2022年7月23日

#357 in 性能分析

MIT授权

24KB
220 代码行

criterion-decimal-throughput – Criterion.rs输出中的KB/s、MB/s、GB/s

Rust docs.rs

Crates.io GitHub Release Date GitHub last commit

Crates.io

为Criterion.rs提供的自定义测量格式,以十进制字节倍数(KB/s、MB/s、GB/s)显示吞吐量,而不是二进制(KiB/s、MiB/s、GiB/s)。

特性

在默认的Criterion.rs测量下,配置了吞吐量的基准测试输出将类似于以下内容

Throughput in binary (GiB/s)

意味着'1.5050 * 2^(30)',这可能是好的,但我并不擅长即时计算,不能一眼看出这实际上是大约16亿字节的平均值。使用这个crate,我们得到

Throughput in decimal (GB/s)

这是一个更优雅的'1.5787e9'。是否更喜欢其中一个是非常主观的,但Criterion.rs强制你使用二进制。如果你和我有相同的偏好,这个crate允许你得到更漂亮的数字。

用法

只需使用提供的decimal_byte_measurement函数进行默认配置,或手动设置DecimalByteMeasurement类型作为测量。请参阅docs.rs上的示例。

安装

使用cargocriterion-decimal-throughput添加为你的dev-dependency

cargo add --dev criterion-decimal-throughput

或者,直接将其添加到Cargo.tomldev-dependencies部分

[dev-dependencies]
criterion-decimal-throughput = "1.0.0"

构建和测试

只需使用cargo

cargo build
cargo test

贡献

请参阅贡献指南

依赖项

~8–18MB
~235K SLoC