git-goggles 0.2.12

概述

此项目完成了以下两项任务

• 管理分支的代码审查状态

• 提供本地分支相对于origin的快照，显示提交领先/落后的情况

有关功能和屏幕截图的详细描述可以在此博客文章中找到： http://bit.ly/git-goggles

字段参考

git-goggles输出的表格中，每一行对应一个分支，包含以下字段

• 状态：分支的当前状态

  • new：这是一个从未经过审查过程的分支

  • review：此分支有需要审查的代码

  • merge：一切均已审查，但需要合并到父分支（与领先相同）

  • done：已审查和合并（如果您落后没关系，但您不能领先）

• 分支：分支名称

• 审查：自上次审查以来发生了多少次提交

• 领先：在本地分支中有多少次提交不在origin中

• 后方：origin中有多少次提交不在您的本地分支中

• 拉取 & 推送：您的分支是否需要推送或拉取以跟踪origin

  • 绿色勾选框：您不需要拉取

  • 红色叉号：您需要拉取

  • 问号：您要么没有检出此分支的副本，要么需要修剪本地树

• 已修改：HEAD上次修改的时间（不是上次审查的时间）

安装

要从PyPi安装，您应该运行以下命令之一。（如果您使用pip进行软件包安装，您应该看看！）

pip install git-goggles

或

easy_install git-goggles

从github http://github.com/nowells/git-goggles检出项目

git clone git://github.com/nowells/git-goggles.git

以root身份运行setup.py

cd git-goggles
sudo python setup.py install

文档：使用Sphinx文档部署：在docs/目录中，输入

make html

然后打开docs/_build/index.html

使用方法

查看分支状态

git goggles

开始您的审查过程（显示origin差异）

git goggles codereview

完成您的审查过程（自动推送）

git goggles codereview complete

配置

您可以通过设置一些配置变量来更改git-goggles的默认工作方式。

禁用从所有远程服务器自动获取

git config --global gitgoggles.fetch false

禁用彩色输出

git config --global gitgoggles.colors false

更改用于显示成功、失败、未知状态的符号

git config --global gitgoggles.icons.success "OK"
git config --global gitgoggles.icons.failure "FAIL"
git config --global gitgoggles.icons.unknown "N/A"

更改分支状态的颜色。可用的颜色有[灰色、红色、绿色、黄色、蓝色、品红色、青色、白色]

git config --global gitgoggles.colors.local cyan
git config --global gitgoggles.colors.new red
git config --global gitgoggles.colors.review red
git config --global gitgoggles.colors.merge yellow
git config --global gitgoggles.colors.done green

更改分支列的宽度以启用单词换行。

git config --global gitgoggles.table.branch-width 15

更改表格单元格的内边距（默认为0）

git config --global gitgoggles.table.left-padding 1
git config --global gitgoggles.table.right-padding 1

更改表格行之间的水平规则显示（默认为false）

git config --global gitgoggles.table.horizontal-rule true

内部

git-goggles通过创建和管理称为“codereview-<branch_name>”的特殊标签来工作，并跟踪它们与HEAD之间的关系。

第一次完成codereview时创建标签。随后的审查会删除并重新创建标签，以确保它始终准确跟踪HEAD。