gri : Git简化接口

gri是一个命令行工具，可以以使识别哪些需要您关注的方式列出来自多个服务器的git评审。

目前支持的后端是Gerrit和GitHub，但如需添加其他后端，应很容易实现。

特性

• 结合多个Gerrit或GitHub服务器的结果
• 使用终端可点击链接，以便轻松访问这些评审
• 以压缩格式显示与审阅相关的关键元数据
• 审阅根据合并的可能性进行排序
• 允许用户放弃非常旧的审阅
• 可用于查询
  • 已合并的审阅
  • 收到的审阅（您是审阅者的情况）
  • 由除您之外的其他用户创建的审阅
• 生成HTML报告

安装

pip install gri

用法

您可以直接运行 gri，或者 python -m gri 来获取当前审阅列表，也称为外发审阅。

GRI使用一个简单的配置文件 ~/.config/gri/gri.yaml，但在文件缺失的情况下，它会尝试从 ~/.gertty.yaml 加载服务器，前提是您有这个文件。

$ gri --help
Usage: gri [OPTIONS] COMMAND1 [ARGS]... [COMMAND2 [ARGS]...]...

Options:
  -a, --abandon              Abandon changes (delete for drafts) when they are
                              >90 days old and with negative score. Requires -f
                             to perform the action.
  -z, --abandon-age INTEGER  default=90, number of days for which changes are
                             subject to abandon
  -u, --user TEXT            Query another user than self
  -s, --server TEXT          [0,1,2] key in list of servers, Query a single
                             server instead of all
  -o, --output TEXT          Filename to dump the result in, currently only
                             HTML is supported
  -f, --force                Perform potentially destructive actions.
  -d, --debug                Debug mode
  --help                     Show this message and exit.

Commands:
  incoming  Incoming reviews (not mine)
  merged    merged in the last number of days
  owned     Changes originated from current user (implicit)

还有一个实验性的 grib 命令行用于查询错误（问题），其选项几乎相同。

配置

除非您已经有一个GerTTY配置，否则以下是配置工具的方法

# ~/.config/gri/gri.yaml
servers:
- name: opendev  # server 0, select it with '-s 0'
  url: https://review.opendev.org/
- name: rdo  # server 0, select it with '-s 1'
  url: https://review.rdoproject.org/r/
  auth-type: basic  # needed only for old gerrit versions

您可能会惊讶地发现凭据没有存储在同一文件中。这是有意为之，并且工具将从 ~/.netrc 文件加载凭据，这也是放置网络相关凭据的标准方式。

# ~/.netrc
# password is the token generated by gerrit on your user settings page
machine review.rdoproject.org login jonhdoe password changeme

贡献

如果您缺少一个功能，请检查是否有一个针对该功能的开放错误，如果没有，请添加一个新错误。完成后，您欢迎提交一个实现缺失更改的PR。

相关工具

• git-review 是用于与gerrit工作的git扩展，我也是其核心贡献者之一。
• gertty 是一个非常有用的gerrit tui，它启发了我，但它有一个基本的设计限制：它不适用于多个Gerrit服务器。
• gerrit-view 是一个可以从 Visual Studio Marketplace 安装的vscode插件。

注释

1. gri 名称来源于我尝试找到一个以 g 开头且听起来像 cli 的短名称的努力。