【RUST学习】命令行程序（项目实例）

已于 2024-03-19 15:35:24 修改
阅读量507 收藏 10
点赞数 4
分类专栏： rust学习 文章标签： rust 学习
于 2024-03-19 15:34:43 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_54384621/article/details/136811676
版权

接受命令行参数

主要：实现在特定文件中搜索特定的内容

use std::env;
//args函数会返回一个迭代器，迭代器会产生一系列的值
//我们可以调用collect方法把这些值转化成一个集合
fn main() {
    let args :Vec<String> = env::args().collect();


    let query =&args[1];
    let filename = &args[2];

    println!("search for {}",query);
    println!("In file {}",filename);
}

加入读取文件

use std::env;
//args函数会返回一个迭代器，迭代器会产生一系列的值
//我们可以调用collect方法把这些值转化成一个集合
use std::fs;
//处理跟文件相关的一些事物
fn main() {
    let args :Vec<String> = env::args().collect();


    let query =&args[1];
    let filename = &args[2];

    println!("search for {}",query);
    println!("In file {}",filename);

    let contents = fs::read_to_string(filename).expect("Something wrong in reading txt");
    println!("with the text:\n{}",contents);
}

但是这样一股脑的将功能全部放在main函数里会导致可读性变差，可维护性变弱，因此rust社区发行了二进制关注点分离的指导性原则。

1、将程序拆分为main.rs和lib.rs时，将业务逻辑放进lib.rs。
2、当命令行解析逻辑较少时，将他放在main.rs也可以。
3、当命令行解析逻辑变复杂时，需要将他从main.rs提取到lib.rs。

改善模块化

我们尝试将解析参数的代码解剖出来

use std::env;
//args函数会返回一个迭代器，迭代器会产生一系列的值
//我们可以调用collect方法把这些值转化成一个集合
use std::fs;
//处理跟文件相关的一些事物
fn main() {
    let args :Vec<String> = env::args().collect();
    let (query, filename) = parse_config(&args);

    let contents = fs::read_to_string(filename).expect("Something wrong in reading txt");
    println!("with the text:\n{}",contents);
}

fn parse_config(args: &[String]) ->(&str, &str) {//通过这个函数来解析参数
    let query = &args[1];
    let filename = &args[2];
    (query,filename)
}

这段代码的可读性还不够强，那么我们继续做改进

use std::env;
//args函数会返回一个迭代器，迭代器会产生一系列的值
//我们可以调用collect方法把这些值转化成一个集合
use std::fs;
//处理跟文件相关的一些事物
fn main() {
    let args :Vec<String> = env::args().collect();//读取了一个字符串，args的所有权归main函数
    let config = Config::new(&args);

    let contents = fs::read_to_string(config.filename).expect("Something wrong in reading txt");
    println!("with the text:\n{}",contents);
}

struct Config{
    query:String,
    filename:String,
}

impl Config {
    fn new(args: &[String]) ->Config { //传了一个切片进去，但是目前并没有所有权
        let query = args[1].clone();
        let filename = args[2].clone();
        Config{//这里是需要arg中某些切片的所有权的，所以我们采用克隆的方法获得原切片的副本
            query,
            filename,
        }
    }
}

错误处理

代码总是会发生错误，这里我们对可能发生的错误进行处理。

use std::env;
//args函数会返回一个迭代器，迭代器会产生一系列的值
//我们可以调用collect方法把这些值转化成一个集合
use std::fs;
//处理跟文件相关的一些事物
use std::process;

fn main() {
    let args :Vec<String> = env::args().collect();//读取了一个字符串，args的所有权归main函数
    let config = Config::new(&args).unwrap_or_else(|err|{
        //如果发生了错误，会屏蔽掉之前的一些代码然后打印err中的内容
        println!("problem parsing arguments: {}", err);
        process::exit(1);
    });

    let contents = fs::read_to_string(config.filename).expect("Something wrong in reading txt");
    println!("with the text:\n{}",contents);
}

struct Config{
    query:String,
    filename:String,
}

impl Config {
    fn new(args: &[String]) ->Result<Config, &'static str> { 
        //传了一个切片进去，但是目前并没有所有权
        //如果出现错误就返回一个err变体
        if args.len() < 3{
            return Err("not enough arguments")
        }
        let query = args[1].clone();
        let filename = args[2].clone();
        Ok(        Config{//这里是需要arg中某些切片的所有权的，所以我们采用克隆的方法获得原切片的副本
            query,
            filename,
        })
    }
}

将业务逻辑移动至lib.rs

main.rs中代码如下：

use minigrep::Config;
use std::env;
//args函数会返回一个迭代器，迭代器会产生一系列的值
//我们可以调用collect方法把这些值转化成一个集合
use std::process;


