Python 命令行之旅:使用 docopt 实现 git 命令

简介:

Python 命令行之旅:使用 docopt 实现 git 命令

原文发表于 Prodesire 博客

一、前言

在前面两篇介绍 docopt 的文章中,我们全面了解了 docopt 的能力。按照惯例,我们要像使用 argparse 一样使用 docopt 来实现 git 命令。

为了让没读过 使用 argparse 实现 git 命令 的小伙伴也能读明白本文,我们仍会对 git 常用命令和 gitpython 做一个简单介绍。

本系列文章默认使用 Python 3 作为解释器进行讲解。
若你仍在使用 Python 2,请注意两者之间语法和库的使用差异哦~
AI 代码解读

二、git 常用命令

当你写好一段代码或增删一些文件后,会用如下命令查看文件状态:

git status
AI 代码解读

确认文件状态后,会用如下命令将的一个或多个文件(夹)添加到暂存区:

git add [pathspec [pathspec ...]]
AI 代码解读

然后使用如下命令提交信息:

git commit -m "your commit message"
AI 代码解读

最后使用如下命令将提交推送到远程仓库:

git push
AI 代码解读

我们将使用 docoptgitpython 库来实现这 4 个子命令。

三、关于 gitpython

gitpython 是一个和 git 仓库交互的 Python 第三方库。
我们将借用它的能力来实现真正的 git 逻辑。

安装:

pip install gitpython
AI 代码解读

四、思考

在实现前,我们不妨先思考下会用到 docopt 的哪些功能?整个程序的结构是怎样的?

docopt

不同于使用 argparse 时需要考虑嵌套解析器、各类参数等问题,在使用 docopt 只需将我们要实现的 git 命令用接口描述先定义清楚即可。

程序结构

程序结构上,除了开头处定义接口描述外,其余和使用 argparse 实现 git 命令的结构是一样的:

  • 命令行程序需要一个 cli 函数来作为统一的入口,它负责构建解析器,并解析命令行参数
  • 我们还需要四个 handle_xxx 函数响应对应的子命令

则基本结构如下:

import os
import docopt
from git.cmd import Git


def cli():
    """
    git 命名程序入口
    """
    pass


def handle_status(git):
    """
    处理 status 命令
    """
    pass

def handle_add(git, pathspec):
    """
    处理 add 命令
    """
    pass


def handle_commit(git, msg):
    """
    处理 -m <msg> 命令
    """
    pass


def handle_push(git):
    """
    处理 push 命令
    """
    pass


if __name__ == '__main__':
    cli()
AI 代码解读

下面我们将一步步地实现我们的 git 程序。

五、实现

假定我们在 docopt-git.py 文件中实现我们的 git 程序。

5.1 定义接口描述

根据我们的要求,可以很容易的定义出接口描述:

Usage:
    git status
    git add [<pathspec>...]
    git commit -m msg
    git push

Options:
  -h --help         Show help.
  -m --message msg  Commit with message.
AI 代码解读

进而就可以在 cli() 中解析命令行:

def cli():
    """
    git 命名程序入口
    """
    args = docopt(__doc__)
    git = Git(os.getcwd())
AI 代码解读

5.2 status 子命令

如果 args['status']True,说明输入了 status 子命令,那么就调用 handle_status 函数进行处理。

def cli():
    ...
    if args['status']:
        handle_status(git)


def handle_status(git):
    """
    处理 status 命令
    """
    cmd = ['git', 'status']
    output = git.execute(cmd)
    print(output)
AI 代码解读

不难看出,我们最后调用了真正的 git status 来实现,并打印了输出。

5.3 add 子命令

如果 args['add']True,说明输入了 add 子命令,那么就调用 handle_add 函数进行处理,需要传入 args['<pathspec>'] 表示添加的路径。

def cli():
    ...
    elif args['add']:
        handle_add(git, args['<pathspec>'])


def handle_add(git, pathspec):
    """
    处理 add 命令
    """
    cmd = ['git', 'add'] + pathspec
    output = git.execute(cmd)
    print(output)
AI 代码解读

5.4 commit 子命令

如果 args['commit']True,说明输入了 commit 子命令,那么就调用 handle_commit 函数进行处理,需要传入 args['--message'] 表示提交的信息。

