你需要知道的 32 個 Rust 庫 - 1
1，Tap
Tap crate 可以將函數調用鏈從前綴表示法轉換爲後綴表示法，這可以使你編寫更具可讀性的代碼。
用例子來解釋是最容易的，例如，一個像這樣的調用鏈：
let val = last(
third(
second(first(original_value), another_arg)
),
another_arg,
);可以重寫爲：
let val = original_value
.pipe(first)
.pipe(|v| second(v, another_arg))
.pipe(third)
.pipe(|v| last(v, another_arg));2，Strum
在 Rust 中使用枚舉時，Strum crate 有助於擺脫樣板代碼，該功能是通過派生宏實現的。
例如：
1，strum::Display：爲 enum 實現 std::fmt::Display，因此也實現了 to_string() -> String 方法。
2，strum::AsRefStr：實現 AsRef<&static str>，因此，它不需要像使用 to_string() 那樣分配內存。
3，strum::IntoStaticStr：實現 “From for &'static str”，工作原理類似於上一個選項。
4，strum::EnumString：實現 std::str::FromStr 和 std::convert::TryFrom<&str>，允許將字符串轉換爲 enum 實例。
5，strum::EnumCount：添加常量 COUNT: usize，值爲枚舉變量的數量。
6，strum::EnumIter：在枚舉變量上實現迭代器，變量中的數據將被設置爲 Default:: Default()。
使用上述宏的例子：
#[derive(
Debug,
PartialEq,
strum::Display,
strum::IntoStaticStr,
strum::AsRefStr,
strum::EnumString,
strum::EnumCount,
strum::EnumIter,
)]
enum Color {
Red,
Blue(usize),
Green { range: usize },
}
fn main() {
assert_eq!(Color::Blue(2).to_string(), "Blue");
assert_eq!(Color::Green { range: 5 }.as_ref(), "Green");
assert_eq!(<&str>::from(Color::Red), "Red");
assert_eq!(Color::Red, Color::from_str("Red").unwrap());
assert_eq!(Color::COUNT, 3);
assert_eq!(
Color::iter().collect::<Vec<_>>(),
vec![Color::Red, Color::Blue(0), Color::Green { range: 0 }]
);
}此外，Strum 的不同宏支持行爲定製。例如，可以使用屬性 #[strum(serialize = "redred")] 更改將被轉換爲 enum 實例的字符串。
3，derive_more
NewType 模式在 Rust 中非常常見。有時需要在我們自己的結構中封裝第三方庫類型：
pub struct NonEmptyVec(Vec<i32>);derive_more，本質上是樣板代碼，因爲它複製了 Rust 內部 trait 的現有實現，因此不需要我們自己去實現這些 trait。我們只需爲封裝器結構添加派生宏的使用：
#[derive(derive_more::AsRef, derive_more::Deref, derive_more::IntoIterator, derive_more::Index)]
pub struct NonEmptyVec(Vec<i32>);檢查這是否有效：
fn collector(iter: impl IntoIterator<Item = i32>) -> Vec<i32> {
iter.into_iter().collect()
}
#[test]
fn non_emtpy_vec() -> Result<()> {
assert!(NonEmptyVec::new(vec![]).is_err());
let non_empty = NonEmptyVec::new(vec![1, 2, 3])?;
assert_eq!(non_empty.as_ref(), &[1, 2, 3]);
assert_eq!(non_empty.deref(), &[1, 2, 3]);
assert_eq!(non_empty[1], 2);
assert_eq!(collector(non_empty), vec![1, 2, 3]);
Ok(())
}這個 crate 包含了用於生成轉換特徵 (From, IntoIterator, AsRef 等)，格式化特徵(類似 display)，操作符特徵(Add, Index 等) 的宏。
4，derive_builder
Rust 中最流行的模式之一是構建器模式，當需要創建包含許多字段的複雜結構時，此模式非常方便。
使用 derive_more crate，可以自動生成構建器模式，使代碼更簡潔：
#[derive(Debug, Eq, PartialEq, Default, derive_builder::Builder)]
#[builder(pattern = "immutable")]
#[builder(default)]
#[builder(setter(strip_option))]
struct Calculation {
a: Option<i32>,
b: Option<i32>,
c: Option<i32>,
d: Option<i32>,
// ... can be more optional fields
}
fn derive_builder() -> Result<()> {
let builder = CalculationBuilder::default();
builder.a(1).build()?;
builder.a(6).d(7).build()?;
builder.b(2).c(3).build()?;
Ok(())
}derive_more crate 還支持構建方法中的字段驗證。
5，insta
用於快照測試的庫。快照表示測試的預期結果，通常存儲在單獨的文件中。該庫提供了一個命令行實用程序，可以方便地更新快照。
其中一個有用的功能是編輯。它允許測試隨機或不確定順序的字段值，例如 HashSet：
#[derive(serde::Serialize)]
pub struct User {
id: Uuid,
username: String,
flags: HashSet<&'static str>,
}
#[test]
fn redactions() {
let user = User {
id: Uuid::new_v4(),
username: "john_doe".to_string(),
flags: maplit::hashset! {"zzz", "foo", "aha"},
};
insta::assert_yaml_snapshot!(user, {
".id" => "[uuid]",
".flags" => insta::sorted_redaction()
});
}對於這個測試，自動生成快照 snapshots/insta__tests__redactions.snap，包含以下內容：
---
source: src/bin/insta.rs
expression: user
---
id: "[uuid]"
username: john_doe
flags:
- aha
- foo
- zzz6，enum_dispatch
Rust 通過靜態和動態分派特性來支持多態性。如果你使用過動態分派，就知道它會對程序的性能產生負面影響，因爲 trait 的實現是在運行時通過虛函數表查找的。
而 enum_dispatch 庫使用枚舉將動態分派轉換爲靜態分派。假設我們有這樣一個 trait 和它的實現：
pub trait ReturnsValue {
fn return_value(&self) -> usize;
}
pub struct Zero;
impl ReturnsValue for Zero {
fn return_value(&self) -> usize {
0
}
}
pub struct Any(usize);
impl ReturnsValue for Any {
fn return_value(&self) -> usize {
self.0
}
}在這個例子的測試中，我們使用了動態分派：
#[test]
fn derive_dispatch_dynamic() {
let values: Vec<Box<dyn ReturnsValue>> = vec![Box::new(Zero {}), Box::new(Any(5))];
assert_eq!(
values
.into_iter()
.map(|dispatched| dispatched.return_value())
.collect::<Vec<_>>(),
vec![0, 5]
);
}現在讓我們使用 enum_dispatch：
#[enum_dispatch::enum_dispatch]
pub trait ReturnsValue {
fn return_value(&self) -> usize;
}
// trait implementations are same
#[enum_dispatch::enum_dispatch(ReturnsValue)]
pub enum EnumDispatched {
Zero,
Any,
}
#[test]
fn derive_dispatch_static() {
let values = vec![EnumDispatched::Zero(Zero {}), EnumDispatched::Any(Any(5))];
assert_eq!(
values
.into_iter()
.map(|dispatched| dispatched.return_value())
.collect::<Vec<_>>(),
vec![0, 5]
);
}經過測試，這樣的實現可以將 trait 的使用速度提高 10-12 倍。
本文由 Readfog 進行 AMP 轉碼，版權歸原作者所有。
來源：https://mp.weixin.qq.com/s/0VMEWOm8_q98uMlsbN3dVA