Bitbucket-branch-manager是一个用Nodejs编写的CLI。它帮助您管理远程分支和拉请求通过简单的命令行。 下面是命令行 Bitbucket API

特征

• 创建分支
• 删除分支
• 重置分支
• 开拉请求
• 合并拉取请求

安装

你需要安装 节点.js. 确保安装了nodejs ( node>= 12)

$ node -v
$ npm -v

安装bitbucket-branch-manager

$ npm install -g bitbucket-branch-manager

检查Bitbucket分支管理器是否已安装

$ bbm -v

设置配置

• 确保设置了基本身份验证位桶

  $ bbm set --basic-auth-username <username> 
  $ bbm set --basic-auth-password <password> 
  

• 设置默认工作区

  $ bbm set --default-workspace <workspace>
  

• 什么是工作空间？ 您将在工作区中创建存储库、协作处理代码以及在Bitbucket Cloud账户中组织不同的工作流。此时，您将获得一个工作区和一个工作区ID。

• 检查配置

  $ bbm get
  

Comamnd行文件

1. 存储库列表

• 您可以获取您的仓库列表（限制为100个项目）：

  $ bbm repo
  

• 或者使用别名

  # set index
  $ bbm repo --set-index-alias
  # check it
  $ bbm alias
  

2.创建分支

• 该命令将从其他源分支创建新的分支，请确保存在源分支或默认源分支
• 命令： bbm new|n <repo|aliasId> <branch> [source]
• 选项
  • -w <workspace> 或者 --workspace <workspace>
• 设置aliasId跟随 1. Repositories list 或者如果你已经做过了：

  $ bbm alias 
  #or
  $ bbm a
  

• 设置默认源分支:

  # another branch you want, my example is master
  $ bbm set --default-branch-create-from master
  

• 示例：
  • 完整命令:

    $ bbm new test-repo test-branch master
    

  • 简短的命令:

    # if not set default source branch
    $ bbm n 2 test-branch master
    # default source branch has aldready
    $ bbm n 2 test-branch
    

3. 删除分支

• 命令： bbm delete|d <repo|aliasId> <branch>
• 选项
  • -w <workspace> 或者 --workspace <workspace>
• 示例：
  • 完整命令:

    $ bbm delete test-repo test-branch
    

  • 简短的命令:

    $ bbm d 2 test-branch
    

4. 重设分支机构

• 该命令将从其他源分支删除并重新创建分支，请确保存在源分支或默认源分支
• 命令： bbm reset|r <repo|aliasId> [branch] [source]
• 选项
  • -w <workspace> 或者 --workspace <workspace>
• 设置默认源分支。您想要重置的分支将从此重新创建:

  # another branch you want, my example is master
  $ bbm set --default-branch-reset-from master
  

• 设置默认分支将被重置。

  # another branch you want, my example is master
  $ bbm set --default-branch-reset staging 
  

• 示例：
  • 完整命令:

    $ bbm reset test-repo test-branch master
    

  • 简短的命令:

    # if you not set default branch
    $ bbm r 2 test-branch master
    # if default destination branch has aldready
    $ bbm r 2 test-branch
    # if default destination branch and default branch reset has aldready
    $ bbm r 2 # mean delete staging and recreate from master
    

5. 开拉请求

• 这个命令将创建拉取请求到另一个分支。
• 命令： bbm open|o <repo|aliasId> <branch> [destination]
• 选项
  • -w <workspace> 或者 --workspace <workspace>
  • -t <title> 或者 --title <title> 如果你想设置标题或不标题默认是 branch name
  • -m 或者 --merge 如果你想要自动合并
• 设置默认目标

  # another branch you want, my example is master
  $ bbm set --default-branch-open-pull master
  

• 示例：
  • 完整命令

    $ bbm open test-repo test-branch master
    

  • 简短的命令

    # if you not set default branch
    $ bbm o 2 test-branch master
    # if default destination branch has aldready
    $ bbm o 2 test-branch
    

6. 合并拉取请求

• 该命令将按id合并您的pull请求
• 命令： bbm merge|m <repo> <pullId>
• 示例：
  • 完整命令:

    $ bbm merge test-repo 25
    

  • 简短的命令:

    $ bbm m test repo 25
    

结束

谢谢你花时间参观。