花下猫语:Python 中有几个命令行工具库,但我个人认为,最优秀的还属 click,今天分享的文章正是介绍它。按照惯例,该系列会连续几篇文章深入介绍一个开源库,值得期待。
剧照 | 《奇葩说》
作者:HelloGitHub-Prodesire
涉及的示例代码,已同步更新到HelloGitHub-Team 仓库[1]
一、前言
在本系列前面几篇文章中,我们分别介绍了 和 的主要功能和用法。它们各具特色,都能出色地完成命令行任务。 是面向过程的,需要先设置解析器,再定义参数,再解析命令行,最后实现业务逻辑。而 先用声明式的语法定义出参数,再过程式地解析命令行和实现业务逻辑。在一些人看来,这些方式都不够优雅。
而今天要介绍的click[2]则是用一种你很熟知的方式来玩转命令行。命令行程序本质上是定义参数和处理参数,而处理参数的逻辑一定是与所定义的参数有关联的。那可不可以用函数和装饰器来实现处理参数逻辑与定义参数的关联呢?而 正好就是以这种方式来使用的。
二、介绍
click是一个以尽可能少的代码、以组合的方式创建优美的命令行程序的 Python 包。它有很高的可配置性,同时也能开箱即用。
它旨在让编写命令行工具的过程既快速又有趣,还能防止由于无法实现预期的 CLI API 所产生挫败感。它有如下三个特点:
任意嵌套命令
自动生成帮助
支持运行时延迟加载子命令
三、快速开始
3.1 业务逻辑
首先定义业务逻辑,是不是感觉到有些难以置信呢?
不论是 还是 ,业务逻辑都是被放在最后一步,但 却是放在第一步。细想想 的这种方式才更符合人的思维吧?不论用什么命令行框架,我们最终关心的就是实现业务逻辑,其它的能省则省。
我们以官方示例为例,来介绍 的用法和哲学。假设命令行程序的输入是 和 ,功能是打印指定次数的名字。
那么在 中,很容易写出如下代码:
这段代码的逻辑很简单,就是循环 次,使用 打印 。其中, 和 的作用相似,但功能更加强大,能处理好 Unicode 和 二进制数据的情况。
3.2 定义参数
很显然,我们需要针对 和 来定义它们所对应的参数信息。
对应为命令行选项 ,类型为数字,我们希望在不提供参数时,其默认值是 1
对应为命令行选项 ,类型为字符串,我们希望在不提供参数时,能给人提示
使用 ,就可以写成下面这样:
在上面的示例中:
使用装饰器的方式,即定义了参数,又将之与处理逻辑绑定,这真是优雅。和 、 比起来,就少了一步绑定过程
使用 表示 是对命令的处理
使用 来定义参数选项
对于 来说,使用 来指定默认值。而由于默认值是数字,进而暗示 选项的类型为数字
对于 来说,使用 来指定未输入该选项时的提示语
使用 来指定帮助信息
不论是装饰器的方式、还是各种默认行为, 都是像它的介绍所说的那样,让人尽可能少地编写代码,让整个过程变得快速而有趣。
3.3 代码梳理
使用 的方式非常简单,我们将上文的代码汇总下,以有一个更清晰的认识:
若我们指定次数和名字:
若我们什么都不指定,则会提示输入名字,并默认输出一次:
我们还可以通过 参数查看自动生成的帮助信息:
四、小结
的思路非常简单,定义处理函数,通过它的装饰器来定义参数。使用装饰器的绝妙之处就在于把定义和绑定这两个步骤合为一个步骤,使得整个过程变得如丝般顺滑。
除了以 的方式让命令行程序的实现变得更加优雅和好用外,还提供了比 和 都要强大的功能。在接下来几节中,我们将会逐步揭开它的面纱。
参考资料
HelloGitHub-Team 仓库:https://github.com/HelloGitHub-Team/Article
click: https://click.palletsprojects.com/