aliri_braid

提高和强化您的字符串

强类型化的 API 减少了传递未类型化字符串时的错误和混淆。Braid 通过使创建字符串值的包装变得无痛，帮助实现这一目标，确保每次都正确地使用它们。

以下是关于编织的文档和实现示例，以及 aliri_braid_examples 仓库文档中的示例。

使用方法

通过将 #[braid] 添加到结构定义中创建编织。宏将负责自动更新结构的表示以包装字符串并生成强类型的借用形式。

use aliri_braid::braid;

#[braid]
pub struct DatabaseName;

还支持自定义字符串类型的编织，只要它们实现了一组预期的特质。如果没有指定，将使用当前命名空间中名为 String 的类型。

use aliri_braid::braid;
use compact_str::CompactString as String;

#[braid]
pub struct UserId;

一旦创建，编织就可以作为强类型、不可变的字符串传递。

fn take_strong_string(n: DatabaseName) {}
fn borrow_strong_string(n: &DatabaseNameRef) {}

let owned = DatabaseName::new(String::from("mongo"));
borrow_strong_string(&owned);
take_strong_string(owned);

编织也可以用于字符串化接口。

fn take_raw_string(s: String) {}
fn borrow_raw_str(s: &str) {}

let owned = DatabaseName::new(String::from("mongo"));
borrow_raw_str(owned.as_str());
take_raw_string(owned.take());

有关更多信息，请参阅 docs.rs 上的文档。