fn main() {
    let args :Vec<String> = env::args().collect();//读取了一个字符串，args的所有权归main函数
    let config = Config::new(&args).unwrap_or_else(|err|{
        //如果发生了错误，会屏蔽掉之前的一些代码然后打印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中的代码如下

use std::error::Error;
use std::fs;
//处理跟文件相关的一些事物

pub struct Config{
    pub query:String,
    pub filename:String,
}

pub fn run(config:Config) ->Result<(),Box<dyn Error>>{
    let contents = fs::read_to_string(config.filename)?;//在发生错误时不会产生panic而是把错误交给函数的调用者来进行处理
    println!("with the text:\n{}",contents);
    Ok(())
}

impl Config {
   pub fn new(args: &[String]) ->Result<Config, &'static str> { 
        //传了一个切片进去，但是目前并没有所有权
        //如果出现错误就返回一个err变体
        if args.len() < 3{
            return Err("not enough arguments")
        }
        let query = args[1].clone();
        let filename = args[2].clone();
        Ok(        Config{//这里是需要arg中某些切片的所有权的，所以我们采用克隆的方法获得原切片的副本
            query,
            filename,
        })
    }
}

使用TDD编写库功能

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

main.rs函数不做修改

use minigrep::Config;
use std::env;
//args函数会返回一个迭代器，迭代器会产生一系列的值
//我们可以调用collect方法把这些值转化成一个集合
use std::process;


fn main() {
    let args :Vec<String> = env::args().collect();//读取了一个字符串，args的所有权归main函数
    let config = Config::new(&args).unwrap_or_else(|err|{
        //如果发生了错误，会屏蔽掉之前的一些代码然后打印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

use std::error::Error;
use std::fs;
//处理跟文件相关的一些事物

pub struct Config{
    pub query:String,
    pub filename:String,
}

pub fn run(config:Config) ->Result<(),Box<dyn Error>>{
    let contents = fs::read_to_string(config.filename)?;//在发生错误时不会产生panic而是把错误交给函数的调用者来进行处理
    for line in search(&config.query, &contents){
        println!("{}",line);
    }
    println!("with the text:\n{}",contents);
    Ok(())
}

impl Config {
   pub fn new(args: &[String]) ->Result<Config, &'static str> { 
        //传了一个切片进去，但是目前并没有所有权
        //如果出现错误就返回一个err变体
        if args.len() < 3{
            return Err("not enough arguments")
        }
        let query = args[1].clone();
        let filename = args[2].clone();
        Ok(        Config{//这里是需要arg中某些切片的所有权的，所以我们采用克隆的方法获得原切片的副本
            query,
            filename,
        })
    }
}

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) {//lines.contains()返回的是一个bool类型
            results.push(line);
        }
    }
    results
}

#[cfg(test)]   //测试函数
mod tests{
    use super::*;
    
    #[test]
    fn one_result() {
        let query = "duct";
        let contents = "\
Rust:
safe,fase,productive.
pick three.";

        assert_eq!(vec!["safe,fase,productive."],search(query,contents ))
    }
}

使用环境变量

用一个环境变量来控制搜索时是否需要将大小写进行区分

CASE_INSENSITIVE=1 : 无法将“CASE_INSENSITIVE=1”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。请检查名称的拼写，如果包括路径，请确保路径正确，然后再试一次。

main.rs

use minigrep::Config;
use std::env;
//args函数会返回一个迭代器，迭代器会产生一系列的值
//我们可以调用collect方法把这些值转化成一个集合
use std::process;


fn main() {
    let args :Vec<String> = env::args().collect();//读取了一个字符串，args的所有权归main函数
    let config = Config::new(&args).unwrap_or_else(|err|{
        //如果发生了错误，会屏蔽掉之前的一些代码然后打印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

use std::error::Error;
use std::fs;
//处理跟文件相关的一些事物
use std::env;

pub struct Config{
    pub query:String,
    pub filename:String,
    pub case_sensitive:bool,
}

pub fn run(config:Config) ->Result<(),Box<dyn Error>>{
    let contents = fs::read_to_string(config.filename)?;//在发生错误时不会产生panic而是把错误交给函数的调用者来进行处理
    let results = if config.case_sensitive{
        search(&config.query, &contents)
    }else {
        search_case_insensitive(&config.query, &contents)
    };
    for line in results{
        println!("{}",line);
    }
    println!("with the text:\n{}",contents);
    Ok(())
}

impl Config {
   pub fn new(args: &[String]) ->Result<Config, &'static str> { 
        //传了一个切片进去，但是目前并没有所有权
        //如果出现错误就返回一个err变体
        if args.len() < 3{
            return Err("not enough arguments")
        }
        let query = args[1].clone();
        let filename = args[2].clone();
        let case_sensitive = env::var("CASE_INSENSITIVE").is_err();
        Ok(        Config{//这里是需要arg中某些切片的所有权的，所以我们采用克隆的方法获得原切片的副本
            query,
            filename,
            case_sensitive
        })
    }
}

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) {//lines.contains()返回的是一个bool类型
            results.push(line);
        }
    }
    results
}

