花下猫语: 今天,我在查阅如何用 Python 操作 Gitlab 的时候,看到这篇文章,觉得还不错,特分享给大家 。文中还提到了其它几种操作 Git 的方法,后续有机会的话,再陆续分享之~~
作者:匿蟒
出处:https://note.qidong.name/2018/01/gitpython
有时,需要做复杂的 Git 操作,并且有很多中间逻辑 。用 Shell 做复杂的逻辑运算与流程控制就是一个灾难 。所以,用 Python 来实现是一个愉快的选择 。这时,就需要在 Python 中操作 Git 的库 。
GitPython 简介GitPython是一个与Git库交互的Python库,包括底层命令(Plumbing)与高层命令(Porcelain) 。它可以实现绝大部分的Git读写操作,避免了频繁与Shell交互的畸形代码 。它并非是一个纯粹的Python实现,而是有一部分依赖于直接执行git命令,另一部分依赖于GitDB 。
GitDB也是一个Python库 。它为.git/objects建立了一个数据库模型,可以实现直接的读写 。由于采用流式(stream)读写,所以运行高效、内存占用低 。
GitPython安装 pip install GitPython其依赖GitDB会自动安装,不过可执行的git命令需要额外安装 。
基本用法initimport git repo = git.Repo.init(path='.')这样就在当前目录创建了一个Git库 。当然,路径可以自定义 。
由于git.Repo实现了__enter__与__exit__,所以可以与with联合使用 。
with git.Repo.init(path='.') as repo: # do sth with repo不过,由于只是实现了一些清理操作,关闭后仍然可以读写,所以使用这种形式的必要性不高 。详见附录 。
cloneclone分两种 。一是从当前库clone到另一个位置:
new_repo = repo.clone(path='../new')二是从某个URL那里clone到本地某个位置:
new_repo = git.Repo.clone_from(url='git@github.com:USER/REPO.git', to_path='../new')commit with open('test.file', 'w') as fobj: fobj.write('1st linen') repo.index.add(items=['test.file']) repo.index.commit('write a line into test.file') ? with open('test.file', 'aw') as fobj: fobj.write('2nd linen') repo.index.add(items=['test.file']) repo.index.commit('write another line into test.file')statusGitPython并未实现原版git status,而是给出了部分的信息 。
>>> repo.is_dirty() False >>> with open('test.file', 'aw') as fobj: >>> fobj.write('dirty linen') >>> repo.is_dirty() True>>> repo.untracked_files [] >>> with open('untracked.file', 'w') as fobj: >>> fobj.write('') >>> repo.untracked_files ['untracked.file']checkout(清理所有修改)>>> repo.is_dirty() True >>> repo.index.checkout(force=True) <generator object <genexpr> at 0x7f2bf35e6b40> >>> repo.is_dirty() Falsebranch获取当前分支:
head = repo.head新建分支:
new_head = repo.create_head('new_head', 'HEAD^')切换分支:
new_head.checkout() head.checkout()删除分支:
git.Head.delete(repo, new_head) # or git.Head.delete(repo, 'new_head')merge以下演示如何在一个分支(other),merge另一个分支(master) 。
master = repo.heads.master other = repo.create_head('other', 'HEAD^') other.checkout() repo.index.merge_tree(master) repo.index.commit('Merge from master to other')remote, fetch, pull, push
创建remote:remote = repo.create_remote(name='gitlab', url='git@gitlab.com:USER/REPO.git')远程交互操作:remote = repo.remote() remote.fetch() remote.pull() remote.push()删除remote:repo.delete_remote(remote) # or repo.delete_remote('gitlab')其它其它还有Tag、Submodule等相关操作,不是很常用,这里就不介绍了 。
GitPython的优点是在做读操作时可以方便地获取内部信息,缺点是在做写操作时感觉很不顺手,隔靴搔痒 。当然,它还支持直接执行git操作 。
git = repo.git git.status() git.checkout('HEAD', b="my_new_branch") git.branch('another-new-one') git.branch('-D', 'another-new-one')这……感觉又回到了老路,而且仍然感觉怪怪的 。
其它操作Git的方法subprocess这就是所谓『老路』 。在另一个进程,执行Shell命令,并通过stdio来解析返回结果 。
import subprocess subprocess.call(['git', 'status'])dulwichdulwich是一个纯Python实现的Git交互库,以后有空再研究吧 。
官方网站:https://www.dulwich.io/
pygit2pygit2是基于libgit2实现的一个Python库 。底层是C,而上层Python只是接口,运行效率应该是最高的,然而孤还是放弃了 。其缺点是,需要环境中预先安装libgit2 。相比之下,GitPython只需要环境预置Git,简单多了 。
推荐阅读
- 黑客如何入侵企业网络?
- 如何处理湿茶用温水稍微炒下恢复
- 如何在 CentOS 8/RHEL 8 上安装和使用 Cockpit
- 茶具名称及功夫茶具使用说明
- mysql 如何查看sql语句执行时间和效率
- 使用shell脚本在centos8平台安装nginx服务
- 如何购买茶具
- 你如何烹饪
- 清洗茶具的礼仪是什么为什么要使用茶具
- 买壶 如何识别化工壶呢