Поединично тестване
Тестовете в Ръждьо са функции, които проверяват дали друг – нетестов код, действа по очаквания начин. Телата на тестовите функции обикновено извършват някакви първоначални настройки, пускат кода, който искаме да тестваме, и след това установяват дали изходът от изпълнението на кода е каквото очакваме.
Повечето единични тестове се пишат в отделен модул с име tests и
атрибут #[cfg(test)]. Тестовите функции се обозначават с атрибута
#[test].
Тестовете се провалят, когато нещо в тестова функция се паникьоса
(извика panic!). Има някои помощни макроси:
assert!(израз)1 – паникьосва се, ако изразът се оцени катоfalse.assert_eq!(ляво, дясно)иassert_ne!(ляво, дясно)– проверяват се левият и десният израз за еднаквост и нееднаквост съответно.
pub fn add(a: i32, b: i32) -> i32 {
a + b
}
// Това е наистина калпава функция за събиране. Нейното предназначение в този
// пример е да се провали.
#[allow(dead_code)]
fn bad_add(a: i32, b: i32) -> i32 {
a - b
}
#[cfg(test)]
mod tests {
// Забележете този полезен устойчив израз. Така внасяме имена отвън в обхвата на
// `mod tests`.
use super::*;
#[test]
fn test_add() {
assert_eq!(add(1, 2), 3);
}
#[test]
fn test_bad_add() {
// Когато това потвърждение се изпълни, тестът ще се провали.
// Забележете, че частните функции също могат да бъдат тествани!
assert_eq!(bad_add(1, 2), 3);
}
}
Тестовете могат да бъдат пускани с cargo test.
$ cargo test
running 2 tests
test tests::test_bad_add ... FAILED
test tests::test_add ... ok
failures:
---- tests::test_bad_add stdout ----
thread 'tests::test_bad_add' panicked at 'assertion failed: `(left == right)`
left: `-1`,
right: `3`', src/lib.rs:21:8
note: Run with `RUST_BACKTRACE=1` for a backtrace.
failures:
tests::test_bad_add
test result: FAILED. 1 passed; 1 failed; 0 ignored; 0 measured; 0 filtered out
Тестове и ?
Нито един от предишните единични тестове нямаше тип за връщане. Но в Ръждьо
2018 тестовете могат да връщат Result<()>, което ви позволява да ползвате
? в тях! Това може да ги направи много по-кратки.
fn sqrt(number: f64) -> Result<f64, String> { if number >= 0.0 { Ok(number.powf(0.5)) } else { Err("отрицателни числа с плаваща запетая нямат квадратен корен".to_owned()) } } #[cfg(test)] mod tests { use super::*; #[test] fn test_sqrt() -> Result<(), String> { let x = 4.0; assert_eq!(sqrt(x)?.powf(2.0), x); Ok(()) } }
Вижте „Ръководството за изданията” за повече подробности.
Тестване на паника
За да тествате функции, които може да се паникьосат, използвайте
атрибута#[should_panic]. Този атрибут приема избираем параметър expected =
с текста на съобщението при паника. Ако вашата функция се паникьосва по
различни начини, трябва да се уверите, че тествате правилната паника.
pub fn divide_non_zero_result(a: u32, b: u32) -> u32 {
if b == 0 {
panic!("Divide-by-zero error");
} else if a < b {
panic!("Divide result is zero");
}
a / b
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn test_divide() {
assert_eq!(divide_non_zero_result(10, 2), 5);
}
#[test]
#[should_panic]
fn test_any_panic() {
divide_non_zero_result(1, 0);
}
#[test]
#[should_panic(expected = "Divide result is zero")]
fn test_specific_panic() {
divide_non_zero_result(1, 10);
}
}
Пускането на тези тестове ни дава:
$ cargo test
running 3 tests
test tests::test_any_panic ... ok
test tests::test_divide ... ok
test tests::test_specific_panic ... ok
test result: ok. 3 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out
Doc-tests tmp-test-should-panic
running 0 tests
test result: ok. 0 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out
Пускане на отделни тестове
За да пуснете точно определени тестове, можете да укажете името на теста при
изпълнение на командата cargo test.
$ cargo test test_any_panic
running 1 test
test tests::test_any_panic ... ok
test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 2 filtered out
Doc-tests tmp-test-should-panic
running 0 tests
test result: ok. 0 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out
За да пуснете множество тестове, можете да укажете част от име на тест, което съответства на всички тестове, които искате да пуснете.
$ cargo test panic
running 2 tests
test tests::test_any_panic ... ok
test tests::test_specific_panic ... ok
test result: ok. 2 passed; 0 failed; 0 ignored; 0 measured; 1 filtered out
Doc-tests tmp-test-should-panic
running 0 tests
test result: ok. 0 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out
Пропускане2 на тестове
Тестовете могат да бъдат отбелязани с атрибута #[ignore], за да ги изключите.
Или пък да ги пуснете с командата cargo test -- --ignored.
#![allow(unused)] fn main() { pub fn add(a: i32, b: i32) -> i32 { a + b } #[cfg(test)] mod tests { use super::*; #[test] fn test_add() { assert_eq!(add(2, 2), 4); } #[test] fn test_add_hundred() { assert_eq!(add(100, 2), 102); assert_eq!(add(2, 100), 102); } #[test] #[ignore] fn ignored_test() { assert_eq!(add(0, 0), 0); } } }
$ cargo test
running 3 tests
test tests::ignored_test ... ignored
test tests::test_add ... ok
test tests::test_add_hundred ... ok
test result: ok. 2 passed; 0 failed; 1 ignored; 0 measured; 0 filtered out
Doc-tests tmp-ignore
running 0 tests
test result: ok. 0 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out
$ cargo test -- --ignored
running 1 test
test tests::ignored_test ... ok
test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out
Doc-tests tmp-ignore
running 0 tests
test result: ok. 0 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out
Б. пр.
потвърждавам – assert
пренебрегвам – ignore. В случая – „пропускам”
устойчив израз, идиом – idiom