aspentool

Aspen 命令行工具

本项目会使用 Rust 和 clap 4.4.12 创建一个命令行工具 aspen，先实现 ssh登录服务器和查看服务器列表 两个个功能。如果你也想实现一个自己的命令行工具，可以按照以下步骤进行：

第 1 步：编译和安装

1. 编译项目：

   cargo build --release
   

2. 安装到系统：

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

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

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

第 4 步：使用工具

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

# 先选择要链接的服务器,然后登录
aspentool ssh 
# 知道服务器的编号,直接登录该编号服务器
aspentool ssh 1
# 查看所有已配置的服务器列表
aspentool all
# 设置服务器配置的地址
aspentool set-path /xx/xxx/xxx.json
# 获取服务器配置的地址
aspentool get-path

但是通过复制的方法安装命令行，实在是不够 （悠亚） 优雅，必须要使用一种装逼的方式来安装。因此，下面的步骤才是命令行装逼的关键，支持cargo安装。

第5步，支持cargo安装

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

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

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

第（2）步：登录 Cargo

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

cargo login [your_api_token]

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

第（3）步：准备发布

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

[package]
name = "aspentool"
version = "0.1.0"
authors = ["Aspen Soung <songyang410@outlook.com>"]
edition = "2021"

# 以下是描述和文档链接等可选字段
description = "A useful development tool for various tasks"
license = "MIT"

[dependencies]
clap = "4.4.12"
colored = "2.1.0"
prettytable-rs = "^0.10"
ssh2 = "0.9.4"

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

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

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

cargo publish

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

第6步：通过 Cargo 安装

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

cargo install aspentool

第7步：开始使用

安装成功之后,需要您先使用命令设置服务器配置的地址,配置文件的格式按 config.example 内容即可

aspentool set-path /xxxx/xxx/x.json

设置完成之后,就可以愉快的玩耍了 🎉🎉🎉🎉