nyholm/git-reviewer

为您的GitHub pull request找到合适的审稿人

安装: 860

依赖: 0

建议者: 0

安全: 0

星标: 5

关注者: 3

分支: 0

开放问题: 0

类型:项目

0.2.0 2024-01-08 13:28 UTC

This package is auto-updated.

Last update: 2024-09-08 14:50:02 UTC


README

这是一个小的PHP (Symfony)应用程序,用于找到GitHub pull request的审稿人。

它使用一个简单的算法,首先

  1. 查看PR中修改的文件
  2. 对每个文件执行git blame以查看谁修改了文件
  3. 对贡献者列表进行排序,第一个贡献者是修改了pull request涉及的最多数量的文件的人
$ ./git-reviewer.php find 106 /path/to/local/repository --pretty-print

[
    {
        "email": "tobias.nyholm@gmail.com",
        "name": "Tobias Nyholm",
        "contributions": 3,
        "username": "Nyholm"
    },
    {
        "email": "ion.bazan@gmail.com",
        "name": "Ion Bazan",
        "contributions": 1,
        "username": "IonBazan"
    }
]

文档

./git-reviewer.php的第一个参数是"命令名称"。以下是每个命令名称及其附加参数和选项的简短描述。

cache:clear

清除应用程序的缓存。它不会清除var/storage

$ ./git-reviewer.php cache:clear

pull-request:base

查找pull request的目标分支。

$ ./git-reviewer.php pull-request:base 123 /path/to/local/repository

master

find

获取可能的审稿人列表。

$ ./git-reviewer.php find 123 /path/to/local/repository

[
    {
        "email": "tobias.nyholm@gmail.com",
        "name": "Tobias Nyholm",
        "contributions": 3,
        "username": "Nyholm"
    },
    ...
]

选项

$ ./git-reviewer.php find 123 /path/to/local/repository --ignore-path "config/*" --ignore-path .env --after 2020-01-01 --no-username --pretty-print

调用GitHub API

GitHub允许一些匿名调用,但指定一个名为GITHUB_TOKEN的环境变量是一个好主意。该变量应包含具有"api"权限的GitHub令牌。

您可以在GitHub账户的"开发者设置 > 个人访问令牌"下创建这样的令牌。