Python 基础(二十一):argparse 模块
1. 简介
argparse 模块主要用于处理 Python 命令行参数和选项,程序定义好所需参数后,该模块会通过 sys.argv
解析出那些参数;除此之外,argparse 模块还会自动生成帮助和使用手册,并在用户给程序传入无效参数时报出错误信息。使用 argparse 模块,我们可以轻松的编写出用户友好的命令行接口。
2. 使用
我们先来看一个简单示例:
import argparse
# 创建解析对象
parser = argparse.ArgumentParser()
# 解析
parser.parse_args()
文件名为 test.py
,在控制输入命令:python test.py --help
,执行结果:
usage: test.py [-h]
optional arguments:
-h, --help show this help message and exit
通过上面的执行结果,我们可以看出 Python 的可选参数包括:--help
和其简写 -h
,Python 使用 -
来指定短参数,使用 --
来指定长参数 ,我们执行一下 python test.py -h
,执行结果:
usage: test.py [-h]
optional arguments:
-h, --help show this help message and exit
如果使用未定义的参数会报错,如:执行命令 python test.py -a
,执行结果:
usage: test.py [-h]
test.py: error: unrecognized arguments: -a
接下来我们看一下如何自定义参数,因为上面示例中 ArgumentParser()
和 parse_args()
函数,我们还没有详细说,所以这里我们也具体看一下:
ArgumentParser(prog=None, usage=None, description=None, epilog=None, parents=[], formatter_class=argparse.HelpFormatter, prefix_chars='-', fromfile_prefix_chars=None, argument_default=None, conflict_handler='error', add_help=True, allow_abbrev=True)
这个方法是用来创建解析器对象的,看一下方法中每一个参数的含义:
- prog:程序的名称(默认:sys.argv[0])
- usage:描述程序用途的字符串(默认值:从添加到解析器的参数生成)
- description:在参数帮助文档之前显示的文本(默认值:无)
- epilog:在参数帮助文档之后显示的文本(默认值:无)
- parents:一个 ArgumentParser 对象的列表,它们的参数也应包含在内
- formatter_class:用于自定义帮助文档输出格式的类
- prefix_chars:可选参数的前缀字符集合(默认值:'-')
- fromfile_prefix_chars:当需要从文件中读取其他参数时,用于标识文件名的前缀字符集合(默认值:None)
- argument_default:参数的全局默认值(默认值:None)
- conflict_handler:解决冲突选项的策略(通常是不必要的)
- add_help:为解析器添加一个 -h/--help 选项(默认值:True)
- allow_abbrev:如果缩写是无歧义的,则允许缩写长选项 (默认值:True)
parse_args(args=None, namespace=None)
用来解析参数,看一下参数说明:
- args:要分析的字符串列表,默认取自 sys.argv
- namespace:命名空间
add_argument(name or flags...[, action][, nargs][, const][, default][, type][, choices][, required][, help][, metavar][, dest])
定义单个的命令行参数应当如何解析,看一下参数说明:
- name or flags:一个命名或者一个选项字符串的列表,例如:-f,--foo
- action:当参数在命令行中出现时使用的动作基本类型
- nargs:命令行参数应当消耗的数目
- const:被一些 action 和 nargs 选择所需求的常数
- default:当参数未在命令行中出现时使用的值
- type:命令行参数应当被转换成的类型
- choices:可用的参数的容器
- required:此命令行选项是否可省略
- help:一个选项作用的简单描述
- metavar:在使用方法消息中使用的参数值示例
- dest:被添加到 parse_args() 所返回对象上的属性名
下面我们通过具体示例看一下:
import argparse
parser = argparse.ArgumentParser()
parser.add_argument(
'-n', '--name', dest='rname', required=True,
help='increase output name'
)
args = parser.parse_args()
name = args.rname
print('Hello', name)
先在控制台执行命令 python test.py -h
,执行结果:
usage: test.py [-h] -n RNAME
optional arguments:
-h, --help show this help message and exit
-n RNAME, --name RNAME
increase output name
我们可以看到参数已经添加进来了,接着执行命令 python test.py -n Jhon
或 python test.py --name Jhon
,执行结果:
Hello Jhon
从结果可以看出我们已经获取了控制台中输入的参数值了。
参考:
https://docs.python.org/zh-cn/3/library/argparse.html
- JavaScript 教程
- JavaScript 编辑工具
- JavaScript 与HTML
- JavaScript 与Java
- JavaScript 数据结构
- JavaScript 基本数据类型
- JavaScript 特殊数据类型
- JavaScript 运算符
- JavaScript typeof 运算符
- JavaScript 表达式
- JavaScript 类型转换
- JavaScript 基本语法
- JavaScript 注释
- Javascript 基本处理流程
- Javascript 选择结构
- Javascript if 语句
- Javascript if 语句的嵌套
- Javascript switch 语句
- Javascript 循环结构
- Javascript 循环结构实例
- Javascript 跳转语句
- Javascript 控制语句总结
- Javascript 函数介绍
- Javascript 函数的定义
- Javascript 函数调用
- Javascript 几种特殊的函数
- JavaScript 内置函数简介
- Javascript eval() 函数
- Javascript isFinite() 函数
- Javascript isNaN() 函数
- parseInt() 与 parseFloat()
- escape() 与 unescape()
- Javascript 字符串介绍
- Javascript length属性
- javascript 字符串函数
- Javascript 日期对象简介
- Javascript 日期对象用途
- Date 对象属性和方法
- Javascript 数组是什么
- Javascript 创建数组
- Javascript 数组赋值与取值
- Javascript 数组属性和方法