大家都说好用的Python命令行库click的使用


Posted in Python onNovember 07, 2019

一、前言

在本系列前面几篇文章中,我们分别介绍了 argparse 和 docopt 的主要功能和用法。它们各具特色,都能出色地完成命令行任务。argparse 是面向过程的,需要先设置解析器,再定义参数,再解析命令行,最后实现业务逻辑。而 docopt 先用声明式的语法定义出参数,再过程式地解析命令行和实现业务逻辑。在一些人看来,这些方式都不够优雅。

而今天要介绍的 click[2] 则是用一种你很熟知的方式来玩转命令行。命令行程序本质上是定义参数和处理参数,而处理参数的逻辑一定是与所定义的参数有关联的。那可不可以用函数和装饰器来实现处理参数逻辑与定义参数的关联呢?而 click 正好就是以这种方式来使用的。

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

二、介绍click

是一个以尽可能少的代码、以组合的方式创建优美的命令行程序的 Python 包。它有很高的可配置性,同时也能开箱即用。

它旨在让编写命令行工具的过程既快速又有趣,还能防止由于无法实现预期的 CLI API 所产生挫败感。它有如下三个特点:

  • 任意嵌套命令
  • 自动生成帮助
  • 支持运行时延迟加载子命令

三、快速开始

3.1 业务逻辑

首先定义业务逻辑,是不是感觉到有些难以置信呢?

不论是 argparse 还是 docopt,业务逻辑都是被放在最后一步,但 click 却是放在第一步。细想想 click 的这种方式才更符合人的思维吧?不论用什么命令行框架,我们最终关心的就是实现业务逻辑,其它的能省则省。

我们以官方示例为例,来介绍 click 的用法和哲学。假设命令行程序的输入是 name 和 count,功能是打印指定次数的名字。

那么在 hello.py 中,很容易写出如下代码:

def hello(count, name): 
  """Simple program that greets NAME for a total of COUNT times.""" 
  for x in range(count): 
    click.echo('Hello %s!' % name)

这段代码的逻辑很简单,就是循环 count 次,使用 click.echo 打印 name。其中,click.echo 和 print 的作用相似,但功能更加强大,能处理好 Unicode 和 二进制数据的情况。

3.2 定义参数

很显然,我们需要针对 count 和 name 来定义它们所对应的参数信息。

  • count 对应为命令行选项 --count,类型为数字,我们希望在不提供参数时,其默认值是 1
  • name 对应为命令行选项 --name,类型为字符串,我们希望在不提供参数时,能给人提示

使用 click,就可以写成下面这样:

from click import click 
 
@click.command() 
@click.option('--count', default=1, help='Number of greetings.') 
@click.option('--name', prompt='Your name', 
       help='The person to greet.') 
def hello(count, name): 
  ...

在上面的示例中:

  1. 使用装饰器的方式,即定义了参数,又将之与处理逻辑绑定,这真是优雅。和 argparse、docopt 比起来,就少了一步绑定过程
  2. 使用 click.command 表示 hello 是对命令的处理
  3. 使用 click.option 来定义参数选项
    1. 对于 --count 来说,使用 default 来指定默认值。而由于默认值是数字,进而暗示 --count 选项的类型为数字
    2. 对于 --name 来说,使用 prompt 来指定未输入该选项时的提示语
    3. 使用 help 来指定帮助信息

不论是装饰器的方式、还是各种默认行为,click 都是像它的介绍所说的那样,让人尽可能少地编写代码,让整个过程变得快速而有趣。

3.3 代码梳理

使用 click 的方式非常简单,我们将上文的代码汇总下,以有一个更清晰的认识:

# hello.py 
import click 
 
@click.command() 
@click.option('--count', default=1, help='Number of greetings.') 
@click.option('--name', prompt='Your name', 
       help='The person to greet.') 
def hello(count, name): 
  """Simple program that greets NAME for a total of COUNT times.""" 
  for x in range(count): 
    click.echo('Hello %s!' % name) 
 
if __name__ == '__main__': 
  hello()

若我们指定次数和名字:

$ python3 hello.py --count 2 --name Eric 
Hello Eric! 
Hello Eric!

若我们什么都不指定,则会提示输入名字,并默认输出一次:

$ python3 hello.py 
Your name: Eric 
Hello Eric!

我们还可以通过 --help 参数查看自动生成的帮助信息:

Usage: hello.py [OPTIONS] 
 
 Simple program that greets NAME for a total of COUNT times. 
 
Options: 
 --count INTEGER Number of greetings. 
 --name TEXT   The person to greet. 
 --help      Show this message and exit.

四、小结

