Rust编程-编写自动化测试

编写单元测试步骤：

1. 准备所需的数据

2. 调用需要测试的代码

3. 断言运行结果与我们所期望的一致

Rust的test元数据：

#[cfg(test)]：是一个属性宏（attribute macro）。用于控制特定的代码段仅在测试环境中编译。

#[cfg(test)]
mod tests {// 测试函数#[test]fn my_test() {// 测试代码}
}

#[cfg(test)]的作用是确保tests模块内的代码仅在执行cargo test命令时被编译和运行。

cfg还可以用于更复杂的条件编译场景：

#[cfg(target_os = "linux")]
fn os_specific_function() {// Linux-specific code
}#[cfg(target_os = "windows")]
fn os_specific_function() {// Windows-specific code
}

cfg指定目标操作系统，选择性的编译代码

#[test] 关键字：表示是测试函数

测试函数：将#[test] 添加到fn关键字的上一行就将函数转变为测试函数

单元测试执行命令：

cargo test命令来运行测试

这个命令会构建并执行一个用于测试的可执行文件,该文件在执行过程中会逐一调用所有标注了test属性的函数，并生成统计测试运行成功或失败的报告。

Rust能够编译在API文档中出现的任何代码示例

assert_eq! 宏

 assert_eq!(2 + 2, 4);

用于断言两个值相等。如果不相当则panic，单元测试失败

assert_ne!宏：

断言两个值不相等，单元测试则通过

确定它绝不可能是某些值的时候的使用

总结：

assert_eq! 和assert_ne! 宏分别使用了==和!=运算符来进行判断，并在断言失败时使用调试输出格式（{:?}）将参数值打印出来，它们的参数必须同时实现PartialEq和Debug这两个trait

这两个trait都是可派生trait，可以通过在自定义的结构体或枚举的定义的上方添加#[derive(PartialEq, Debug)]标注来自动实现这两个trait。

assert! 宏检查结果

assert! 宏由标准库提供，它可以确保测试中某些条件的值为true

assert! 宏可以检查代码是否按照我们预期的方式运行。

assert! 宏接收一个能够被计算为布尔类型的值作为参数：当这个值为true时，assert! 宏正常通过测试。当值为false时，assert! 宏就会调用panic! 宏，进而导致测试失败。

assert!宏传入两个值==，则等价于assert_eq!

添加自定义的错误提示信息

任何在assert!、assert_eq! 或assert_ne! 的必要参数之后出现的参数都会一起被传递给format! 宏：

assert!(result.contains("Carol"),"Greeting did not contain name, value was `{}`", result
)

其中，第二个参数会被传给format！宏

should_panic检查panic

should_panic：编写一个测试来检查使用了非法值是否会如期发生panic

新属性：should_panic。标记了这个属性的测试函数会在代码发生panic时顺利通过，而在代码不发生panic时执行失败。

将#[should_panic]属性放在了#[test]属性之后、对应的测试函数之前

pub struct Guess{value:u32,
}impl Guess{pub fn new(value:u32) ->  Guess{if value <1 || value > 100{panic!("Guess value must be between 1 and 100,got {}",value);}Guess{value}}
}#[cfg(test)]mod tests{use super::*;#[test]#[should_panic]fn greater_than_100(){Guess::new(200);}
}

should_panic属性中添加可选参数expected,让should_panic测试更加精确一些

#[should_panic(expected = "Guess value must be less than or equal to 100")]fn greater_than_100() {

测试某个条件会触发带有特定错误提示信息的panic!

使用Result<T, E>编写测试:

#[cfg(test)]
mod tests{use super::*;#[test]fn it_works() -> Result<(),String>{if 2+2 == 4{Ok(())}else {Err(String::from("two plus two does not equal for"))}}
}

不要在使用Result<T, E>编写的测试上标注#[should_panic]

编写返回Result<T, E>的测试，就可以在测试函数体中使用问号运算符了。

在测试运行失败时，我们应当直接返回一个Err值