Toado 🐸 📋

使用 Rust 编写的简单的命令行交互式任务和项目管理器。

安装

目前，Toado 仅适用于和经过测试的 x86-64 Linux。您可以从 https://github.com/maxcaplan/toado/releases 下载预编译的二进制文件。

Cargo

您还可以通过 Rust 的包管理器 cargo 来安装 Toado。在此安装 Rust 和 cargo here。

要使用 cargo 安装 Toado，请运行以下命令

$ cargo install toado

要检查 Toado 是否已安装，请运行以下命令

$ toado --version

如果安装正确，此命令将打印应用程序的版本。

用法

运行以下命令 help 可以查看 Toado 命令的信息

$ toado help
A simple interactive task and project manager for the command line

Usage: toado [OPTIONS] [SEARCH] [COMMAND]

Commands:
  search  Search for items
  add     Add a new item
  delete  Remove an item
  update  Update an item
  ls      Display a list of items
  check   Complete a task
  assign  Assigns a task to a project
  help    Print this message or the help of the given subcommand(s)

Arguments:
  [SEARCH]  Search term for item

Options:
  -t, --task         Execute search for tasks (default behaviour)
  -p, --project      Execute search for projects
  -v, --verbose      List all item information
  -f, --file <FILE>  Path to database file
  -h, --help         Print help
  -V, --version      Print version

您可以使用 help 查看特定命令的信息

$ todo help ls
Display a list of items

Usage: toado ls [OPTIONS] [ORDER_BY]

Arguments:
  [ORDER_BY]  List item order [possible values: id, name, priority]

Options:
  -t, --task             List tasks (default behaviour)
  -p, --project          List projects
  -v, --verbose          List all item information
  -a, --asc              List in ascending order
  -d, --desc             List in descending order
  -l, --limit <LIMIT>    Limit the number of items listed
  -o, --offset <OFFSET>  Offset start of list
  -f, --full             List all items
  -h, --help             Print help
  -V, --version          Print version

配置

您可以通过以下方式使用 TOML 配置文件来配置 Toado 的外观和行为

# config.toml
[table]
horizontal = "-"
vertical = "|"

您可以将配置文件作为 CLI 参数传递，如下所示

$ toado -c path/to/config.toml

如果没有提供配置文件，Toado 将在 ~/.config/toado/config.toml 中查找配置文件

要生成默认配置文件，请运行以下命令

$ rm ~/.config/toado/config.toml
$ toado

这将在 ~/.config/toado/config.toml 生成配置文件

您还可以在此 查看默认配置文件

构建

要构建项目，您必须安装 Rust 1.77.2 或更高版本。运行以下命令来构建 Toado

$ git clone https://github.com/maxcaplan/toado.git
$ cd toado
$ cargo build --release
$ ./target/release/toado --version