【Rust日报】2022-12-28 Rust 中的原生反射

MikeLoveRust

发布于 2023-02-15 18:59:48

7040

Rust 中的原生反射

反射是程序检查自身结构和行为的能力。例如，在 Javascript 中，可以编写迭代任意对象的键值对的程序，或者检查对象是否包含给定名称的字段。Deflect 为 Rust 带来了其中的一些功能。deflect 的核心是它的 Reflect 特性，它适用于所有类型。有了它，您可以：

恢复任何特征对象的具体类型
按名称索引或迭代 a 的字段struct
检查捕获的闭包数据
检查 Rustasync fn 生成器的内部结构
优雅打印任意数据（即使它没有实现Debug！）
https://jack.wrenn.fyi/blog/deflect/

文档即代码

Mermaid 工具的支持极大地增强了 rust-docs 和项目文档的整体表现力！Mermaid 是一个允许我们创建流程图、图形、图表、序列图、状态机、甘特图和类图等的工具。例如图表可以添加到函数的 rust-doc 的文档中，显示在 HTML 输出中 cargo doc

#[cfg_attr(doc, aquamarine::aquamarine)]
/// A function showcasing aquamarine defaults
///
/// With aquamarine it's possible to embed Mermaid diagrams into your Rust documentation using the code snippets
/// 
/// ```mermaid
/// graph LR
///     s([Source]) --> a[[aquamarine]]
///     r[[rustdoc]] --> f([Docs w/ Mermaid!])
///     subgraph rustc[Rust Compiler]
///     a -. inject mermaid.js .-> r
///     end
/// ```
///
/// The diagram is going to be located in place of the code snippet
///
/// Dark mode is automatically enabled if `dark` or `ayu` rustdoc theme is selected.
///
/// You might need to reload the page to redraw the diagrams after changing the theme.
pub fn example() {}