【Rust自学】12.6. 使用TDD(测试驱动开发)开发库功能

🕗 发布于 2025-01-15 16:04 rust 开发语言 后端重构

12.6.0. 写在正文之前

第12章要做一个实例的项目——一个命令行程序。这个程序是一个grep(Global Regular Expression Print)，是一个全局正则搜索和输出的工具。它的功能是在指定的文件中搜索出指定的文字。

这个项目分为这么几步：

接收命令行参数
读取文件
重构：改进模块和错误处理
使用TDD（测试驱动开发）开发库功能（本文）
使用环境变量
将错误信息写入标准错误而不是标准输出

喜欢的话别忘了点赞、收藏加关注哦（加关注即可阅读全文），对接下来的教程有兴趣的可以关注专栏。谢谢喵！(=^･ω･=)
请添加图片描述

12.6.1. 回顾

以下是截止到上一篇文章为止所写出的全部代码。

lib.rs:

use std::error::Error;  
use std::fs;  
  
pub struct Config {  
    pub query: String,  
    pub filename: String,  
}  
  
impl Config {  
    pub fn new(args: &[String]) -> Result<Config, &'static str> {  
        if args.len() < 3 {  
            return Err("Not enough arguments");  
        }  
        let query = args[1].clone();  
        let filename = args[2].clone();  
        Ok(Config { query, filename})  
    }  
}  
  
pub fn run(config: Config) -> Result<(), Box<dyn Error>> {  
    let contents = fs::read_to_string(config.filename)?;  
    println!("With text:\n{}", contents);  
    Ok(())  
}

main.rs:

use std::env;  
use std::process;  
use minigrep::Config;  
  
fn main() {  
    let args:Vec<String> = env::args().collect();  
    let config = Config::new(&args).unwrap_or_else(|err| {  
        println!("Problem parsing arguments: {}", err);  
        process::exit(1);  
    });  
    if let Err(e) = minigrep::run(config) {  
        println!("Application error: {}", e);  
        process::exit(1);  
    }  
}

在前几节中我们完成了对业务逻辑的迁移，把它分离到lib.rs里。这样对编写测试帮助很大，因为lib.rs中的逻辑不需要在命令行下运行就可以直接使用不同的参数调用业务功能函数，并校验其返回值，也就是针对业务逻辑进行测试。

12.6.2. 什么是测试驱动开发TDD

TDD是Test-Driven Development的缩写，中文名为测试驱动开发，一般遵循以下步骤：

编写一个会失败的测试，运行该测试，并确保它是按照预期的原因失败
编写或修改刚好足够的代码，让新测试通过
重构刚刚添加或修改的代码，确保测试会通过
返回步骤1，继续

TDD只是众多软件开发方法中的一种，但是它能对代码的设计工作起到指导和帮助的作用。先编写测试，然后再编写能够通过测试的代码也有助于开发过程中保持较高的测试覆盖率。

本篇文章会通过测试驱动开发的步骤完成程序的搜索逻辑——在文件内容中搜索指定的字符串，将符合的内容的行数放在一个列表中。这个函数会被命名为search。

12.6.3. 修改代码

按照TDD的步骤来写代码：

1. 编写会失败的测试

首先到lib.rs里编写一个测试模块：

#[cfg(test)]  
mod tests {  
    use super::*;  
  
    #[test]  
    fn one_result() {  
        let query = "duct";  
        let contents = "\  
Rust: 
safe, fast, productive.  
Pick three.";  
        assert_eq!(vec!["safe, fast, productive."],search(query, contents));  
    }  
}

也就是说，因为query存储的"duct"在"safe, fast, productive.“这一行，所以返回值会是元素为String的Vector，并且只有一个元素，内容会是"safe, fast, productive.”

返回值是Vector是因为search函数预期能处理多个符合的结果，当然这个测试函数只可能有一个结果，这个测试函数取名叫one_result也是因为如此。

写好了测试模块，接下来写search函数：

pub fn search<'a>(query: &str, contents: &'a str) -> Vec<&'a str> {  
    vec![]  
}

为了让这个函数能被外部函数调用，得使用pub来声明为公共的
这个函数得加生命周期标志，因为有多个非self的参数，Rust无法判断哪个参数的生命周期跟返回值的生命周期相同。
返回值Vector内的元素是字符串切片，是从contents截取的，所以返回值应和contents的生命周期相同，所以给它们两个标注了一样的生命周期'a，而query则不需要生命周期标注。
函数内容只需要确保能通过编译即可，因为TDD的第一步是编写一个会出错的测试，所以出错才是想要的结果。

测试结果：

$ cargo test
   Compiling minigrep v0.1.0 (file:///projects/minigrep)
    Finished `test` profile [unoptimized + debuginfo] target(s) in 0.97s
     Running unittests src/lib.rs (target/debug/deps/minigrep-9cd200e5fac0fc94)

running 1 test
test tests::one_result ... FAILED

failures:

---- tests::one_result stdout ----
thread 'tests::one_result' panicked at src/lib.rs:44:9:
assertion `left == right` failed
  left: ["safe, fast, productive."]
 right: []
note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace


failures:
    tests::one_result

test result: FAILED. 0 passed; 1 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s

error: test failed, to rerun pass `--lib`

这个测试失败了，但没问题，这就是TDD第一步想要的结果。

2. 编写或修改刚好足够的代码，让新测试通过

第一步完成，接下来执行TDD的第二步：编写或修改刚好足够的代码，让新测试通过。

思考search的思路，应该是遍历contents的每一行，在遍历的时候查找是否有符合query的字符串，有就把这一行放到返回值的列表中；如果没有，什么都不做，遍历下一行。最后把所有结果放到Vector里返回即可。

对于遍历每一行，可以使用lines方法，它会返回一个迭代器（13章会细讲），会把字符串的内容一行一行地返回。
对于查找是否有符合query的字符串，可以使用contains方法，它返回的是一个布尔类型，有符合的就返回true，反之则为false。
最后别忘了，要把符合的行放到Vector里。

根据以上这些知识，就可以写出代码了：

pub fn search<'a>(query: &str, contents: &'a str) -> Vec<&'a str> {  
    let mut results = Vec::new();  
    for line in contents.lines() {  
        if line.contains(query) {  
            results.push(line);  
        }  
    }  
    results  
}

