利用rust实现一个命令行工具

更新时间：2023年12月17日 08:25:01 作者：tommy_1

这篇文章主要为大家详细介绍了如何使用 Rust 和 clap 4.4.0 创建一个命令行工具 my_dev_tool,文中的示例代码讲解详细,需要的小伙伴可以参考下

第 1 步：创建项目并添加依赖

创建新的 Rust 项目：在终端中运行以下命令：

cargo new my_dev_tool
cd my_dev_tool

添加依赖：在 Cargo.toml 中添加 clap、serde、serde_json 和 chrono 作为依赖：

[dependencies]
clap = "4.4.0"
chrono = "0.4"
urlencoding = "2.1"

第 2 步：编写代码

在 src/main.rs 中，使用 clap 定义命令行参数并实现功能。

use clap::{Arg, ArgMatches, Command};
use chrono::{Local, TimeZone};
use urlencoding::{decode, encode};

fn main() {
    let matches = Command::new("my_dev_tool")
        .version("1.0")
        .author("Your Name <your.email@example.com>")
        .about("Developer's tool for urlencode and time format!")
        .subcommand_required(true)
        .arg_required_else_help(true)
        .subcommand(
            Command::new("urlencode")
                .about("URL-encode a string")
                .arg(Arg::new("input").help("String to encode").required(true)),
        )
        .subcommand(
            Command::new("urldecode")
                .about("URL-decode a string")
                .arg(Arg::new("input").help("String to decode").required(true)),
        )
        .subcommand(
            Command::new("timestamp")
                .about("Convert a UNIX timestamp to local datetime")
                .arg(Arg::new("timestamp").help("UNIX timestamp").required(true)),
        )
        .get_matches();

    match matches.subcommand() {
        Some(("urlencode", sub_matches)) => url_encode(sub_matches),
        Some(("urldecode", sub_matches)) => url_decode(sub_matches),
        Some(("timestamp", sub_matches)) => convert_timestamp(sub_matches),
        _ => unreachable!(),
    }
}

fn url_encode(matches: &ArgMatches) {
    if let Some(input) = matches.get_one::<String>("input") {
        println!("{}", encode(input));
    }
}

fn url_decode(matches: &ArgMatches) {
    if let Some(input) = matches.get_one::<String>("input") {
        println!("{}", decode(input).unwrap());
    }
}

fn convert_timestamp(matches: &ArgMatches) {
    if let Some(timestamp_str) = matches.get_one::<String>("timestamp") {
        let timestamp = timestamp_str.parse::<i64>().unwrap();
        let datetime = Local.timestamp_opt(timestamp, 0).unwrap();
        println!("{}", datetime.to_rfc3339());
    }
}

第 3 步：编译和安装

编译项目：

cargo build --release

安装到系统：

在 Linux 或 macOS 上，你可以将编译后的可执行文件复制到 /usr/local/bin 或其他 PATH 包含的目录：

sudo cp target/release/my_dev_tool /usr/local/bin/

在 Windows 上，你可以将可执行文件复制到任何 PATH 包含的目录，或者手动添加其所在目录到系统 PATH。

第 4 步：使用工具

一旦安装，你就可以直接在命令行中使用 my_dev_tool，例如：

my_dev_tool urlencode "https://example.com"
my_dev_tool urldecode "https%3A%2F%2Fexample.com"
my_dev_tool timestamp 1609459200

正常教程到这里就结束了，但是通过复制的方法安装命令行，实在是low，必须要使用一种装逼的方式来安装。因此，下面的步骤才是命令行装逼的关键，支持cargo安装。

第5步，支持cargo安装

要使你的 my_dev_tool 命令行工具能够通过 cargo install 安装，你需要将其发布到 crates.io，这是 Rust 的包管理仓库。在发布之前，你需要创建一个帐户并获取一个 API 令牌用于身份验证。以下是将你的工具准备并发布到 crates.io 的步骤：

第（1）步：注册 crates.io 帐户

访问 crates.io 并注册一个帐户。
登录后，在 "Account Settings" 中获取你的 API 令牌。
验证自己的邮箱，邮箱只有验证成功才可以publish包。

第（2）步：登录 Cargo

在你的终端中，使用以下命令登录 Cargo：

cargo login [your_api_token]

将 [your_api_token] 替换为你在 crates.io 上的 API 令牌。

第（3）步：准备发布

确保你的 Cargo.toml 文件包含所有必要的信息，这对于发布至 crates.io 是必要的。下面是一个示例：

[package]
name = "my_dev_tool"
version = "0.1.0"
authors = ["Your Name <youremail@example.com>"]
edition = "2018"

