花下猫语:上篇文章提到了 invoke 也可以作为命令行工具库使用,但此用法有点像主功能的副产品,实际上,开发命令行程序最好是用主流的几个库。今天分享的文章,对 argparse、docopt、click 和 fire 这几个库做了横向对比,梳理了它们的异同与利弊,值得一读。
剧照 | 《大鱼》
作者:HelloGitHub-Prodesire
原题:用什么库写 Python 命令行程序?看这一篇就够了
一、前言
在近半年的 Python 命令行旅程中,我们依次学习了 、、 和 库的特点和用法,逐步了解到 Python 命令行库的设计哲学与演变。本文作为本次旅程的终点,希望从一个更高的视角对这些库进行横向对比,总结它们的异同点和使用场景,以期在应对不同场景时能够分析利弊,选择合适的库为己所用。
二、设计理念
在讨论各个库的设计理念之前,我们先设计一个,其实这个例子在 库的第一篇讲解中出现过,也就是:
命令行程序接受一个位置参数,它能出现多次,且是数字
默认情况下,命令行程序会求出给定的一串数字的最大值
如果指定了选项参数 ,那么就会将求出给定的一串数字的和
希望从各个库实现该例子的代码中能进一步体会它们的设计理念。
2.1、argparse
的设计理念就是提供给你最细粒度的控制,你需要详细地告诉它参数是选项参数还是位置参数、参数值的类型是什么、该参数的处理动作是怎样的。总之,它就像是一个没有智能分析能力的初代机器人,你需要告诉它明确的信息,它才会根据给定的信息去帮助你做事情。
以下示例为 实现的 :
从上述示例可以看到,我们需要通过 很明确地告诉 参数长什么样:
它是位置参数 ,还是选项参数
它的类型是什么,比如 表示类型是 int
这个参数能重复出现几次,比如 表示至少提供 1 个
参数的是存什么的,比如 表示存常量
然后它才根据给定的这些元信息来解析命令行参数(也就是示例中的 )。
这是很计算机的思维,虽然冗长,但也带来了灵活性。
2.2、docopt
从 的理念可以看出,它是命令式的。这时候 另辟蹊径,声明式是不是也可以?一个命令行程序的帮助信息其实已然包含了这个命令行的完整元信息,那不就可以通过定义帮助信息来定义命令行? 就是基于这样的想法去设计的。
声明式的好处在于只要你掌握了声明式的语法,那么定义命令行的元信息就会很简单。
以下示例为 实现的 :
从上述示例可以看到,我们通过 定义了接口描述,这和 中 是等价的,然后 便会根据这个元信息把命令行参数转换为一个字典。业务逻辑中就需要对这个字典进行处理。
对比与 :
对于更为复杂的命令程序,元信息的定义上 会更加简单
然而在业务逻辑的处理上,由于 在一些简单参数的处理上会更加便捷(比如示例中的情形),相对来说 转换为字典后就把所有处理交给业务逻辑的方式会更加复杂
2.3、click
命令行程序本质上是定义参数和处理参数,而处理参数的逻辑一定是与所定义的参数有关联的。那可不可以用函数和装饰器来实现处理参数逻辑与定义参数的关联呢?而 正好就是以这种使用方式来设计的。
使用装饰器的好处就在于用装饰器优雅的语法将参数定义和处理逻辑整合在一起,从而暗示了路由关系。相比于 和 需要自行对解析后的参数来做路由关系,简单了不少。
以下示例为 实现的 :
从上述示例可以看出,参数和对应的处理逻辑非常好地绑定在了一起,看上去就很直观,使得我们可以明确了解参数会怎么处理,这在有大量参数时显得尤为重要,这边是 相比于 和 最明显的优势。
此外, 还内置了很多实用工具和额外能力,比如说 Bash 补全、颜色、分页支持、进度条等诸多实用功能,可谓是如虎添翼。
2.4、fire
则是用一种面向广义对象的方式来玩转命令行,这种对象可以是类、函数、字典、列表等,它更加灵活,也更加简单。你都不需要定义参数类型, 会根据输入和参数默认值来自动判断,这无疑进一步简化了实现过程。
以下示例为 实现的 :
从上述示例可以看出, 提供的方式无疑是最简单、并且最 Pythonic 的了。我们只需关注业务逻辑,而命令行参数的定义则和函数参数的定义融为了一体。
不过,有利自然也有弊,比如 并没有说是什么类型,也就意味着输入字符串'abc'也是合法的,这就意味着一个严格的命令行程序必须在自己的业务逻辑中来对期望的类型进行约束。
三、横向对比
最后,我们横向对比下、、 和 库的各项功能和特点:
Python 的命令行库种类繁多、各具特色。结合上面的总结,可以选择出符合使用场景的库,如果几个库都符合,那么就根据你更偏爱的风格来选择。这些库都很优秀,其背后的思想很是值得我们学习和扩展。
感谢创作者的好文
领取专属 10元无门槛券
私享最新 技术干货