Git Spindle项目：BitBucket命令行工具详解

项目概述

Git Spindle是一个强大的命令行工具集，专门为BitBucket平台设计，旨在简化开发者与BitBucket的交互过程。该项目通过提供一系列git子命令（以git bb或git bucket形式调用），让开发者能够直接在终端完成各种BitBucket操作，无需频繁切换至网页界面。

基础配置与使用

首次使用配置

初次运行git bb命令时，系统会提示输入BitBucket账号信息（用户名和密码）。这些凭证会安全存储在用户主目录下的.gitspindle文件中。需要注意的是，该文件包含敏感信息，应当妥善保管。

账户验证

验证配置是否成功的最简单方式是使用whoami命令：

git bb whoami

该命令会返回当前账户的详细信息，包括用户名、个人资料链接、网站信息等。

多账户管理

对于需要管理多个BitBucket账户的开发者，Git Spindle提供了便捷的多账户支持：

1. 添加新账户：

git bb add-account <alias>

2. 使用特定账户执行操作：

git bb --account <alias> <command>

核心功能详解

仓库管理

创建新仓库

git bb create [--private] [--team=<team>] [--description=<description>]

此命令会：

1. 在BitBucket上创建新仓库
2. 自动设置本地仓库的origin远程
3. 支持设置私有仓库、团队仓库和描述信息

克隆操作

git bb clone [options] <repo> [<dir>]

支持多种克隆方式：

• 默认使用git协议
• 可通过--ssh或--http指定协议
• 支持三角工作流(--triangular)配置

分支管理

git bb set-origin [options]

此命令特别适合处理fork仓库，它会：

1. 自动配置origin和upstream远程
2. 设置分支跟踪关系
3. 支持三角工作流配置

协作功能

权限管理

git bb privileges        # 查看仓库权限
git bb add-privilege     # 添加权限
git bb remove-privilege  # 移除权限

部署密钥管理

git bb deploy-keys       # 列出部署密钥
git bb add-deploy-key    # 添加部署密钥
git bb remove-deploy-key # 移除部署密钥

代码审查流程

Pull Request处理

git bb pull-request [--yes] [<yours:theirs>]

特点：

• 自动检测当前分支与目标分支
• 打开编辑器编写PR描述
• 自动包含变更日志和差异统计

应用PR变更

git bb apply-pr <pr-number>

不同于BitBucket默认的合并方式，此命令使用cherry-pick方式应用变更，有助于保持提交历史的线性。

实用工具

远程文件操作

git bb cat <file>   # 查看远程文件内容
git bb ls <dir>     # 列出远程目录内容

代码片段管理

git bb snippet <file>  # 创建代码片段
git bb snippets       # 列出代码片段

高级技巧

1. 三角工作流配置：使用--triangular选项可以设置pull来自upstream，push发往origin的工作流，特别适合贡献开源项目。

2. 批量操作：部分命令支持通配符，如git bb mirror user/*可以镜像用户的所有仓库。

3. 自动化集成：通过配置SSH密钥或部署密钥，可以实现自动化部署流程。

注意事项

1. 权限变更在BitBucket上可能有最多1分钟的缓存延迟。

2. 处理非ASCII或非UTF-8字符集的提交信息时需谨慎，可能出现显示问题。

3. 对于私有仓库，某些命令会自动使用SSH协议以确保安全。

Git Spindle为BitBucket用户提供了一套完整、高效的命令行工具集，能够显著提升开发者的工作效率，特别适合经常需要与BitBucket交互的团队或个人开发者使用。