注意：这里results不用显示声明元素类型是因为下文中往这个Vector里添加了line这个&str类型，Rust推断出results里的元素类型是&str。

现在运行一下测试：

$ cargo test
   Compiling minigrep v0.1.0 (file:///projects/minigrep)
    Finished `test` profile [unoptimized + debuginfo] target(s) in 1.22s
     Running unittests src/lib.rs (target/debug/deps/minigrep-9cd200e5fac0fc94)

running 1 test
test tests::one_result ... ok

test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s

     Running unittests src/main.rs (target/debug/deps/minigrep-9cd200e5fac0fc94)

running 0 tests

test result: ok. 0 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s

   Doc-tests minigrep

running 0 tests

test result: ok. 0 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s

测试通过，没有问题。

3. 在`run`函数中使用`search`函数

search函数目前写好了，那就可以在run函数中调用了：

pub fn run(config: Config) -> Result<(), Box<dyn Error>> {  
    let contents = fs::read_to_string(config.filename)?;  
    for line in search(&config.query, &contents) {  
        println!("{}", line);  
    }  
    Ok(())  
}

通过循环的方式找到符合的一行就立马打印出来。

试运行一下：

$ cargo run -- frog poem.txt
   Compiling minigrep v0.1.0 (file:///projects/minigrep)
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.38s
     Running `target/debug/minigrep frog poem.txt`
How public, like a frog

这个例子只有单行，试试有多行的字符：

$ cargo run -- body poem.txt
   Compiling minigrep v0.1.0 (file:///projects/minigrep)
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.0s
     Running `target/debug/minigrep body poem.txt`
I'm nobody! Who are you?
Are you nobody, too?
How dreary to be somebody!

试一个没有的词汇：

$ cargo run -- monomorphization poem.txt
   Compiling minigrep v0.1.0 (file:///projects/minigrep)
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.0s
     Running `target/debug/minigrep monomorphization poem.txt`

原文地址：https://blog.csdn.net/weixin_71793197/article/details/145128763

免责声明：本站文章内容转载自网络资源，如本站内容侵犯了原著者的合法权益，可联系本站删除。更多内容请关注自学内容网（zxcms.com）！

上一篇：ubuntu24.04安装docker显卡工具包nvidia-container-toolkit
下一篇：25/1/14 嵌入式笔记学习ESP32

深入学习 Python 爬虫：从基础到实战
爬虫，顾名思义，是一种自动化的网络数据抓取程序。它通过模拟人类的浏览行为，向指定的 Web 服务器发送请求，获取网页数据，然后从中提取出有用的信息。获取公共网站的数据。监控某些网页的变化。搜集数据用于
阅读更多2025-01-15
网络原理（九）：数据链路层 - 以太网协议 & 应用层 - DNS 协议
数据链路层 - 以太网协议, mac 地址, MTU, ARP & 应用层 - DNS 协议
阅读更多2025-01-15
20250114面试鸭特训营第22天
20250114面试鸭特训营第22天
阅读更多2025-01-15
0112java面经
如果当前存在事务，则加入该事务；如果当前没有事务，则创建一个新事务。示例场景与代码示例假设我们有两个方法。
阅读更多2025-01-15
Linux ssh连接算法配置
在Linux系统中，SSH连接的算法配置主要涉及密钥交换算法、加密算法和消息认证码算法。
阅读更多2025-01-15
操作系统之磁盘
磁盘上的每个扇区都可以通过一个三元组地址来唯一标识，即柱面号（磁道号）、盘面号（磁头号）和扇区号（块号）。例如，磁盘通常是按扇区顺序读取的，而光盘通常是从中心向外读取的。：磁盘盘面上的数据存储在一组同
阅读更多2025-01-15
【容器逃逸实践】挂载/dev方法
通过配置–privileged参数可以让docker以特权模式启动，当容器以特权模式启动时，docker容器可以访问主机上的所有设备，且有mount命令挂载权限。
阅读更多2025-01-15
Linux 服务器挖矿木马防护实战：快速切断、清理与加固20250114
详解Linux服务器挖矿木马的快速响应、全面清理和系统加固方案，助力运维人员提升应急处置能力。
阅读更多2025-01-15
Golang——并发控制
本文介绍Go并发，同步，顺序执行，设计的一些常见的场景，顺序执行主要用channel实现。在这种同步信号的使用场景中，使用无缓冲通道，可以选择不关闭通道。
阅读更多2025-01-15
c#删除文件和目录到回收站
之前在c++上遇到过这个问题，折腾许久才解决了，这次在c#上再次遇到这个问题，不过似乎容易了一些，亲测代码如下，两种删除方式都写在代码中了。
阅读更多2025-01-15