3个Python 命令行工具

用 Click、Docopt 和 Fire 库写你自己的命令行应用。

-- Jeff Triplett, Lacey Williams Hensche

致谢

编译自 |

https://opensource.com/article/18/5/3-python-command-line-tools

作者 | Jeff Triplett, Lacey Williams Hensche

译者 | jdong (hoppipolla-) 共计翻译:1篇 贡献时间:1 天

用 Click、Docopt 和 Fire 库写你自己的命令行应用。

有时对于某项工作来说一个命令行工具就足以胜任。命令行工具是一种从你的 shell 或者终端之类的地方交互或运行的程序。Git

[1]

和Curl

[2]

就是两个你也许已经很熟悉的命令行工具。

当你有一小段代码需要在一行中执行多次或者经常性地被执行,命令行工具就会很有用。Django 开发者执行 命令来启动他们的网络服务器;Docker 开发者执行 来启动他们的容器。你想要写一个命令行工具的原因可能和你一开始想写代码的原因有很大不同。

对于这个月的 Python 专栏,我们有 3 个库想介绍给希望为自己编写命令行工具的 Python 使用者。

Click

Click

[3]

是我们最爱的用来开发命令行工具的 Python 包。其:

◈ 有一个富含例子的出色文档

◈ 包含说明如何将命令行工具打包成一个更加易于执行的 Python 应用程序

◈ 自动生成实用的帮助文本

◈ 使你能够叠加使用可选和必要参数,甚至是多个命令

[4]

◈ 有一个 Django 版本(

[5]

)用来编写管理命令

Click 使用 去声明一个函数作为命令,同时可以指定必要和可选参数。

修饰器声明了一个可选参数

[6]

,而 修饰器声明了一个必要参数

[7]

。你可以通过叠加修饰器来组合可选和必要参数。 方法将结果打印到控制台。

Docopt

Docopt

[8]

是一个命令行工具的解析器,类似于命令行工具的 Markdown。如果你喜欢流畅地编写应用文档,在本文推荐的库中 Docopt 有着最好的格式化帮助文本。它不是我们最爱的命令行工具开发包的原因是它的文档犹如把人扔进深渊,使你开始使用时会有一些小困难。然而,它仍是一个轻量级的、广受欢迎的库,特别是当一个漂亮的说明文档对你来说很重要的时候。

Docopt 对于如何格式化文章开头的 docstring 是很特别的。在工具名称后面的 docsring 中,顶部元素必须是 并且需要列出你希望命令被调用的方式(比如:自身调用,使用参数等等)。 需要包含 和 参数。

docstring 中的第二个元素是 ,对于在 中提及的可选项和参数,它应当提供更多的信息。你的 docstring 的内容变成了你帮助文本的内容。

在最基本的层面,Docopt 被设计用来返回你的参数键值对。如果我不指定上述的 调用上面的命令,我会得到一个字典的返回值:

这里可看到我没有输入 和 标记并且 参数是 。

但是如果我带着一个 参数调用, 函数就会执行了。

Docopt 允许同时指定必要和可选参数,且各自有着不同的语法约定。必要参数需要在 和 中展示,而可选参数需要单双横杠显示,就像 。更多内容可以阅读 Docopt 有关patterns

[9]

的文档。

Fire

Fire

[10]

是谷歌的一个命令行工具开发库。尤其令人喜欢的是当你的命令需要更多复杂参数或者处理 Python 对象时,它会聪明地尝试解析你的参数类型。

Fire 的文档

[11]

包括了海量的样例,但是我希望这些文档能被更好地组织。Fire 能够处理同一个文件中的多条命令

[12]

、使用对象

[13]

的方法作为命令和分组

[14]

命令。

它的弱点在于输出到控制台的文档。命令行中的 docstring 不会出现在帮助文本中,并且帮助文本也不一定标识出参数。

参数是必要还是可选取决于你是否在函数或者方法定义中为其指定了一个默认值。要调用命令,你必须指定文件名和函数名,比较类似 Click 的语法:

你还可以像标记一样传参,比如 。

额外赠送:打包!

Click 包含了使用打包

[15]

命令行工具的使用说明(强烈推荐按照说明操作)。

要打包我们第一个例子中的命令行工具,将以下内容加到你的 文件里:

任何你看见 的地方,使用你自己的模块名称替换掉,但是要记得忽略 后缀名。将 替换成你的函数名称。

然后,执行 来使你的命令在命令行中可用。

现在你可以调用你的命令,就像这样:

通过打包你的命令,你可以省掉在控制台键入 这种额外的步骤以减少键盘敲击。这些指令也很可能可在我们提到的其他库中使用。

via:https://opensource.com/article/18/5/3-python-command-line-tools

作者:Jeff Triplett

[17]

,Lacey Williams Hensche

[17]

选题:lujun9972译者:hoppipolla-校对:wxy

本文由LCTT原创编译,Linux中国荣誉推出

  • 发表于:
  • 原文链接https://kuaibao.qq.com/s/20180705B0EDF700?refer=cp_1026
  • 腾讯「云+社区」是腾讯内容开放平台帐号(企鹅号)传播渠道之一,根据《腾讯内容开放平台服务协议》转载发布内容。

扫码关注云+社区

领取腾讯云代金券