0062-【Python系统】-argparse标准库命令行参数解析包

版权声明:本文为博主原创文章,未经博主允许不得转载。 https://blog.csdn.net/leadingsci/article/details/82802442

官方英文版:

https://docs.python.org/3.6/library/argparse.html

中文翻译版:

https://pythoncaff.com/docs/pymotw/argparse-command-line-option-and-argument-parsing/166

简书

文章:

python argparse用法总结
https://www.jianshu.com/p/fef2d215b91d


ArgumentParser类

class argparse.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:程序的名字
usage:默认情况下,ArgumentParser依据它包含的参数计算出帮助信息
description:这个参数给出程序做什么以及如何工作的简短描述
epilog:显示额外的关于程序的描述
parents:有时候,几个解析器会共享一个共同的参数集。可以使用一个带有所有共享参数的解析器传递给ArgumentParser的parents=参数,而不用重复定义这些参数
formatter_class:ArgumentParser对象允许通过指定一个格式化类来定制帮助信息的格式(argparse.RawDescriptionHelpFormatter、argparse.RawTextHelpFormatter、argparse.ArgumentDefaultsHelpFormatter、argparse.MetavarTypeHelpFormatter)
prefix_chars:修改前缀符
fromfile_prefix_chars:以任意一个给定字符开始的参数将被当做文件,并且将被这些文件包含的参数替换
argument_default:指定一个解析器范围的参数默认值
allow_abbrev:允许使用缩写(默认)
conflict_handler:关于设置同一个选项具有两个动作
add_help  :设置是否开启帮助文档

ArgumentParser对象add_argument()方法

ArgumentParser.add_argument(name or flags…[, action][, nargs][, const][, default][, type][, choices][, required][, help][, metavar][, dest])

name or flags:传递给add_argument() 的第一个参数因此必须是一个标记序列或者一个简单的参数名字
action:指出应该如何处理命令行参数(支持的操作:’store’ ,’store_const’,’store_true’,’store_false’,’append’,’append_const’,’count’,’help’,’version’)
nargs:将一个动作与不同数目的命令行参数关联在一起(支持的值:N,’?’,’*’,’+’)
const:用于保存常量值,它们不是从命令行读入但是是ArgumentParser 的动作所要求的
default:其默认值为None,指出如果命令行参数没有出现时它们应该是什么值
type:允许任意必要的类型检查并作类型转换
choices:某些命令行参数应该从一个受限的集合中选择
required:如果要使得选项是必需的,可以指定True作为required=关键字参数的值给add_argument()
help:包含参数简短描述的字符串
metavar:默认情况下,对于位置参数直接使用dest的值,对于可选参数则将dest的值变为大写。注意metavar只会改变显示出来的名字parse_args() 对象中属性的名字仍然由dest的值决定。
dest:对于位置参数的动作,dest 通常作为第一个参数提供给add_argument(),对于可选参数的动作,dest的动作通常从选项字符串推导出来,如:ArgumentParser生成的dest的值是将第一个长的选项字符串前面的–字符串去掉。如果没有提供长选项字符串,dest的获得则是将第一个短选项字符串前面的-字符去掉。任何内部的-将被转换为字符以确保字符串是合法的属性名字。(即对于可选参数,先找长的选项字符串,再找短选项字符串,并且内部的-会被转换为字符。)

Action类

`class argparse.Action(option_strings, dest, nargs=None, const=None, default=None, type=None, choices=None, required=False, help=None, metavar=None)``


ArgumentParser对象parse_args()方法

将参数字符串转换成对象并设置成命名空间的属性。返回构成的命名空间。
之前对add_argument() 的调用完全决定了创建什么对象以及如何设置。

选项值语法,parse_args()方法支持几种指定一个选项的值的方法:

最简单的方法是,将选项和它的值以两个分开的参数传递
对于长选项(名字长度超过一个字符的选项),选项和它的值还可以用一个单一的命令行参数传递,并用=分隔它们
对于短选项(长度只有一个字符的选项),选项及其值可以连在一起
几个短选项可以连在一起仅使用一个-前缀,只要只有最后一个选项要求有值或者都不要有值
无效参数
在解析命令行的同时,parse_args()会检查各种错误,包括有歧义的选项、不合法的类型、不合法的选项、错误的位置参数个数等等。当它遇到此类错误时,会退出并跟随用法信息一起打印出错误。

参数包含“ - ”
parse_args()方法每当用户犯了明确的错误时会努力给出错误信息,但是有些情况天生就有歧义。例如,命令行参数-1既可以是想指明一个选项也可以是想提供一个位置参数。这里parse_args()会非常小心:位置参数只有在它们看上去像负数且解析器中没有选项看上去是负数时才可以以-开始。
如果你有必须以- 开始的位置参数且不是负数,你可以插入伪参数’–’告诉parse_args()其后的所有内容都为位置参数。

参数缩写(前缀匹配)

参数不来自sys.argv
有时候可能需要ArgumentParser解析的参数不是来自sys.argv。这可以通过传递一个字符串列表给parse_args()来完成


4.class argparse.Namespace

parse_args() 默认使用的简单的类,用于创建一个保存属性的对象并返回该对象。
有时可能需要让ArgumentParser分配属性给一个已经存在的对象而不是一个新的Namespace对象。这可以通过指定namespace=关键字参数达到。

其它实用工具
ArgumentParser.add_subparsers([title][, description][, prog][, parser_class][, action][, option_string][, dest][, help][, metavar]) class argparse.FileType(mode=’r’, bufsize=-1, encoding=None, errors=None) ArgumentParser.add_argument_group(title=None, description=None) ArgumentParser.add_mutually_exclusive_group(required=False)ArgumentParser.set_defaults(**kwargs)

ArgumentParser.print_usage(file=None)
ArgumentParser.print_help(file=None)
ArgumentParser.format_usage()
ArgumentParser.format_help()
ArgumentParser.parse_known_args(args=None, namespace=None) 
ArgumentParser.convert_arg_line_to_args(arg_line) 
ArgumentParser.exit(status=0, message=None) 
ArgumentParser.error(message)`

参数名解析

dest

默认的动作是存储参数值。如果指定了参数类型,参数值会在被储存前转换。如果提供了 dest 参数,命令行参数被解析时参数值会以 dest 参数提供的变量名存储。

猜你喜欢

转载自blog.csdn.net/leadingsci/article/details/82802442