python argparse命令行参数解析

argparse是python用于解析命令行参数和选项的标准模块。
很多时候，需要用到解析命令行参数的程序，目的是在终端窗口输入训练的参数和选项。
argparse 模块可以让人轻松编写用户友好的命令行接口。
程序定义它需要的参数，然后 argparse 将弄清如何从 sys.argv 解析出那些参数。 argparse 模块还会自动生成帮助和使用手册，并在用户给程序传入无效参数时报出错误信息。

test.py

# -*- coding: utf-8 -*-
import argparse

# (1) 声明一个parser对象，该对象包含将命令行解析成 Python 数据类型所需的全部信息。
ap = argparse.ArgumentParser(description='Process some integers.')

# (2) 添加参数
ap.add_argument("first")  # 位置参数，这里表示第一个出现的参数赋值给first
ap.add_argument("--digit", required=True, type=int, default=10, help="输入数字")  # 声明一个int类型参数
ap.add_argument("--name", type=str, default=None, help="名字")  # 同上，default 表示默认值

# (3) 读取命令行参数
args = ap.parse_args()

# (4) 调用这些参数
print(args.first)
print(args.digit)
print("name = {}".format(args.name))

调用

python test.py position_arg --name qwe

ArgumentParser对象
（1）prog - 程序的名称(默认: sys.argv[0])
（2）usage - 描述程序用途的字符串(默认值：从添加到解析器的参数生成)
（3）description - 在参数帮助文档之后显示的文本 (默认值:无)
（4）epilog - 在参数帮助文档之后显示的文本（默认值：无）
（5）parents - 一个 ap对象的列表，它们的参数也应包含在内
（6）formatter_class - 用于自定义帮助文档输出格式的类
（7）prefix_chars - 可选参数的前缀字符集合（默认值：’-’）
（8）fromfile_prefix_chars - 当需要从文件中读取其他参数时，用于标识文件名的前缀字符集合（默认值：None）
（8）argument_default - 参数的全局默认值（默认值： None）
（9）conflict_handler - 解决冲突选项的策略（通常是不必要的）
（10）add_help - 为解析器添加一个 -h/–help 选项（默认值： True）
（11）allow_abbrev - 如果缩写是无歧义的，则允许缩写长选项 （默认值：True）

add_argument()方法
（1）name or flags - 一个命名或者一个选项字符串的列表。（例如 foo 或 -f, --foo）
（2）action - 表示该选项要执行的操作
（3）default - 默认值
（4）dest - 用来指定参数的位置，被添加到 parse_args() 所返回对象上的属性名。
（5）type - 为参数类型。（例如int）
（6）choices - 用来选择输入参数的范围。（例如choice = [1, 5, 10]）
（7）help - 用来描述这个选项的作用
（8）nargs - 命令行参数应当消耗的数目。
（9）const - 被一些 action 和 nargs 选择所需求的常数。
（10）required - 此命令行选项是否可省略 （仅选项可用）。
（11）metavar - 在使用方法消息中使用的参数值示例。

import argparse
import logging

"""
" File Description:
" dump model && deploy
"
" Created by zz on 2021/6/22.
" Mail: zz@baidu.com
"""
logging.basicConfig(level=logging.DEBUG)


def parse_args():
	ap = argparse.ArgumentParser(prog="deploy tool", description='dump or calib model && deploy')
	ap.add_argument("deploy_path", type=str, help="deploy base path")
	ap.add_argument("exp_name", type=str, help="train exp name")
	subparser = ap.add_subparsers(title="model deploy subparser", dest="mode")

	# subparser
	model_deploy_parser = subparser.add_parser("model", help="model deploy")
	model_deploy_parser.add_argument("--default", default=False, type=bool, help="whether that's default model")

	calib_deploy_parser = subparser.add_parser("calib", help="offline calib deploy")
	calib_deploy_parser.add_argument("--input", required=True, type=str, help="model offline calib file")

	args = ap.parse_args()
	return args

# global args
args = parse_args()
mode = args.mode
deploy_path = args.deploy_path
exp_name = args.exp_name

def main():
	if mode == "model":
		_deploy_model()
	elif mode == "calib":
		_deploy_calib()
	else:
		logging.error( "Mode error")


if __name__ == '__main__':
	main()