Git-Bzr-NG 项目技术文档

1. 安装指南

1.1 系统要求

• git：需要安装一个较新的版本。
• bzr：支持版本 2.2 或 2.3.0。
• bzr-fastimport：版本 0.10，可以从 bzr-fastimport 下载。
• python-fastimport：用于 bzr-fastimport，可以通过 bzr branch lp:python-fastimport 安装。

1.2 安装步骤

1. 安装 git 和 bzr。
2. 下载并安装 bzr-fastimport：

   wget http://launchpad.net/bzr-fastimport/trunk/0.10.0/+download/bzr-fastimport-0.10.0.tar.gz
   tar -xzf bzr-fastimport-0.10.0.tar.gz
   cd bzr-fastimport-0.10.0
   python setup.py install
   

3. 安装 python-fastimport：

   bzr branch lp:python-fastimport
   cd python-fastimport
   python setup.py install
   

4. 将 git-bzr 脚本放置在系统的 PATH 中。

2. 项目的使用说明

2.1 基本用法

• 克隆 Launchpad 仓库：

  git bzr clone lp:nova nova
  cd nova
  git branch -a
  

  结果会显示 bzr/master 和 master 分支。

• 创建新分支：

  git checkout -b touch_branch
  echo "TOUCH" >> README
  git commit -a -m "touch touch"
  git bzr push lp:~termie/nova/touch_branch
  

  现在你已经将新分支推送到服务器上。

• 同步主干分支：

  git checkout master
  git bzr sync
  git diff bzr/master
  

• 导入他人补丁：

  git bzr import lp:~vishvananda/nova/fix-part fix-part
  git diff touch_branch
  

2.2 其他操作

• 强制覆盖同步：

  git bzr sync --overwrite bzr/nova
  

  这将强制覆盖指定的分支。

• 清除 bzr 相关信息：

  git bzr clear
  

  这将清除指定分支的 bzr 相关信息。

3. 项目API使用文档

3.1 git bzr clone

• 功能：克隆一个 Launchpad 仓库。
• 用法：

  git bzr clone lp:repo_name destination_dir
  

3.2 git bzr push

• 功能：将当前分支推送到 Launchpad。
• 用法：

  git bzr push [lp:~user/repo/branch_name]
  

3.3 git bzr sync

• 功能：同步当前分支与 Launchpad 上的分支。
• 用法：

  git bzr sync [--overwrite bzr/branch_name]
  

3.4 git bzr import

• 功能：导入一个 Launchpad 上的补丁。
• 用法：

  git bzr import lp:~user/repo/branch_name local_branch_name
  

3.5 git bzr clear

• 功能：清除指定分支的 bzr 相关信息。
• 用法：

  git bzr clear
  

4. 项目安装方式

4.1 手动安装

1. 下载并安装 bzr-fastimport 和 python-fastimport。
2. 将 git-bzr 脚本放置在系统的 PATH 中。

4.2 自动安装

可以通过 pip 安装 bzr-fastimport 和 python-fastimport：

pip install bzr-fastimport
pip install python-fastimport

4.3 测试安装

运行测试脚本以确保安装正确：

python run_tests.py

通过以上步骤，您可以顺利安装并使用 git-bzr-ng 项目，实现 git 和 bzr 之间的双向桥接。