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