python命令行解析模块optionparser

原文链接：http://www.cnblogs.com/itech/archive/2010/12/31/1919017.html
使用optionparser模块来解析

optionparser的执行过程：

导入optionparser ： from optparse import OptionParser
构造optionparser的对象：parser = OptionParser()
往optionparser对象中增加option ：parser.add_option()

调用optionparser的解析函数：(options, args) = parser.parse_args()
在options中使用解析到的options，在args中使用其他的args。

 

1）简单实例

def  TestOpionparser():
   from  optparse  import  OptionParser
  parser  =  OptionParser()
  parser.add_option( " -f " ,  " --file " , dest = " filename " ,
                  help = " write report to FILE " , metavar = " FILE " )
  parser.add_option( " -q " ,  " --quiet " ,
                  action = " store_false " , dest = " verbose " , default = True,
                  help = " don't print status messages to stdout " )
  (options, args)  =  parser.parse_args()
   print  (options.filename)
   print  (options.verbose)
   print  (args)

 

运行：%prog -f files.txt -q arg1 arg2

运行结果：

files.txt
False
['arg1', 'arg2']

 

2）更多更灵活的参数传入方式：

<yourscript> --file=outfile -q

<yourscript> -f outfile --quiet
<yourscript> --quiet --file outfile
<yourscript> -q -foutfile
<yourscript> -qfoutfile

 

3）帮助被自动的生成，只需要-h来显示

显示帮助：%prog -h

例如1）程序的帮助结果：

Usage: parsecommandline.py [options]

Options:
  -h, --help            show this help message and exit
  -f FILE, --file=FILE  write report to FILE
  -q, --quiet           don't print status messages to stdout

 

如果你需要显示自定义的，可以在定义optionparser时候传入，例如：

usage = "usage: %prog [options] arg1 arg2"
parser = OptionParser(usage=usage)

 

同时还可以增加程序的版本信息，简单地：

parser = OptionParser(usage="%prog [-f] [-q]", version="%prog 1.0")
调用：%prog --version

 

4）add_option()中参数的意义：

short option string: 为第一个参数，表示option的缩写，例如-f;

long option string: 为第二个参数，表示option的全拼，例如--file;

后面的参数皆为命名参数，命名参数为可选参数;

action=: 表示对此option的处理方式，默认值为store，表示存储option的值到解析后的options对象的成员中。action还可以有其他的值：对于bool值，使用store_true来默认存储true，使用store_false来默认存储false，store_const用来存储const设置的值到此option，append表示增加option的参数到list中，此时此option是一个list，可能包含多个值，count表示对counter增加一，callback表示调用指定的函数。所有的action值如下：

store + store_true + store_false + store_const + append + count + callback

type=:表示此option的值的类型，默认为string，可以指定为string, int, choice, float and complex；

dest=：表示此option在经过optionparser解析后的options对象中成员的名字，默认使用long option string；

default=:表示比option的默认值；

metavar=:表示显示到help中option的默认值；

const=:当action为store_const的时候，需要设置此值；

choices=:当设置type为choices时，需要设置此值；

 

5）如果options很多的时候，可以进行分组，使用如下：

group = OptionGroup(parser)

group.add_option()
parser.add_option_group(group)

 

6）通常的使用如下，其中包含了parser.error()来抛出与optionparser较一致的异常和错误信息。

from  optparse  import  OptionParser
[...]
def  main():
    usage  =   " usage: %prog [options] arg "
    parser  =  OptionParser(usage)
    parser.add_option( " -f " ,  " --file " , dest = " filename " ,
                      help = " read data from FILENAME " )
    parser.add_option( " -v " ,  " --verbose " ,
                      action = " store_true " , dest = " verbose " )
    parser.add_option( " -q " ,  " --quiet " ,
                      action = " store_false " , dest = " verbose " )
    [...]
    (options, args)  =  parser.parse_args()
     if  len(args)  !=   1 :
        parser.error( " incorrect number of arguments " )
     if  options.verbose:
         print ( " reading %s... "   %  options.filename)
    [...]

if   __name__   ==   " __main__ " :
    main()

 

 

 

完！

 

参考:

http://bbs.linuxtone.org/thread-4797-1-1.html

http://apps.hi.baidu.com/share/detail/6463885