25 个稳定版本

2.10.0 2024年7月15日
2.9.1 2020年8月25日
2.0.0 2020年7月15日
1.34.0 2020年7月14日
1.30.0 2020年5月26日

#516 in 命令行工具

Download history 112/week @ 2024-07-13 8/week @ 2024-07-20 22/week @ 2024-07-27

每月142次下载

GPL-3.0-only

235KB
2.5K SLoC

TRO

CircleCI CratesIO

trotro 是用 rust 编写的命令行版本的 Trello API 客户端。

assets/tro_show_board.png

注意:tro 仍在开发中。在此通知移除之前,请预期事物会突然且无预警地改变!

安装

目前,唯一安装方法是使用 cargo

cargo install tro

设置

运行首次设置 tro,请运行tro setup

查看tro --help获取所有可用子命令的列表。

可用子命令

  • setup: 首次设置 tro
  • show: 显示一个对象(看板、列表或卡片)
  • search: 搜索 Trello 卡片
  • create: 创建一个对象
  • move: 将卡片从一个列表移动到另一个列表
  • open: 打开已关闭的对象
  • close: 关闭对象
  • label: 在卡片上应用或移除标签
  • url: 显示对象的 URL
  • attach: 将文件附加到卡片
  • attachments: 查看卡片的附件
  • me: 显示当前登录用户

工作原理

此工具中的大多数子命令通过指定一个或多个以下形式的模式来工作:

<board pattern> <list pattern> <card pattern>

模式是任何有效的正则表达式模式。您也可以指定简单的模式,例如仅指定子字符串。

tro然后尝试将您提供的模式与可用的对象匹配

  • 如果tro无法找到指定的一项或多项的匹配项,则将显示适当的错误。
  • 如果tro找到了每个指定项目的唯一匹配项,则将成功显示您请求的对象。
  • 如果tro如果任何模式与多个可能的项目匹配,则该工具将无法精确确定您所指的对象,并将尽力解释原因。

使用示例

假设我们有一个名为 "TODO" 的看板,其中包含两个名为 "今天" 和 "完成" 的列表。

我们可以通过仅指定看板名称来显示整个看板

assets/tro_show_board.png

注意默认情况下模式是不区分大小写的。您可以使用-c标志来使模式匹配区分大小写。

如果我们只想查看板上的特定列表,我们可以指定一个额外的列表模式

assets/tro_show_list.png

如果我们想显示/编辑特定的卡片,我们也可以指定一个额外的卡片模式。

显示卡片将打开您的默认编辑器(由EDITOR环境变量指定),以便您可以编辑指定卡片的内 容。

例如,运行tro show todo today rust将如下打开

assets/tro_show_card.png

在查看板或列表时,可以通过[...]标记轻松地找到含有内容的卡片

assets/tro_card_contents.png

子命令

本节将详细解释一些更有用的子命令

创建命令

创建板、列表或卡片。

要创建一个新的板,请使用create.

$ tro create
Board name: TODO

指定无模式来创建板中的新列表,指定列表所属的板作为模式。

$ tro create TODO
List name: Today

要创建列表中的新卡片,请指定卡片所属的板和列表作为两个模式

$ tro create TODO today
Card name: Walk the dog

在创建卡片时,您可以指定--show标志,在卡片创建后立即编辑卡片。

您还可以使用--label标志来使模式匹配区分大小写。

$ tro create TODO today --label fun
Card name: Walk the dog
Applied  Fun Times  label

指定一个或多个标签分配给卡片。

搜索命令

您可以使用Trello的搜索语法执行卡片搜索

$ tro search dog bones is:open
Dig up some dog bones [...] id: 5ed78889acdaf970289ac894
walk the dog id: 5da72eed111e6a56d3407e0b

例如

$ tro search dog bones is:open has:description
Dig up some dog bones [...] id: 5ed78889acdaf970289ac894

标准Trello搜索语法中的所有操作符都受支持。例如,如果我们想找到只有描述的卡片~如果您想使用负操作符,请使用-.

$ tro search dog bones is:open ~has:description
walk the dog id: 5da72eed111e6a56d3407e0b

代替

交互模式大多数子命令都有交互模式,可以通过传递--interactive标志来使模式匹配区分大小写。

-i

启用交互模式提供简单的键盘界面,在可能的情况下选择相关项目。

依赖关系
~12-26MB