文档测试

Rust 本身就支持文档测试：

#![allow(unused)]
fn main() {
/// Shortens a string to the given length.
///
/// ```
/// # use playground::shorten_string;
/// assert_eq!(shorten_string("Hello World", 5), "Hello");
/// assert_eq!(shorten_string("Hello World", 20), "Hello World");
/// ```
pub fn shorten_string(s: &str, length: usize) -> &str {
    &s[..std::cmp::min(length, s.len())]
}
}

• /// 注释中的代码块会自动被视为 Rust 代码。
• 代码会作为 cargo test 的一部分进行编译和执行。
• Adding # in the code will hide it from the docs, but will still compile/run it.
• 在 Rust Playground 上测试上述代码。