pub fn search_case_insensitive<'a>(query: &str,contents:&'a str) ->Vec<&'a str> {
    let mut results = Vec::new();
    let query = query.to_lowercase();

    for line in contents.lines(){
        if line.to_lowercase().contains(&query) {//lines.contains()返回的是一个bool类型
            results.push(line);
        }
    }
    results
}

#[cfg(test)]   //测试函数
mod tests{
    use super::*;
    
    #[test]
    fn case_sensitive() {
        let query = "duct";
        let contents = "\
Rust:
safe,fase,productive.
pick three.
Duct tape.";

        assert_eq!(vec!["safe,fase,productive."],search(query,contents ))
    }

    #[test]
    fn case_insensitive(){
        let query = "rUsT";
        let contents = "\
Rust:
safe,fase,productive.
pick three.
Trust me.";

        assert_eq!(vec!["Rust:","Trust me."],search_case_insensitive(query, contents) )
    }
}

将错误信息输出到标准错误

标准错误vs标准输出
标准输出：stdout
—println！
标准错误：stderr
—eprintln!

main.rs进行修改

use minigrep::Config;
use std::env;
//args函数会返回一个迭代器，迭代器会产生一系列的值
//我们可以调用collect方法把这些值转化成一个集合
use std::process;


fn main() {
    let args :Vec<String> = env::args().collect();//读取了一个字符串，args的所有权归main函数
    let config = Config::new(&args).unwrap_or_else(|err|{
        //如果发生了错误，会屏蔽掉之前的一些代码然后打印err中的内容
        eprintln!("problem parsing arguments: {}", err);
        process::exit(1);
    });
    if let Err(e) = minigrep::run(config){//如果返回了一个错误
        eprintln!("Application error: {}",e);
        process::exit(1);
    }

}

cmd输入

cargo run to poem.txt > output.txt

会将输出的内容存放到output.txt文件里

