python包合集-argparse

一、argparse简介

　　argparse 是 python 自带的命令行参数解析包，可以用来方便的服务命令行参数，使用之前需要先导入包 import argparse
二、简单案例

　　简单使用，创建一个名为test.py的文件

1. # 导入 argparse 模块
2. import argparse
4. # 创建一个argparse 的对象
5. parser = argparse.ArgumentParser()
7. # 添加一个接收参数，默认值为Se7eN
8. parser.add_argument("-n", "--name", default="Se7eN")
10. # 获取对应的参数的值
11. args = parser.parse_args()
13. # 控制台打印出来接收到的值
14. print("args = {}".format(args))

复制代码

　　打印结果为：

1. houlei@houleideMacBook-Pro argparse_demo % python3 test.py   # 此时在test.py后面没有跟上参数，
2. args = Namespace(name='Se7eN')   # 所以打印出来的name为默认值 Se7eN

复制代码

　　再次验证：

1. houlei@houleideMacBook-Pro argparse_demo % python3 test.py -n HOU   # 此时后面跟上了 -n 参数，并且赋值HOU
2. args = Namespace(name='HOU')  # 打印出来 name 的值为 HOU
3. houlei@houleideMacBook-Pro argparse_demo % python3 test.py --name hou  # 此时后面跟上了 --name 参数，并赋值为hou
4. args = Namespace(name='hou')  # 打印出来的 name 的值为 hou
5. houlei@houleideMacBook-Pro argparse_demo %

复制代码

　　解释说明
　　在上述代码  parser.add_argument("-n", "--name", default="Se7eN") 中，有两个参数 “-n”和“--name” 分别代表什么？其中-n 和 --name 都是我们自己自定的参数名。至于n和name ,你可以随便起个变量名都可以，但是要注意，前面的一个 “-”和“--”才是关键。
　　一个“-”的参数，例如：-n, 他其实相当于我们在liunx中使用的指令，一个自定义的指令。
　　两个“--”的参数，例如：--name 他就相当于在程序中，用来接收对对应指令值的变量，例如我们在控制台上输入 python3 test.py -n hou。 其中 -n 就代表使用的 -n 的指令，然后将后面的 hou 的值赋值给对应的变量， -n 对应的变量就是 --name 。所以我们使用print 打印的时候才显示的name = hou
　　简单理解：一个“-”的是指令，两个“--”的是接收指令内容的变量。
 
三、ArgumentParser参数

　　ArgumentParse是解析器对象，在创建一个解析器对象的时候，是有很多参数可以配置，下面就演示一下这些参数的使用
　　1、prog: 程序的名称（默认值：sys.argv[0]）

1. # 导入 argparse 模块
2. import argparse
4. # 创建一个argparse 的对象
5. parser = argparse.ArgumentParser()
7. # 添加一个接收参数，默认值为Se7eN
8. parser.add_argument("-n", "--name", default="Se7eN")
10. # 获取对应的参数的值
11. args = parser.parse_args()
13. # 控制台打印出来接收到的值
14. print("args = {}".format(args))

复制代码

　　执行代码：

 
 
 　　修改代码继续演示

1. # 导入 argparse 模块
2. import argparse
4. # 创建一个argparse 的对象
5. parser = argparse.ArgumentParser(prog="testname")    # 注意这里添加了prog=testname
7. # 添加一个接收参数，默认值为Se7eN
8. parser.add_argument("-n", "--name", default="Se7eN")
10. # 获取对应的参数的值
11. args = parser.parse_args()
13. # 控制台打印出来接收到的值
14. print("args = {}".format(args))

复制代码

 
 
 
 
　　2、usage: 用来描述该程序的用途，并且会覆盖原来的prog的显示

　　修改部分程序：

1. # 创建一个argparse 的对象
2. parser = argparse.ArgumentParser(prog="testname", usage="这是功能描述模块")

复制代码

　　展示结果

 
 
　　
　　3、description:帮助文档的描述和uasge功能类似，只是显示的位置不一样

　　继续修改部分代码：

1. # 创建一个argparse 的对象
2. parser = argparse.ArgumentParser(prog="testname", usage="这是功能描述模块", description="这是程序的介绍，和usage的功能模块描述类似")

复制代码

　　展示结果

 
 
 
　　4、epilog:帮助文档的额外说明，位置在最下面
　　继续修改部分代码：

1. # 创建一个argparse 的对象
2. parser = argparse.ArgumentParser(prog="testname", usage="这是功能描述模块", description="这是程序的介绍，和usage的功能模块描述类似", epilog="额外说明")

复制代码

　　展示结果：

 
 
 　　5、自定义指令的前缀：默认是"-" 和 "--"，这里如果你不喜欢使用，也可以自通过该参数自己指定前缀，个人觉得没必要。
　　代码演示：

1. # 导入 argparse 模块
2. import argparse
4. # 创建一个argparse 的对象 ，并通过prefix_chars 指定指令的前缀为 '+'
5. parser = argparse.ArgumentParser(prog="testname", usage="这是功能描述模块", description="这是程序的介绍，和usage的功能模块描述类似", epilog="额外说明", prefix_chars='+')
7. # 添加一个接收参数，默认值为Se7eN，这里的指令只能使用+ 表示，否则会报错
8. parser.add_argument("+n", "++name", default="Se7eN")
10. # 获取对应的参数的值
11. args = parser.parse_args()
13. # 控制台打印出来接收到的值
14. print("args = {}".format(args))

复制代码

　　执行结果

 
 
 
四、add_argument指令参数解释

　　　　1、action: 的作用比较多，有保存布尔类型，常量类型，数组类型的参数的功能