def cli():
    ...
    elif args['commit']:
        handle_commit(git, args['--message'])


def handle_commit(git, msg):
    """
    处理 -m <msg> 命令
    """
    cmd = ['git', 'commit', '-m', msg]
    output = git.execute(cmd)
    print(output)
AI 代码解读

5.5 push 子命令

如果 args['push']True,说明输入了 commit 子命令,那么就调用 handle_push 函数进行处理。

def cli():
    ...
    elif args['push']:
        handle_push(git)


def handle_push(git):
    """
    处理 push 命令
    """
    cmd = ['git', 'push']
    output = git.execute(cmd)
    print(output)
AI 代码解读

至此,我们就实现了一个简单的 git 命令行,使用 python docopt-git.py status 便可查询项目状态。

想看整个源码,请戳 docopt-git.py

六、小结

本文简单介绍了日常工作中常用的 git 命令,然后提出实现它的思路,最终一步步地使用 docoptgitpython 实现了 git 程序。

对比 argparse 的实现版本,你会发现使用 docopt 来实现变得非常简单,子解析器、参数类型什么的统统不需要关心!这可以说是 docopt 最大的优势了。

关于 docopt 的讲解将告一段落,回顾下 docopt 的三步曲,加上今天的内容,感觉它的使用方式还是比 argparse 简单不少的。

现在,你已学会了两个命令行解析库的使用了。但你以为这就够了吗?

但人类的智慧是多么璀璨呀,有些人并不喜欢这两个库的使用方式,于是他们有开辟了一个全新的思路。

在下篇文章中,将为大家介绍一个在 Python 界十分流行的命令行库 —— click

目录
打赏
0
0
0
0
2
分享
相关文章
Python执行Shell命令并获取结果:深入解析与实战
通过以上内容,开发者可以在实际项目中灵活应用Python执行Shell命令,实现各种自动化任务,提高开发和运维效率。
41 20
使用Python执行Shell命令并获取结果
在实际应用中,可以根据需要选择适当的参数和方法来执行Shell命令,并处理可能出现的各种情况。无论是系统管理、自动化任务还是数据处理,掌握这些技巧都将极大地提高工作效率。
50 12
|
3月前
|
【10月更文挑战第2天】「Mac上学Python 2」入门篇2 - 开发环境命令行操作与文件管理
本篇将详细介绍Windows和Mac系统中的常用命令行操作与文件管理,帮助用户掌握如何通过终端或命令提示符进行文件管理和操作开发环境。内容涵盖路径切换、文件与文件夹的创建、删除、查看文件内容等基本操作,这些技能是后续Python开发的基础。
148 6
【10月更文挑战第2天】「Mac上学Python 2」入门篇2 - 开发环境命令行操作与文件管理
|
3月前
|
Python PDB命令介绍
【10月更文挑战第15天】 使用PDB的方式有两种,其中一种是在脚本中添加代码,不觉得这种方式比print好在哪里,所以这种方式此文不表。这里我们只学习PDB的命令行使用方式
68 4
pytorch学习一(扩展篇):miniconda下载、安装、配置环境变量。miniconda创建多版本python环境。整理常用命令(亲测ok)
这篇文章是关于如何下载、安装和配置Miniconda,以及如何使用Miniconda创建和管理Python环境的详细指南。
764 0
pytorch学习一(扩展篇):miniconda下载、安装、配置环境变量。miniconda创建多版本python环境。整理常用命令(亲测ok)
python环境学习:pip介绍,pip 和 conda的区别和联系。哪个更好使用?pip创建虚拟环境并解释venv模块,pip的常用命令,conda的常用命令。
本文介绍了Python的包管理工具pip和环境管理器conda的区别与联系。pip主要用于安装和管理Python包,而conda不仅管理Python包,还能管理其他语言的包,并提供强大的环境管理功能。文章还讨论了pip创建虚拟环境的方法,以及pip和conda的常用命令。作者推荐使用conda安装科学计算和数据分析包,而pip则用于安装无法通过conda获取的包。
208 0
Python:执行py命令,提示: Can‘t find a default Python.
Python:执行py命令,提示: Can‘t find a default Python.

热门文章

最新文章

AI助理

你好,我是AI助理

可以解答问题、推荐解决方案等