## Aspen 命令行工具
本项目会使用 Rust 和 `clap` 4.4.0 创建一个命令行工具 `aspen`,先实现 ssh登录服务器和查看服务器列表 两个个功能。如果你也想实现一个自己的命令行工具,可以按照以下步骤进行:
### 第 1 步:编译和安装
1. **编译项目**:
```bash
cargo build --release
```
2. **安装到系统**:
- 在 Linux 或 macOS 上,你可以将编译后的可执行文件复制到 `/usr/local/bin` 或其他 PATH 包含的目录:
```bash
sudo cp target/release/aspen /usr/local/bin/
```
- 在 Windows 上,你可以将可执行文件复制到任何 PATH 包含的目录,或者手动添加其所在目录到系统 PATH。
### 第 4 步:使用工具
一旦安装,你就可以直接在命令行中使用 `aspen`,例如:
```bash
aspen ssh
aspen ssh 1
aspen servers
```
但是通过复制的方法安装命令行,实在是不够 (悠亚) 优雅,必须要使用一种装逼的方式来安装。因此,下面的步骤才是命令行装逼的关键,支持cargo安装。
### 第5步,支持cargo安装
要使你的 `aspen` 命令行工具能够通过 `cargo install` 安装,你需要将其发布到 [crates.io](https://crates.io/),这是 Rust 的包管理仓库。在发布之前,你需要创建一个帐户并获取一个 API 令牌用于身份验证。以下是将你的工具准备并发布到 crates.io 的步骤:
#### 第(1)步:注册 crates.io 帐户
1. 访问 [crates.io](https://crates.io/) 并注册一个帐户。
2. 登录后,在 "Account Settings" 中获取你的 API 令牌。
3. 验证自己的邮箱,邮箱只有验证成功才可以publish包。
#### 第(2)步:登录 Cargo
在你的终端中,使用以下命令登录 Cargo:
```bash
cargo login [your_api_token]
```
将 `[your_api_token]` 替换为你在 crates.io 上的 API 令牌。
#### 第(3)步:准备发布
确保你的 `Cargo.toml` 文件包含所有必要的信息,这对于发布至 crates.io 是必要的。下面是一个示例:
```toml
[package]
name = "aspen-toolbox"
version = "0.1.0"
authors = ["Aspen Soung "]
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
在你的项目目录中运行以下命令来发布你的包:
```bash
cargo publish
```
这将会把你的包上传到 crates.io。
### 第6步:通过 Cargo 安装
一旦你的包被成功发布到 crates.io,其他人就可以通过运行以下命令来安装你的工具:
```bash
cargo install aspen
```
#### 展示成果
```shell
aspen servers
```