　　　　　　注意1：使用action = store_true/store_false 时修饰的指令是不能赋值的，其对应的指令的值是布尔类型的
　　　　　　注意2：使用action = store_const 时修饰的指令的是不能赋值，其对应的指令的值常量类型
　　　　　　注意3：使用action = append 是可以复制，其对应的值会将该指令对应的值放在一个数组中
 
　　　　　　1.1 先来演示：使用action，保存布尔类型的指令的值：store_true/store_false:保存布尔类型的变量：

1. # 导入 argparse 模块import argparse# 创建一个argparse 的对象
2. parser = argparse.ArgumentParser(prog="testname", usage="这是功能描述模块", description="这是程序的介绍，和usage的功能模块描述类似", epilog="额外说明")# 添加一个接收参数 -n，action = store_true 表示，[b]在使用的时候，如果填写了该指令，那么该指令对应的值就是true，如果没有使用该指令，则为空[/b]parser.add_argument("-n", "--name", action='store_true')# 获取对应的参数的值args = parser.parse_args()# 控制台打印出来接收到的值print("args = {}".format(args))

复制代码

　　执行结果：

 
 
 　　　　
　　　　　　1.2、使用action设置常量指令

　　　　修改代码演示：

1. # 添加一个接收参数 -n，action = store_const 表示，在使用的时候，如果填写了该指令，那么该指就等于10 如果没写就等于空
2. parser.add_argument("-n", "--name", action='store_const',const=10)

复制代码

　　　　执行结果：

 
 
 　　　　
　　　　　　1.3、使用action设置数组类型的指令

　　　　修改代码演示：

1. # 添加一个接收参数 -n，action = append， 会把该指令的值放在数组中
2. parser.add_argument("-n", "--name", action='append')

复制代码

　　　　执行结果

 
 
 
　　　　2、nargs参数：表示该指令接收值的个数：

　　　　　　示例1:

1. import argparse# 创建一个argparse 的对象
2. parser = argparse.ArgumentParser(prog="testname", usage="这是功能描述模块", description="这是程序的介绍，和usage的功能模块描述类似", epilog="额外说明")# 添加一个接收参数 -n, 并且该参数还必须要接收2个值，会放在一个数组中，其中nargs等于几，就表示要接受几个参数parser.add_argument("-n", "--name", nargs=2)# 获取对应的参数的值args = parser.parse_args()# 控制台打印出来接收到的值print("args = {}".format(args))

复制代码

　　　　运行结果：

 
 
 　　　　示例2：

1. # 导入 argparse 模块import argparse# 创建一个argparse 的对象
2. parser = argparse.ArgumentParser(prog="testname", usage="这是功能描述模块", description="这是程序的介绍，和usage的功能模块描述类似", epilog="额外说明")# 添加一个接收参数 -n,# nargs = "?" :  表示只接收1个参数，正则表达式的写法# nargs = "+" :  表示接收1一个或多个参数# nargs = "*" :  表示接收0个或者多个参数parser.add_argument("-n", "--name", nargs="*")# 获取对应的参数的值args = parser.parse_args()# 控制台打印出来接收到的值print("args = {}".format(args))

复制代码

　　　　打印结果就不演示了
 
　　　　3、required 该指令是必须的

1. # 导入 argparse 模块import argparse# 创建一个argparse 的对象
2. parser = argparse.ArgumentParser(prog="testname", usage="这是功能描述模块", description="这是程序的介绍，和usage的功能模块描述类似", epilog="额外说明")# 添加一个接收参数 -n,# nargs = "?" :  表示只接收1个参数，正则表达式的写法# nargs = "+" :  表示接收1一个或多个参数# nargs = "*" :  表示接收0个或者多个参数parser.add_argument("-n", "--name", nargs="*", required=True)# 获取对应的参数的值args = parser.parse_args()# 控制台打印出来接收到的值print("args = {}".format(args))

复制代码

　　　　演示结果：

 
 
 　　　　
　　　　4、choices:如有choices选项，则该指令的值只能是choices中的一个
　　　　代码演示

1. # 导入 argparse 模块import argparse# 创建一个argparse 的对象
2. parser = argparse.ArgumentParser(prog="testname", usage="这是功能描述模块", description="这是程序的介绍，和usage的功能模块描述类似", epilog="额外说明")# 添加一个接收参数 -n,# nargs = "?" :  表示只接收1个参数，正则表达式的写法# nargs = "+" :  表示接收1一个或多个参数# nargs = "*" :  表示接收0个或者多个参数parser.add_argument("-n", "--name", nargs="*", required=True, choices=['zhangsan', 'lisi'])# 获取对应的参数的值args = parser.parse_args()# 控制台打印出来接收到的值print("args = {}".format(args))

复制代码

　　　　运行结果：

 
 
五、vars()

　　vars()方法可以将parser对象变成字典，方便使用
　　代码演示

1. # 导入 argparse 模块import argparse# 创建一个argparse 的对象
2. parser = argparse.ArgumentParser(prog="testname", usage="这是功能描述模块", description="这是程序的介绍，和usage的功能模块描述类似", epilog="额外说明")# 添加一个接收参数 -n,# nargs = "?" :  表示只接收1个参数，正则表达式的写法# nargs = "+" :  表示接收1一个或多个参数# nargs = "*" :  表示接收0个或者多个参数parser.add_argument("-n", "--name", nargs="*", required=True, choices=['zhangsan', 'lisi'])# 获取对应的参数的值args = parser.parse_args()# 控制台打印出来接收到的值print("args = {}".format(args))# 将parser 变成字典对象print('arg_vars = {}'.format(vars(args)))

复制代码

　　输出结果：

 
 
　　　　
 
 
 
 
　　　　
 

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！