Testes de Documentação

Rust tem suporte embutido para testes de documentação:

#![allow(unused)]
fn main() {
/// Encurta uma string para o comprimento especificado.
///
/// ```
/// use playground::encurtar_string;
/// assert_eq!(encurtar_string("Olá Mundo", 4), "Olá");
/// assert_eq!(encurtar_string("Olá Mundo", 20), "Olá Mundo");
/// ```
pub fn shorten_string(s: &str, length: usize) -> &str {
    &s[..std::cmp::min(length, s.len())]
}
}

• Blocos de código em comentários /// são vistos automaticamente como código Rust.
• O código será compilado e executado como parte do cargo test.
• Teste o código acima no Rust Playground.