Python 中使用 argparse 解析命令行参数

使用 argparse 模块为应用程序设置命令行选项。

使用 argparse 模块为应用程序设置命令行选项。

Python 中使用 argparse 解析命令行参数

有一些第三方库用于命令行解析,但标准库 argparse 与之相比也毫不逊色。

无需添加很多依赖,你就可以编写带有实用参数解析功能的漂亮命令行工具。

Python 中的参数解析

使用 argparse 解析命令行参数时,第一步是配置一个 ArgumentParser 对象。这通常在全局模块内完成,因为单单_配置_一个解析器没有副作用。

“`
import argparse

PARSER = argparse.ArgumentParser()

“`

ArgumentParser 中最重要的方法是 .add_argument(),它有几个变体。默认情况下,它会添加一个参数,并期望一个值。

“`
PARSER.add_argument(“–value”)

“`

查看实际效果,调用 .parse_args()

“`
PARSER.parse_args([“–value”, “some-value”])

“`

“`
Namespace(value=’some-value’)

“`

也可以使用 = 语法:

“`
PARSER.parse_args([“–value=some-value”])

“`

“`
Namespace(value=’some-value’)

“`

为了缩短在命令行输入的命令,你还可以为选项指定一个短“别名”:

“`
PARSER.add_argument(“–thing”, “-t”)

“`

可以传入短选项:

“`
PARSER.parse_args(“-t some-thing”.split())

“`

“`
Namespace(value=None, thing=’some-thing’)

“`

或者长选项:

“`
PARSER.parse_args(“–thing some-thing”.split())

“`

“`
Namespace(value=None, thing=’some-thing’)

“`

类型

有很多类型的参数可供你使用。除了默认类型,最流行的两个是布尔类型和计数器。布尔类型有一个默认为 True 的变体和一个默认为 False 的变体。

“`
PARSER.addargument(“–active”, action=”storetrue”)
PARSER.addargument(“–no-dry-run”, action=”storefalse”, dest=”dryrun”)
PARSER.add
argument(“–verbose”, “-v”, action=”count”)

“`

除非显式传入 --active,否则 active 就是 Falsedry-run 默认是 True,除非传入 --no-dry-run。无值的短选项可以并列。

传递所有参数会导致非默认状态:

“`
PARSER.parse_args(“–active –no-dry-run -vvvv”.split())

“`

“`
Namespace(value=None, thing=None, active=True, dry_run=False, verbose=4)

“`

默认值则比较单一:

“`
PARSER.parse_args(“”.split())

“`

“`
Namespace(value=None, thing=None, active=False, dry_run=True, verbose=None)

“`

子命令

经典的 Unix 命令秉承了“一次只做一件事,并做到极致”,但现代的趋势把“几个密切相关的操作”放在一起。

gitpodmankubectl 充分说明了这种范式的流行。argparse 库也可以做到:

“`
MULTIPARSER = argparse.ArgumentParser()
subparsers = MULTI
PARSER.addsubparsers()
get = subparsers.add
parser(“get”)
get.addargument(“–name”)
get.set
defaults(command=”get”)
search = subparsers.addparser(“search”)
search.add
argument(“–query”)
search.set_defaults(command=”search”)

“`

“`
MULTIPARSER.parseargs(“get –name awesome-name”.split())

“`

“`
Namespace(name=’awesome-name’, command=’get’)

“`

“`
MULTIPARSER.parseargs(“search –query name~awesome”.split())

“`


Namespace(query='name~awesome', command='search')

“`

程序架构

使用 argparse 的一种方法是使用下面的结构:

“`

my_package/main.py

import argparse
import sys

from my_package import toplevel

parsedarguments = toplevel.PARSER.parseargs(sys.argv[1:])
toplevel.main(parsed_arguments)

“`

“`

my_package/toplevel.py

PARSER = argparse.ArgumentParser()

.add_argument, etc.

def main(parsed_args):

...

# do stuff with parsed_args

“`

在这种情况下,使用 python -m my_package 运行。或者,你可以在包安装时使用 console_scprits 入口点。

总结

argparse 模块是一个强大的命令行参数解析器,还有很多功能没能在这里介绍。它能实现你想象的一切。


via: https://opensource.com/article/21/8/python-argparse

作者:Moshe Zadka 选题:lujun9972 译者:MjSeven 校对:wxy

本文由 LCTT 原创编译,Linux中国 荣誉推出

主题测试文章,只做测试使用。发布者:eason,转转请注明出处:https://aicodev.cn/2021/11/15/python-%e4%b8%ad%e4%bd%bf%e7%94%a8-argparse-%e8%a7%a3%e6%9e%90%e5%91%bd%e4%bb%a4%e8%a1%8c%e5%8f%82%e6%95%b0/

(0)
eason的头像eason
上一篇 2021年11月14日
下一篇 2021年11月16日

相关推荐

发表回复

您的电子邮箱地址不会被公开。 必填项已用 * 标注

联系我们

400-800-8888

在线咨询: QQ交谈

邮件:admin@example.com

工作时间:周一至周五,9:30-18:30,节假日休息

关注微信