山师第一深情
关注
专栏目录
用Rust创建可靠的命令行程序
程序员光剑
07-30 1105
2020年是技术领域的元年，编程语言也迎来了翻天覆地的变化。Java、Python、JavaScript等多种语言在这片广袤的市场上掀起了一阵股风，各个方向都有不少开发者投入其中，同时还有一些企业将更加重视其技术能力。而在这些语言中，Rust 则名扬天下。Rust 是一种新兴的编程语言，拥有强大的性能、安全、并发特性和方便开发的特点。本文就带你用 Rust 创建一个可靠的命令行程序，看看它到底有多强悍。Rust 是一门注重速度、零开销、内存安全性和高效开发的系统级编程语言。
Rust编程基础教程：命令行工具开发
程序员光剑
10-27 242
命令行工具开发是许多开发人员的工作之一，它可以帮助我们更快、更准确地完成特定任务。但是编写命令行工具也需要一些技巧和知识，本文将用Rust语言进行介绍。Rust是一个现代、高效、跨平台的系统编程语言，可以让我们在保证高性能同时降低资源消耗方面做到无可替代。本文将以编写一个简单的命令行工具为例，带领读者了解Rust编程语言的基本知识和最佳实践。内存安全：Rust严格限制变量访问范围，避免出现栈溢出、堆溢出等安全漏洞。线程安全：支持多线程环境下的并发访问，能够轻松实现数据共享和同步。
rust学习 - 构建mini 命令行工具
ngd-b的博客
06-08 1204
rust 的运行速度、安全性、单二进制文件输出和跨平台支持使其成为构建命令行程序的最佳选择。实现一个命令行搜索工具grep,可以在指定文件中搜索指定的字符串。
rust-argparse, Rust的命令行 参数解析器库.zip
09-18
rust-argparse, Rust的命令行 参数解析器库 Argparserust-argparse的Rust 命令行解析模块。 它受到 python 模块 argparse的启发。功能：支持标准( GNU ) 选项约定正确输入的值自动生成的帮助和用法消息导入编辑 Cargo
rust：工具常用的命令
最新发布
fefdfg的博客
07-09 699
Rust 语言本身包括以下几个部分：编译器（rustc）：将 Rust 代码编译为可执行文件或库。标准库（std）：提供常用的数据结构、算法、I/O 操作等。Rust 工具链是一个更广泛的概念，包含了开发 Rust 应用程序所需的所有工具和组件编译器（rustc）：和 Rust 语言本身一样，编译器是工具链的核心部分。Cargo：Rust 的包管理和构建工具。它用于管理依赖、构建项目、运行测试等。Rustup：Rust 工具链的管理工具。
【RUST】基本命令行操作
I'm Zz.
09-14 931
【代码】【RUST】基本命令行操作。
【rust】命令汇总
过得精彩，无所谓好坏
06-28 1242
rust相关命令，如cargo命令使用等
Rust学习-构建命令行程序
wangkai6666的博客
07-16 1277
Rust 的运行速度、安全性、单二进制文件输出和跨平台支持使其成为创建命令行程序的绝佳选择本文以实现一个minigrep为例，展开对之前学习的回归。
RUST直接升钢指令_RUST 命令大全（包括服务器指令）
weixin_32822843的博客
12-23 2515
该楼层疑似违规已被系统折叠隐藏此楼查看此楼RUST++ MOD(以下在聊天框内输入)基本命令/share playername 【shares your doors with a player(共享你的门给一个玩家)】/unshare playername 【unshares your doors with a player(解除对一个玩家的门共享)】/help 【Shows commands(...
Rust之构建命令行程序(五)：环境变量
wing的专栏
03-22 1510
Rust之构建命令行程序(五)：环境变量
Rust程序设计语言 Rust Programming Language
05-05
《Rust程序设计语言》是官方的Rust编程语言教程，旨在帮助读者理解和掌握Rust语言的核心特性和最佳实践。这本书由Steve Klabnik和Carol Nichols撰写，并由Rust社区不断更新和完善。简体中文版是由Rust中文社区翻译的...
RUST管理命令
06-25
管理命令RUST插件各种命令RUST++的命令
X-CSV-Reader:一个使用Rust实现CSV命令行读取器
05-27
X-CSV-Reader 可以作为学习 Rust 和 CSV 处理的实例。通过这个项目，开发者可以提升对 Rust 异常处理、文件 I/O 和命令行接口设计的理解。此外，该项目也可以作为基础，扩展出更复杂的 CSV 工具，如支持更多的数据...
Rust入门（八）：构建一个命令行程序
weixin_46463785的博客
01-06 1130
Rust入门（八）：构建一个命令行测试程序的例子
Rust学习入门--【4】Rust 输出到命令行
文斗士的专栏
02-11 631
学习新的编程语言时，大家都喜欢打印“Hello World”。 在Rust中怎样将字符串打印出来呢？ **Rust 输出文字的方式主要有两种**：**println!() 和 print!()**。 **函数差异说明：** 这两个"函数"都是向命令行输出字符串的方法，区别仅在于println会在输出的最后附加输出一个换行符。
Rust 常用命令
今天又懒得加班
11-25 3080
安装 curl --proto '=https' --tlsv1.2 https://sh.rustup.rs -sSf | sh 查看版本 rustc --version 升级 rustup update 卸载 $ rustup self uninstall 查看cargo 版本 cargo --version 新建项目 cargo new hello_cargo 构建项目 cargo build cargo build --release //打包生产环境 运行项目 cargo run
用Rust编写一个命令行工具(初学)
hot_milk1的博客
04-12 1181
今天心血来潮决定写一个Rust命令行工具哈哈哈哈，本人rust初学者，跟着网上一些博客和大佬然后自己编写改进一些好玩的小代码，勿喷（狗头） ，用Rust编写一个命令行工具，对于我这种初学者来说是一个很好的练习，毕竟，大家刚开始接触一个新的语言都是从Hello World的入手的，Rust这门语言感觉还是挺抽象的,语言博大精深，本人还是菜鸡一个，慢慢来吧。
【Rust】——项目实例：——命令行实例（一）
shsjssnn的博客
04-19 2747
🎯接收命令行程序 🎃读取参数 🎃将参数值保存进变量 🎯读取文件 🎯重构 🎃二进制项目的关注分离 🎃提取参数解析器 🎃组合配置值 🎃修复错误处理 ✨改善错误信息 🎃从new中返回一个Result 🎃调用config::build并处理错误 🎃从main提取逻辑 🎃从run函数中返回错误 🎃处理main中run返回的错误 🎃将代码拆分到库crate
rust 官服指令_RUST 命令大全（包括服务器指令）
weixin_36205186的博客
02-22 5067
该楼层疑似违规已被系统折叠隐藏此楼查看此楼RUST++ MOD(以下在聊天框内输入)基本命令/share playername 【shares your doors with a player(共享你的门给一个玩家)】/unshare playername 【unshares your doors with a player(解除对一个玩家的门共享)】/help 【Shows commands(...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值