使用环境变量实现Rust程序中的不区分大小写搜索
步骤 1：编写失败的测试
我们遵循测试驱动开发（TDD）方法，首先编写一个测试来验证不区分大小写搜索功能。由于我们尚未实现该功能，因此这个测试会失败。以下是测试代码：
#[cfg(test)]
mod tests {
use super::*;
// 测试：区分大小写的搜索
#[test]
fn case_sensitive() {
let query = "duct";
let contents = "\
Rust:
safe, fast, productive.
Pick three.
Duct tape.";
// 期望返回大小写敏感的匹配结果
assert_eq!(vec!["safe, fast, productive."], search(query, contents));
}
// 测试：不区分大小写的搜索
#[test]
fn case_insensitive() {
let query = "rUsT"; // 查询字符串的大小写不一致
let contents = "\
Rust:
safe, fast, productive.
Pick three.
Trust me.";
// 期望返回不区分大小写的匹配结果
assert_eq!(
vec!["Rust:", "Trust me."],
search_case_insensitive(query, contents)
);
}
}
在上述代码中：
case_sensitive测试验证了原始的区分大小写的搜索。case_insensitive测试验证了我们将在后面实现的不区分大小写的搜索。此时，由于我们还没有实现search_case_insensitive函数，编译将失败。
步骤 2：实现 search_case_insensitive 函数
为了实现不区分大小写的搜索，我们需要修改 search 函数，使其能够忽略大小写。以下是 search_case_insensitive 函数的实现：
// 不区分大小写的搜索函数
pub fn search_case_insensitive<'a>(
query: &str, // 查询字符串
contents: &'a str, // 文件内容
) -> Vec<&'a str> {
let query = query.to_lowercase(); // 将查询字符串转换为小写
let mut results = Vec::new(); // 存储匹配结果
// 遍历文件中的每一行
for line in contents.lines() {
// 将每一行转换为小写再进行比较
if line.to_lowercase().contains(&query) {
results.push(line); // 如果匹配，加入结果列表
}
}
results // 返回匹配的行
}
代码解释：
query.to_lowercase()将查询字符串转换为小写，以确保不区分大小写地进行匹配。line.to_lowercase()将每一行内容转换为小写，并检查是否包含查询字符串。
步骤 3：修改 run 函数
run 函数是程序的核心，它负责执行搜索并输出结果。我们需要修改 run 函数，使其根据 Config 结构体中的 ignore_case 字段来决定是使用区分大小写的 search 函数，还是不区分大小写的 search_case_insensitive 函数。
// 根据配置运行搜索
pub fn run(config: Config) -> Result<(), Box<dyn Error>> {
let contents = fs::read_to_string(config.file_path)?; // 读取文件内容
// 根据 ignore_case 字段决定使用哪种搜索
let results = if config.ignore_case {
search_case_insensitive(&config.query, &contents) // 不区分大小写的搜索
} else {
search(&config.query, &contents) // 区分大小写的搜索
};
// 打印匹配的行
for line in results {
println!("{line}");
}
Ok(())
}
代码解释：
Config结构体包含一个ignore_case字段，用于控制是否启用不区分大小写的搜索。- 根据
ignore_case的值，我们决定调用search还是search_case_insensitive。
步骤 4：获取环境变量
现在，我们需要从环境变量中获取 IGNORE_CASE 的值，来决定是否启用不区分大小写的搜索。我们使用 Rust 标准库中的 env 模块来访问环境变量。
use std::env;
impl Config {
// 构建 Config 实例
pub fn build(args: &[String]) -> Result<Config, &'static str> {
if args.len() < 3 {
return Err("not enough arguments");
}
let query = args[1].clone();
let file_path = args[2].clone();
// 检查环境变量 IGNORE_CASE 是否设置
let ignore_case = env::var("IGNORE_CASE").is_ok(); // 如果环境变量存在，则启用不区分大小写的搜索
Ok(Config {
query,
file_path,
ignore_case,
})
}
}
代码解释：
- 我们使用
env::var("IGNORE_CASE").is_ok()来检查环境变量IGNORE_CASE是否被设置。如果设置了该环境变量，我们将ignore_case设置为true，否则默认为false。
步骤 5：运行程序
现在，我们的程序已经支持根据环境变量来控制搜索模式。你可以通过以下命令来运行程序：
- 不使用环境变量，执行区分大小写的搜索：
$ cargo run -- to poem.txt
- 设置环境变量
IGNORE_CASE=1，启用不区分大小写的搜索：
$ IGNORE_CASE=1 cargo run -- to poem.txt
对于 PowerShell 用户，可以使用以下命令：
PS> $Env:IGNORE_CASE=1; cargo run -- to poem.txt
总结
通过使用环境变量，我们成功地在Rust程序中实现了不区分大小写的搜索功能。这种方式让用户可以通过简单的环境变量配置来改变程序的行为，而不需要每次运行程序时都指定命令行参数。通过这种方法，我们可以在命令行工具中灵活地控制不同的搜索模式，使程序更加友好和易于配置。
在本教程中，我们：
- 通过 TDD 编写了失败的测试，并逐步实现了功能。
- 学会了如何使用 Rust 标准库中的
env模块获取环境变量。 - 通过环境变量控制程序行为，让命令行工具更加灵活。
希望通过这个示例，你对 Rust 中如何使用环境变量有所了解，并能够在自己的项目中灵活应用。