美文网首页程序员
Python:argparse、docopt 命令行参数解析模块

Python:argparse、docopt 命令行参数解析模块

作者: 一名普通用户 | 来源:发表于2017-09-03 12:24 被阅读0次

一、argparse

import argparse
parser = argparse.ArgumentParser()
parser.parse_args()

自带--help 参数,未定义的参数会有相应的提示

$ python3 test.py 
$ python3 test.py --help
usage: test.py [-h]

optional arguments:
  -h, --help  show this help message and exit
$ python3 test.py --arg1
usage: test.py [-h]
test.py: error: unrecognized arguments: --arg1

想添加参数可以这么写

import argparse
parser = argparse.ArgumentParser()
parser.add_argument("arg1")
args = parser.parse_args()
print(args.arg1) #必须跟定义的参数一致

还有其他的添加方法:

  • parser.add_argument("--arg1","-a") 定义长参数和短参数。

带短横线和不带短横线的参数区别(个人理解)

  1. 带短横线的参数数值紧跟在后,不带的本身内容就是参数值。
  2. 带短横线的参数是可选参数,不带的是必须参数
  • parser.add_argument("arg1",help="help content") 自带帮助内容
  • parser.add_argument("arg1",help="help content",type=int) 定义参数的类型
  • parser.add_argument("arg1",help="help content",type=int,default=100) 定义参数的默认值
  • parser.add_argument('--show','-s',help='content',action="store_true", default=False) 定义布尔值类型参数

最后一个可以简单的理解为如果命令行参数有--show,则 args.show 为真,没有则为假

最后取出参数数值都是用args.[argument_name]得到,记得最初定义的类型。

二、docopt

这是最近才知道的一个用法。docopt可以用写文档的方式完成参数定义,真正是doc + opt 啊。

这是 docopt/naval_fate.py at master · docopt/docopt · GitHub 里的一个例子

"""Naval Fate.
Usage:
  naval_fate.py ship new <name>...
  naval_fate.py ship <name> move <x> <y> [--speed=<kn>]
  naval_fate.py ship shoot <x> <y>
  naval_fate.py mine (set|remove) <x> <y> [--moored|--drifting]
  naval_fate.py -h | --help
  naval_fate.py --version
Options:
  -h --help     Show this screen.
  --version     Show version.
  --speed=<kn>  Speed in knots [default: 10].
  --moored      Moored (anchored) mine.
  --drifting    Drifting mine.
"""
from docopt import docopt


if __name__ == '__main__':
    arguments = docopt(__doc__, version='Naval Fate 2.0')
    print(arguments)

__doc__ 的内容根据需要从Usage Arguments Options Examples 里选择(区分大小写)。

大写或者由尖括号括起来的是参数
带一个或者两个短横线是选项,-a -b -c 可以写成 -abc
方括号里的是必选元素,圆括号里的是可选元素,|分隔开互斥元素(多个里选一个),...代表一个或者多个元素。

这一部分里的选项另起一行,以短横线开始。
用两个空格分隔开选项和描述。
想添加默认值,则在描述结束后添加 [default: <my-default-value>]

默认值是否会被拆分,请看下面的例子。

Usage: my_program.py [--repeatable=<arg> --repeatable=<arg>]
                     [--another-repeatable=<arg>]...
                     [--not-repeatable=<arg>]

# will be ['./here', './there']
--repeatable=<arg>          [default: ./here ./there]

# will be ['./here']
--another-repeatable=<arg>  [default: ./here]

# will be './here ./there', because it is not repeatable
--not-repeatable=<arg>      [default: ./here ./there]
  • Arguments

解释参数内容

  • Examples

直接填写样例


如果用样例,输入naval_fate.py ship Guardian move 100 150 --speed=15

结果将会是

{'--drifting': False,    'mine': False,
 '--help': False,        'move': True,
 '--moored': False,      'new': False,
 '--speed': '15',        'remove': False,
 '--version': False,     'set': False,
 '<name>': ['Guardian'], 'ship': True,
 '<x>': '100',           'shoot': False,
 '<y>': '150'}

来自个人 Python 文集

相关文章

  • argparse

    argparse import argparse命令行参数解析模块简单示例 选择性添加参数 python test...

  • Python | argparse

    参考:博客园 | Python解析命令行读取参数 -- argparse模块[https://www.cnblog...

  • Python:argparse、docopt 命令行参数解析模块

    一、argparse 自带--help 参数,未定义的参数会有相应的提示 想添加参数可以这么写 还有其他的添加方法...

  • Python学习笔记:argparse的使用

    argparse是什么? argparse是一个命令行参数解析模块,可以解析从命令行输入的内容。 argparse...

  • argparse模块

    argparse是python用于解析命令行参数和选项的标准模块,用于代替已经过时的optparse模块 使用步骤...

  • Python--argparse 模块

    一、简介 argparse是python用于解析命令行参数和选项的标准模块,用于代替已经过时的optparse模块...

  • python模块之Argparse

    背景 Argparse 顾名思义参数解析器,是命令行运行 python 文件时解析参数的模块,多用在需要多次修改...

  • python argparse模块

    argparse是一个python中的命令行解析模块 parser = argparse.ArgumentPars...

  • python模块学习

    一、argparse python用于解析命令行参数和选项的标准模块,后面可以跟着不同的参数选项以实现不同功能 使...

  • 工具 | Python 篇 - argparse 命令行参数解析

    主题:Python 命令行参数解析。argparse 模块可以让人轻松编写用户友好的命令行接口。程序定义它需要的参...

网友评论

    本文标题:Python:argparse、docopt 命令行参数解析模块

    本文链接:https://www.haomeiwen.com/subject/krkdjxtx.html