GitPython 是一个用于操作 Git 版本库的 python 包,它提供了一系列的对象模型(库 - Repo、树 - Tree、提交 - Commit等),用于操作版本库中的相应对象。
1、导包
from git import *
2、初始化git仓库
CURRENT_DIR = os.path.dirname(os.path.abspath(__file__)) empty_repo = Repo.init(os.path.join(CURRENT_DIR, 'bbs')) # bbs目录不存在则新建
3、如果git仓库已存在,直接获取
repo = Repo(os.path.join(CURRENT_DIR, 'bbs'))
4、获取当前远程库
repo.remotes # 获取当前有哪些远程库 = git remote -v命令,返回一个repo列表
5、新建远程库
# 新建远程库 = git remote add origin git_url, 返回Remote对象(<class 'git.remote.Remote'>) origin = repo.create_remote('origin', git_url)
6、fetch
origin.fetch()
7、建立一个关联远程分支的本地分支,分三步
empty_repo.create_head('master', origin.refs.master) # create local branch "master" from remote "master" empty_repo.heads.master.set_tracking_branch(origin.refs.master) # set local "master" to track remote "master empty_repo.heads.master.checkout() # checkout local "master" to working tree # 以上三步可以简化为一行代码 repo.create_head('master', origin.refs.master).set_tracking_branch(origin.refs.master).checkout() # 建立本地master分支,关联远程master分支,checkout
8、获取所有远程分支
origin.refs # 返回所有远程分支列表 [<git.RemoteReference "refs/remotes/new_origin/develop">, <git.RemoteReference "refs/remotes/new_origin/master">]
9、获取所有本地分支(git.HEAD)和远程分支(git.RemoteReference)
repo.refs # 返回所有本地分支列表
10、获取本地heads
repo.heads # 返回Head列表
11、获取当前head指向
repo.head.reference
12、切换分支
a、本地存在此分支 repo.head.reference = repo.heads.develop b、本地不存在,需要从远程拉去 repo.create_head('master', origin.refs.master).set_tracking_branch(origin.refs.master).checkout()
总结