# -*- coding: utf-8 -*- 
import argparse 
args = "-f hello.txt -n 1 2 3 -x 100 -y b -z a -q hello @args.txt i_am_bar -h".split()  
# 使用@args.txt要求fromfile_prefix_chars="@" 
# args.txt文件中應(yīng)該一行一個(gè)參數(shù)，想改變行為參考convert_arg_line_to_args()
# ArgumentParser參數(shù)的簡(jiǎn)單說(shuō)明 
## description - 命令行幫助的開始文字，大部分情況下，我們只會(huì)用到這個(gè)參數(shù) 
# epilog - 命令行幫助的結(jié)尾文字 
# prog - (default: sys.argv[0])程序的名字，一般不需要修改，另外，如果你需要在help中使用到程序的名字，可以使用%(prog)s 
# prefix_chars - 命令的前綴，默認(rèn)是-，例如-f/--file。有些程序可能希望支持/f這樣的選項(xiàng)，可以使用prefix_chars="/" 
# fromfile_prefix_chars - (default: None)如果你希望命令行參數(shù)可以從文件中讀取，就可能用到。例如，如果fromfile_prefix_chars='@',命令行參數(shù)中有一個(gè)為"@args.txt"，args.txt的內(nèi)容會(huì)作為命令行參數(shù) 
# add_help - 是否增加-h/-help選項(xiàng) (default: True)，一般help信息都是必須的，所以不用設(shè)置啦。 
## parents - 類型是list，如果這個(gè)parser的一些選項(xiàng)跟其他某些parser的選項(xiàng)一樣，可以用parents來(lái)實(shí)現(xiàn)繼承，例如parents=[parent_parser] 
## formatter_class - 自定義幫助信息的格式（description和epilog）。默認(rèn)情況下會(huì)將長(zhǎng)的幫助信息進(jìn)行<自動(dòng)換行和消除多個(gè)連續(xù)空白>。 
#三個(gè)允許的值： 
# class argparse.RawDescriptionHelpFormatter 直接輸出description和epilog的原始形式（不進(jìn)行自動(dòng)換行和消除空白的操作） 
# class argparse.RawTextHelpFormatter 直接輸出description和epilog以及add_argument中的help字符串的原始形式（不進(jìn)行自動(dòng)換行和消除空白的操作） 
## class argparse.ArgumentDefaultsHelpFormatter 在每個(gè)選項(xiàng)的幫助信息后面輸出他們對(duì)應(yīng)的缺省值，如果有設(shè)置的話。這個(gè)最常用吧！ 
# argument_default - (default: None)設(shè)置一個(gè)全局的選項(xiàng)的缺省值，一般每個(gè)選項(xiàng)單獨(dú)設(shè)置，所以這個(gè)參數(shù)用得少，不細(xì)說(shuō) 
# usage - (default: generated)如果你需要修改usage的信息（usage: PROG [-h] [--foo [FOO]] bar [bar ...]），那么可以修改這個(gè)，一般不要修改。 
# conflict_handler - 不建議使用。這個(gè)在極端情況下才會(huì)用到，主要是定義兩個(gè)add_argument中添加的選項(xiàng)的名字發(fā)生沖突時(shí)怎么處理，默認(rèn)處理是拋出異常。 
#注釋一行有##表示這幾個(gè)參數(shù)比較常用 
parser = argparse.ArgumentParser(description="This is a description of %(prog)s", epilog="This is a epilog of %(prog)s", prefix_chars="-+", fromfile_prefix_chars="@", formatter_class=argparse.ArgumentDefaultsHelpFormatter) 
# ArgumentParser.add_argument(name or flags...[, action][, nargs][, const][, default][, type][, choices][, required][, help][, metavar][, dest]) 
# add_argument的參數(shù)是比較復(fù)雜的。。。 
# name or flags - 指定參數(shù)的形式，想寫幾個(gè)寫幾個(gè)，不過(guò)我們一般就寫兩個(gè)，一個(gè)短參數(shù)，一個(gè)長(zhǎng)參數(shù)，看下面的例子"-f", "--file" 
# 可選的選項(xiàng)，位置不固定，想怎么寫就怎么寫，默認(rèn)是可選的 
parser.add_argument("-f", "--file", help="test test test") 
# 位置固定的選項(xiàng)，例如"prog i_am_bar"，這樣子的話，i_am_bar就是bar選項(xiàng)的值啦，默認(rèn)是必須有的 
parser.add_argument("bar", help="test test test") 
# nargs - 指定這個(gè)參數(shù)后面的value有多少個(gè)，例如，我們希望使用-n 1 2 3 4，來(lái)設(shè)置n的值為[1, 2, 3, 4] 
parser.add_argument("-n", "--num", nargs="+", type=int) 
# 這里nargs="+"表示，如果你指定了-n選項(xiàng)，那么-n后面至少要跟一個(gè)參數(shù)，+表示至少一個(gè),?表示一個(gè)或0個(gè),*0個(gè)或多個(gè)， 
# default - 如果命令行沒有出現(xiàn)這個(gè)選項(xiàng)，那么使用default指定的默認(rèn)值 
parser.add_argument("+g", "++gold", help="test test test", default="test_gold")#需要prefix_chars包含"+" 
# type - 如果希望傳進(jìn)來(lái)的參數(shù)是指定的類型（例如 float, int or file等可以從字符串轉(zhuǎn)化過(guò)來(lái)的類型），可以使用 
parser.add_argument("-x", type=int) 
# choices - 設(shè)置參數(shù)值的范圍，如果choices中的類型不是字符串，記得指定type哦 
parser.add_argument("-y", choices=['a', 'b', 'd']) 
# required - 通常-f這樣的選項(xiàng)是可選的，但是如果required=True那么就是必須的了 
parser.add_argument("-z", choices=['a', 'b', 'd'], required=True) 
# metavar - 參數(shù)的名字，在顯示 幫助信息時(shí)才用到. 
parser.add_argument("-o", metavar="OOOOOO") 
# help - 設(shè)置這個(gè)選項(xiàng)的幫助信息 
# dest - 設(shè)置這個(gè)選項(xiàng)的值就是解析出來(lái)后放到哪個(gè)屬性中 
parser.add_argument("-q", dest="world")  
args = parser.parse_args(args) # 如果你沒有args參數(shù)，那么就使用sys.argv，也就是命令行參數(shù)啦。有這個(gè)參數(shù)，就方便我們調(diào)試啊 
# args.world就是-q的值啦 
# action - The basic type of action to be taken when this argument is encountered at the command line. 
# const - A constant value required by some action and nargs selections.
# 這兩個(gè)自己看幫助文檔啦，比較復(fù)雜 
# http://docs.python.org/library/argparse.html 
print args