在使用 python argparser 定义命令行参数时,我们可能会遇到需要为某些参数提供额外的可选值的情况。比如,我们现在有一个命令行程序,使用 argparse
定义了两个参数 -a
和 -b
。我们希望 -a
参数只能取 x
、y
和 z
三个值之一,而当 -a
的值为 x
时,还必须提供一个额外的必填参数 -b
。
parser = argparse.ArgumentParser(description='someDesc')
parser.add_argument('-a', required=True, choices=['x', 'y', 'z'])
parser.add_argument('-b', required=False)
args = parser.parse_args()
if args.a == 'x' and args.b is None:
parser.error('error: argument -b is required when -a is x')
2、解决方案
我们可以通过以下方法来实现这样的功能:
方法一:使用 add_subparsers()
方法
ArgumentParser
类提供了 add_subparsers()
方法,可以用来创建子命令。子命令可以看作是主命令下的一个子命令,它可以有自己的参数。在本例中,我们可以创建一个子命令 x
,当 -a
的值为 x
时,就会使用子命令 x
来解析参数。
parser = argparse.ArgumentParser(description='someDesc')
subparsers = parser.add_subparsers(dest='a')
parser_x = subparsers.add_parser('x')
parser_x.add_argument('-b', required=True)
parser_y = subparsers.add_parser('y')
parser_z = subparsers.add_parser('z')
args = parser.parse_args()
if args.a == 'x':
subparser_x.parse_args(args.__dict__)
elif args.a == 'y':
subparser_y.parse_args(args.__dict__)
elif args.a == 'z':
subparser_z.parse_args(args.__dict__)
这种方法的好处是,我们可以将不同的参数分组到不同的子命令下,使得命令行程序更加结构化和易于理解。
方法二:使用 parse_known_args()
方法
ArgumentParser
类还提供了 parse_known_args()
方法。这个方法可以解析已知的参数,并返回两个值:一个 Namespace
对象和一个列表。Namespace
对象包含了解析后的参数值,而列表则包含了未解析的参数。
parser = argparse.ArgumentParser(description='someDesc')
parser.add_argument('-a', required=True, choices=['x', 'y', 'z'])
parser.add_argument('-b', required=False)
args, unknown_args = parser.parse_known_args()
if args.a == 'x' and '-b' not in unknown_args:
parser.error('error: argument -b is required when -a is x')
这种方法的好处是,它可以让我们在解析参数时进行更多的自定义操作。比如,我们可以根据参数值来决定是否需要解析额外的参数。
方法三:使用自定义的错误处理
如果上述方法都不适合你的需求,你也可以使用自定义的错误处理来实现这样的功能。你可以编写自己的函数来解析参数,并在函数中进行错误检查。比如,你可以编写一个函数来解析 -a
参数,如果 -a
的值为 x
,则检查是否提供了 -b
参数。
def parse_args():
parser = argparse.ArgumentParser(description='someDesc')
parser.add_argument('-a', required=True, choices=['x', 'y', 'z'])
parser.add_argument('-b', required=False)
args = parser.parse_args()
if args.a == 'x' and args.b is None:
raise ValueError('error: argument -b is required when -a is x')
return args
args = parse_args()
这种方法的好处是,它可以让我们完全控制参数的解析过程,并且可以编写自己的错误处理逻辑。