human-repr

生成字节、持续时间甚至吞吐量的美丽的人类可读表示！

简介

这个crate提供了一套完整的

• 计数功能，默认支持SI前缀：k、M、G、T、P、E、Z和Y，包括可选的IEC前缀和“混合”前缀（见Rust特性）。
• 持续时间，支持SI前缀ns、µs和ms用于亚秒值，还包括一些自定义格式，如M:SS.s（分钟:秒，保留1位小数）和H:MM:SS（小时:分钟:秒）用于大于60秒的值。
• 吞吐量，支持SI接受的/d、/h、/min和/s，当为每秒时，它甚至得到SI前缀，这是最快的。

此外，这个crate没有任何依赖项，经过良好的测试，并且非常快，生成表示的时间不到50ns！通过criterion基准测试验证。

它们与任何Rust原始数字以及Duration一起工作！

// counts (bytes, bare, or any custom unit).
use human_repr::HumanCount;
assert_eq!("43.21GB", 43214321123_u64.human_count_bytes());
assert_eq!("74.9M", 74893200.human_count_bare());
assert_eq!("540.5kPackets", 540464_u32.human_count("Packets"));
assert_eq!("48.1°C", 48.132323432.human_count("°C"));
assert_eq!("123k🦀", 123e3.human_count("🦀"));

// durations with primitives.
use human_repr::HumanDuration;
assert_eq!("1.8ns", 0.0000000018.human_duration());
assert_eq!("15.6µs", 0.0000156.human_duration());
assert_eq!("10ms", 0.01.human_duration());
assert_eq!("3.44s", 3.435999.human_duration());
assert_eq!("19:20.4", 1160.36.human_duration());
assert_eq!("1:14:48", 4488u16.human_duration());

// durations with std's Duration.
use std::time::Duration;
assert_eq!("15.6µs", Duration::from_nanos(15_600).human_duration());
assert_eq!("10ms", Duration::from_secs_f64(0.01).human_duration());
assert_eq!("1:14:48", Duration::new(4488, 395_000_000).human_duration());

// throughputs (bytes, bare, or any custom unit).
use human_repr::HumanThroughput;
assert_eq!("1.2MB/s", 1248632.human_throughput_bytes());
assert_eq!("9/d", 0.000104166666667.human_throughput_bare());
assert_eq!("6.1tests/min", 0.101265.human_throughput("tests"));
assert_eq!("54°C/h", 0.015.human_throughput("°C"));
assert_eq!("123M⭐/s", 123e6.human_throughput("⭐"));

📌 1.1系列的新增功能

这个版本主要

• 包括一个用于serde的可选功能；
• 使用 Cow 来代替泛型单位（可能更优化的二进制）；
• 将吞吐量中的分钟符号从 m 改为 min（这似乎是实际接受的SI符号）。
  同时完善了所有细节。

# use human_repr::{HumanDuration, HumanThroughput};
assert_eq!("HumanDuration { val: 1.56e-5 } -> 15.6µs", format!("{:?}", 0.0000156.human_duration()));
assert_eq!(r#"HumanThroughput { val: 0.015, unit: "°C" } -> 54°C/h"#, format!("{:?}", 0.015.human_throughput("°C")));

如何使用它

将此依赖项添加到你的Cargo.toml文件

human-repr = "1"

然后只需使用所需的特性！

use human_repr::{HumanCount, HumanDuration, HumanThroughput};

3000_u16.human_count("bytes");
(-5i8).human_count_bytes();

4244.32_f32.human_duration();
0.000000000004432_f64.human_duration();
# use std::time::Duration;
Duration::from_secs_f64(0.00432).human_duration();

8987_isize.human_throughput("transactions");
93321_usize.human_throughput_bytes();

它们适用于所有Rust原生数字类型：u8、u16、u32、u64、u128、usize、f32、f64、i8、i16、i32、i64、i128、isize，以及 Duration 类型。