Perché non stampare! lavorare nei test unitari di Rust?

Ho implementato il seguente metodo e unit test:

use std::fs::File;
use std::path::Path;
use std::io::prelude::*;

fn read_file(path: &Path) {
    let mut file = File::open(path).unwrap();
    let mut contents = String::new();
    file.read_to_string(&mut contents).unwrap();
    println!("{}", contents);
}

#[test]
fn test_read_file() {
    let path = &Path::new("/etc/hosts");
    println!("{:?}", path);
    read_file(path);
}

Eseguo il test dell'unità in questo modo:

rustc --test app.rs; ./app

Potrei anche eseguirlo con

cargo test

Ricevo un messaggio che dice che il test è stato superato ma println!non viene mai visualizzato sullo schermo. Perchè no?

Ciò accade perché i programmi di test Rust nascondono lo stdout di test riusciti affinché l'output del test sia ordinato. È possibile disabilitare questo comportamento passando l' --nocaptureopzione al binario di prova o a cargo test:

#[test]
fn test() {
    println!("Hidden output")
}

Invocare i test:

% rustc --test main.rs; ./main

running 1 test
test test ... ok

test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured

% ./main --nocapture

running 1 test
Hidden output
test test ... ok

test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured

% cargo test -- --nocapture

running 1 test
Hidden output
test test ... ok

test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured

Se i test falliscono, tuttavia, il loro stdout verrà stampato indipendentemente dal fatto che questa opzione sia presente o meno.

TL; DR

$ cargo test -- --nocapture

Con il seguente codice:

#[derive(Copy, Clone, Debug, PartialEq, Eq)]
pub enum PieceShape {
    King, Queen, Rook, Bishop, Knight, Pawn
}

fn main() {
    println!("Hello, world!");
}

#[test]
fn demo_debug_format() {
    let q = PieceShape::Queen;
    let p = PieceShape::Pawn;
    let k = PieceShape::King;
    println!("q={:?} p={:?} k={:?}", q, p, k);
}

Quindi eseguire quanto segue:

 $ cargo test -- --nocapture

E dovresti vedere

Running target/debug/chess-5d475d8baa0176e4

running 1 test
q=Queen p=Pawn k=King
test demo_debug_format ... ok

test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured

Per includere stampe con println!()e conservare i colori per i risultati del test, utilizzare i flag colore nocapturein cargo test.

$ cargo test -- --color always --nocapture

(versione cargo: 0.13.0 per notte)

Durante il test, l'output standard non viene visualizzato. Non utilizzare i messaggi di testo per il test, ma assert!, assert_eq!e fail!invece. Il sistema di test unitari di Rust è in grado di comprendere questi ma non i messaggi di testo.

Il test che hai scritto passerà anche se qualcosa va storto. Vediamo perché:

read_to_endla firma è fn read_to_end(&mut self) -> IoResult<Vec<u8>>

Restituisce un IoResultper indicare successo o errore. Questo è solo un tipo def per a il Resultcui valore di errore è un IoError. Sta a te decidere come gestire un errore. In questo caso, vogliamo che l'attività fallisca, il che viene fatto chiamando unwrapil Result.

Questo funzionerà:

let contents = File::open(&Path::new("message.txt"))
    .read_to_end()
    .unwrap();

unwrap non dovrebbe essere abusato però.