# 以下是描述和文档链接等可选字段
description = "A useful development tool for various tasks"
documentation = "https://example.com/my_dev_tool/docs"
license = "MIT OR Apache-2.0"

[dependencies]
clap = "3.0"
chrono = "0.4"
urlencoding = "2.1"

确保更新 authors、description、documentation（如果适用），以及任何其他相关信息。

第（4）步：发布到 crates.io

在你的项目目录中运行以下命令来发布你的包：

cargo publish

这将会把你的包上传到 crates.io。

第6步：通过 Cargo 安装

一旦你的包被成功发布到 crates.io，其他人就可以通过运行以下命令来安装你的工具：

cargo install my_dev_tool

展示成果

% cargo install my_dev_tool
    Updating crates.io index
  Downloaded my_dev_tool v0.1.0
  Downloaded 1 crate (10.7 KB) in 2.64s
  Installing my_dev_tool v0.1.0
    Updating crates.io index
   Compiling autocfg v1.1.0
   Compiling utf8parse v0.2.1
   Compiling anstyle-query v1.0.0
   Compiling colorchoice v1.0.0
   Compiling anstyle v1.0.4
   Compiling strsim v0.10.0
   Compiling clap_lex v0.6.0
   Compiling iana-time-zone v0.1.58
   Compiling urlencoding v2.1.3
   Compiling anstyle-parse v0.2.2
   Compiling anstream v0.6.4
   Compiling num-traits v0.2.17
   Compiling clap_builder v4.4.8
   Compiling chrono v0.4.31
   Compiling clap v4.4.8
   Compiling my_dev_tool v0.1.0
    Finished release [optimized] target(s) in 7.84s
  Installing /home/maocg/.cargo/bin/my_dev_tool
   Installed package `my_dev_tool v0.1.0` (executable `my_dev_tool`)

% my_dev_tool timestamp 1609459200
2021-01-01T08:00:00+08:00

注意事项

在发布之前，请确保代码和文档是清晰和完整的，这对于其他人使用你的工具非常重要。
你需要更新版本号（在 Cargo.toml 中的 version 字段）在每次发布新的更改时。
如果你的工具包含敏感或专有信息，请在发布前仔细检查。

以上就是利用rust实现一个命令行工具的详细内容，更多关于rust实现命令行工具的资料请关注脚本之家其它相关文章！

您可能感兴趣的文章:

Go调用Rust方法及外部函数接口前置
这篇文章主要为大家介绍了Go调用Rust方法及外部函数接口前置示例实现，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
2022-06-06
rust zip异步压缩与解压的代码详解
在使用actix-web框架的时候，如果使用zip解压任务将会占用一个工作线程，因为zip库是同步阻塞的，想用异步非阻塞需要用另一个库，下面介绍下rust zip异步压缩与解压的示例，感兴趣的朋友一起看看吧
2024-04-04
深入了解Rust中的枚举和模式匹配
这篇文章主要为大家详细介绍了Rust中的枚举和模式匹配的相关知识,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下
2024-01-01
Rust中引用的具体使用
在Rust语言中,引用机制是其所有权系统的重要组成部分,ust提供了两种类型的引用,不可变引用和可变引用,本文就来详细的介绍一下这两种的用法,感兴趣的可以了解一下
2024-03-03
Rust编写自动化测试实例权威指南
这篇文章主要为大家介绍了Rust编写自动化测试实例权威指南详解，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
2022-12-12
Rust 文档注释功能示例代码
Rust的文档注释使用特定的格式,以便通过 rustdoc工具生成 API 文档,本文给大家介绍Rust 文档注释功能,感兴趣的朋友跟随小编一起看看吧
2024-04-04
rust实现post小程序(完整代码)
这篇文章主要介绍了rust实现一个post小程序,本文通过示例代码给大家介绍的非常详细,感兴趣的朋友跟随小编一起看看吧
2024-04-04
Rust调用函数操作符 . 和 :: 的区别详解
在Rust中，.和::操作符都可以用来调用方法，但它们的用法有所不同，所以本文就将详细的给大家介绍一下.和::操作符的区别，感兴趣的同学跟着小编一起来学习吧
2023-07-07
Rust包和Crate超详细讲解
这篇文章主要介绍了Rust包管理和Crate，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习吧
2022-12-12
rust多个mod文件引用和文件夹mod使用注意事项小结
在 Rust 项目中,可以使用 mod 关键字将一个文件夹或一个 rs 文件作为一个模块引入到当前文件中,本文给大家介绍rust多个mod文件引用和文件夹mod使用注意事项小结,感兴趣的朋友跟随小编一起看看吧
2024-03-03