click 的思路非常简单,定义处理函数,通过它的装饰器来定义参数。使用装饰器的绝妙之处就在于把定义和绑定这两个步骤合为一个步骤,使得整个过程变得如丝般顺滑。

click 除了以 Pythonic 的方式让命令行程序的实现变得更加优雅和好用外,还提供了比 argparse 和 docopt 都要强大的功能。在接下来几节中,我们将会逐步揭开它的面纱。

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持三水点靠木。

Python 相关文章推荐
python实现巡检系统(solaris)示例
Apr 02 Python
python socket 超时设置 errno 10054
Jul 01 Python
python判断图片宽度和高度后删除图片的方法
May 22 Python
Python学习小技巧之列表项的推导式与过滤操作
May 20 Python
PyCharm 常用快捷键和设置方法
Dec 20 Python
python和pygame实现简单俄罗斯方块游戏
Feb 19 Python
Linux下python3.7.0安装教程
Jul 30 Python
tensorflow使用神经网络实现mnist分类
Sep 08 Python
Python模块、包(Package)概念与用法分析
May 31 Python
PyQt4实时显示文本内容GUI的示例
Jun 14 Python
Django REST framework 单元测试实例解析
Nov 07 Python
python 偷懒技巧——使用 keyboard 录制键盘事件
Sep 21 Python
flask 实现token机制的示例代码
Nov 07 #Python
python3反转字符串的3种方法(小结)
Nov 07 #Python
Python中__repr__和__str__区别详解
Nov 07 #Python
Python通过Manager方式实现多个无关联进程共享数据的实现
Nov 07 #Python
Python上下文管理器类和上下文管理器装饰器contextmanager用法实例分析
Nov 07 #Python
Python中xml和dict格式转换的示例代码
Nov 07 #Python
python对象转字典的两种实现方式示例
Nov 07 #Python
You might like
PHP strncasecmp字符串比较的小技巧
2011/01/04 PHP
PHP封装的数据库保存session功能类
2016/07/11 PHP
JavaScript 事件属性绑定带参数的函数
2009/03/13 Javascript
Extjs在exlipse中设置自动提示的方法
2010/04/07 Javascript
JQuery+Ajax无刷新分页的实例代码
2014/02/08 Javascript
jQuery图片切换插件jquery.cycle.js使用示例
2014/06/16 Javascript
JavaScript获取网页、浏览器、屏幕高度和宽度汇总
2014/12/18 Javascript
JavaScript通过setTimeout实时显示当前时间的方法
2015/04/16 Javascript
JavaScript检测字符串中是否含有html标签实现方法
2015/07/01 Javascript
基于jQuery实现音乐播放试听列表
2016/04/14 Javascript
jQuery实现页面评论栏中访客信息自动填写功能的方法
2016/05/23 Javascript
jQuery动态增减行的实例代码解析(推荐)
2016/12/05 Javascript
javascript垃圾收集机制的原理分析
2016/12/08 Javascript
详解Vue.js Mixins 混入使用
2017/09/15 Javascript
Angular 4根据组件名称动态创建出组件的方法教程
2017/11/01 Javascript
vue-cli2打包前和打包后的css前缀不一致的问题解决
2018/08/24 Javascript
[02:39]DOTA2英雄基础教程 天怒法师
2013/11/29 DOTA
[52:20]DOTA2-DPC中国联赛正赛 SAG vs XGBO3 第一场 3月5日
2021/03/11 DOTA
跨平台python异步回调机制实现和使用方法
2013/11/26 Python
python简单实现基于SSL的IRC bot实例
2015/06/15 Python
20招让你的Python飞起来!
2016/09/27 Python
Python实现pdf文档转txt的方法示例
2018/01/19 Python
Python实现的栈(Stack)
2018/01/26 Python
NLTK 3.2.4 环境搭建教程
2018/09/19 Python
Python3爬虫学习入门教程
2018/12/11 Python
使用python将请求的requests headers参数格式化方法
2019/01/02 Python
python日志模块logbook使用方法
2019/09/19 Python
python Dijkstra算法实现最短路径问题的方法
2019/09/19 Python
阿根廷旅游网站:almundo阿根廷
2018/02/12 全球购物
大学生毕业的自我鉴定
2013/11/13 职场文书
教师专业自荐信
2014/05/31 职场文书
篮球社团活动总结
2014/06/27 职场文书
2014年保育员个人工作总结
2014/12/02 职场文书
2015秋季新学期开学寄语
2015/05/28 职场文书
CSS 新特性 contain控制页面的重绘与重排问题
2021/04/30 HTML / CSS
php将xml转化对象的实例详解
2021/11/17 PHP