Legit: 人性化的Git命令行工具

1. 安装指南

Legit可以通过以下方式安装：

• 使用Python包管理器PyPI：

  pip install legit
  

• 下载Windows平台的独立可执行文件，从GitHub的Release页面获取。

• 在macOS和Linux系统上，可以使用Homebrew安装：

  brew install legit
  

• 若要安装最新的开发版本，可以从git仓库克隆：

  git clone https://github.com/frostming/legit.git
  cd legit
  python setup.py install
  

  注意：如果遇到Permission denied错误，可以在命令前添加sudo。

安装完成后，你就可以在仓库内使用legit命令了。

2. 项目使用说明

Legit提供了一系列简化的Git操作命令，以下是一些基本的使用说明：

• 切换分支：

  legit switch <branch>
  

  默认切换到当前分支，并自动存储和恢复更改。

• 同步分支：

  legit sync [<branch>]
  

  默认同步当前分支，包括存储、获取、自动合并/变基、推送和恢复。

• 发布分支：

  legit publish [<branch>]
  

  将指定的分支发布到远程仓库。

• 从远程移除分支：

  legit unpublish <branch>
  

• 撤销最后的提交：

  legit undo
  

• 显示可用分支：

  legit branches [<wildcard pattern>]
  

  支持使用通配符模式匹配分支名称。

3. 项目API使用文档

Legit工具的每个命令都支持--verbose和--fake选项。

• 使用--verbose选项可以查看legit调用的git命令：

  legit sync --verbose
  

• 使用--fake选项可以查看但不执行legit将要调用的git命令：

  legit publish --fake
  

在git配置中，可以设置legit.smartMerge来控制合并行为。默认情况下，legit sync会避免真正的合并，如果合并不是快进式合并，legit将会变基。

4. 项目安装方式

除了上述的安装方法外，以下是安装Legit的一些其他方式：

• 运行以下命令安装git别名：

  legit --install
  

• 若要卸载git别名，使用以下命令：

  legit --uninstall
  

注意：所有的远程操作都是通过在$ git config legit.remote remotename中指定的远程仓库上进行的。如果stash pop合并失败，Legit将会停止。未来版本中可能会增加检查合并失败的功能，并提供友好的错误报告。