Тестове

Както знаем, тестването е неразделна част от всеки софтуер. Ръждьо има първокласна поддръжка за единични (unit) и интеграционни тестове. Вижте глава 11 от „The Rust Programming Language”.

Там е описано как се пишат тестове. Можем да сложим единичните тестове в модулите, които те тестват, а интеграционните в отделна директория tests/:

foo
├── Cargo.toml
├── src
│   └── main.rs
│   └── lib.rs
└── tests
    ├── my_test.rs
    └── my_other_test.rs

Всеки файл в tests е отделен интеграционен тест, сиреч тест, който проверява библиотеката така, сякаш тя е извикана от зависим от нея кош.

Глава Тестване разглежда трите вида тестване: Единично, Документално и Интеграционно.

cargo предоставя лесен начин за изпълняване на всички тестове!

$ cargo test

Ще видите да се извежда следното на екрана:

$ cargo test
   Compiling blah v0.1.0 (file:///nobackup/blah)
    Finished dev [unoptimized + debuginfo] target(s) in 0.89 secs
     Running target/debug/deps/blah-d3b32b97275ec472

running 3 tests
test test_bar ... ok
test test_baz ... ok
test test_foo_bar ... ok
test test_foo ... ok

test result: ok. 3 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out

Можете също така да пускате тестове, чието име съвпада с даден образец:

$ cargo test test_foo
$ cargo test test_foo
   Compiling blah v0.1.0 (file:///nobackup/blah)
    Finished dev [unoptimized + debuginfo] target(s) in 0.35 secs
     Running target/debug/deps/blah-d3b32b97275ec472

running 2 tests
test test_foo ... ok
test test_foo_bar ... ok

test result: ok. 2 passed; 0 failed; 0 ignored; 0 measured; 2 filtered out

Имайте предвид следното: Cargo може да изпълнява няколко теста едновременно, така че се уверете, че те не си съперничат по някакъв начин.

Един пример как едновременността създава проблеми е когато два теста пишат в един и същи файл, както по-долу:

#![allow(unused)]
fn main() {
#[cfg(test)]
mod tests {
    // Внасяме нужните модули
    use std::fs::OpenOptions;
    use std::io::Write;

    // Този тест пише във файл
    #[test]
    fn test_file() {
        // Отваря файла ferris.txt или създава нов, ако не съществува.
        let mut file = OpenOptions::new()
            .append(true)
            .create(true)
            .open("ferris.txt")
            .expect("Failed to open ferris.txt");

        // Print "Ferris" 5 times.
        for _ in 0..5 {
            file.write_all("Ferris\n".as_bytes())
                .expect("Could not write to ferris.txt");
        }
    }

    // Този тест се опитва да пише в същия файл
    #[test]
    fn test_file_also() {
        // Отваря файла ferris.txt или създава нов, ако не съществува.
        let mut file = OpenOptions::new()
            .append(true)
            .create(true)
            .open("ferris.txt")
            .expect("Failed to open ferris.txt");

        // Print "Corro" 5 times.
        for _ in 0..5 {
            file.write_all("Corro\n".as_bytes())
                .expect("Could not write to ferris.txt");
        }
    }
}
}

Макар че намерението ни е да получим следното:

$ cat ferris.txt
Ferris
Ferris
Ferris
Ferris
Ferris
Corro
Corro
Corro
Corro
Corro

Това, което всъщност се въвежда във ferris.txt, е:

$ cargo test test_file
Corro
Ferris
Corro
Ferris
Corro
Ferris
Corro
Ferris
Corro
Ferris