https://github.com/zuisong/rs-fortune

Command-line tool that prints random fortune entries. rust version of fortune
https://github.com/zuisong/rs-fortune

cli commandline-tool fortune fortune-cookie

Last synced: 8 months ago
JSON representation

Command-line tool that prints random fortune entries. rust version of fortune

README

# rs-fortune

`rs-fortune`是一个简单的Rust命令行工具,用于打印随机的fortune条目。

## 安装

- 可以从 Release 页面下载安装
- 可以通过Cargo安装:

```bash
cargo install --git https://github.com/zuisong/rs-fortune
```

- MacOS 可以通过homebrew 安装

```bash
brew install zuisong/tap/rs-fortune
```

## 用法

```txt
A rust version of fortune

Usage: rs-fortune [FORTUNE_FILE] [COMMAND]

Commands:
completions Generate tab-completion scripts for your shell
help Print this message or the help of the given subcommand(s)

Arguments:
[FORTUNE_FILE] The fortune cookie file path [env: FORTUNE_FILE=/Users/chen/.config/fish/kindle.txt]

Options:
-h, --help Print help
-V, --version Print version
```

`` 是包含 fortune 条目的文本文件, 每条 fortune 之间用独占一行的一个 % 分隔。

`rs-fortune` 也支持从 `FORTUNE_FILE` 环境变量中读取 `` 路径:

```bash
FORTUNE_FILE=fortunes.txt rs-fortune
```

如果同时传入了命令行参数和环境变量,命令行参数的优先级更高。

例如,一个fortune文件fortunes.txt的内容可以是:

```txt
Fortune favors the bold.
%
The early bird gets the worm.
%
Slow and steady wins the race.
```

然后你可以这样使用:

```bash
rs-fortune fortunes.txt
# 可能输出
# Fortune favors the bold

### 也可以从环境变量读取 fortune 文件路径
FORTUNE_FILE=fortunes.txt rs-fortune

### 也可以从管道中读取 fortunes
cat fortunes.txt | rs-fortune

# 打印帮助信息
rs-fortune --help
```

如果不传入 `` 或 `FORTUNE_FILE` 环境变量,将打印一条默认的 fortune

这是一个简单实用的命令行工具,可以用来打印随机的名言警句等。欢迎提出改进意见和建议!