Python命令行解析模塊詳解
本文研究的主要是Python命令行解析模塊的相關內容,具體如下。
Python命令行常見的解析器有兩種,一是getopt模塊,二是argparse模塊。下面就解讀下這兩種解析器。
getopt模塊
這個模塊可以幫助腳本解析命令行參數(shù),一般是sys.argv[1:]。它遵循著Unix的getopt()函數(shù)相同的約定(用-/--指定命令參數(shù))。這個模塊提供兩個函數(shù)(getopt.getopt()/getopt.gnu_getopt())和一個參數(shù)異常(getopt.GetoptError)。
這里重點介紹getopt.getopt()這個函數(shù)。
函數(shù)原型:getopt.getopt(args, options[, long_options])
這個函數(shù)有三個參數(shù):
- args:腳本要解析的命令行參數(shù);
- options:命令行短選項,如果指定的短選項后面需要跟參數(shù)的話,要在相應短選項后面加“:”,如e:;
- long_options:命令行長選項,這個參數(shù)是可選的。如果指定的長選項后面要跟參數(shù)的話,要在相應長選項后面加上“=”,如conding=;
當給定的命令行參數(shù)解析不了的話,就會拋出GetoptError異常。
函數(shù)的返回值包含兩個元素:
- 第一個元素是一個(option,value)元組對。Option是解析的參數(shù),value是對應參數(shù)的值;
- 第二個元素是腳本不需要執(zhí)行的參數(shù)列表。也就是這些參數(shù)是多余的;
下面看幾個Demo:
短選項:
>>> importgetopt >>> args='-a -b -cfoo -d bar a1 a2'.split() >>> args ['-a', '-b', '-cfoo', '-d', 'bar', 'a1','a2'] >>> optlist, args= getopt.getopt(args,'abc:d:') >>> optlist [('-a', ''), ('-b', ''), ('-c', 'foo'),('-d', 'bar')] >>> args ['a1', 'a2']
長選項:
>>> s='--condition=foo --testing --output-file abc.def -x a1 a2' >>> args= s.split() >>> args ['--condition=foo', '--testing','--output-file', 'abc.def', '-x', 'a1', 'a2'] >>> optlist, args= getopt.getopt(args,'x', [ ... 'condition=','output-file=','testing']) >>> optlist [('--condition', 'foo'), ('--testing', ''),('--output-file', 'abc.def'), ('-x', '')] >>> args ['a1', 'a2']
在腳本當中經典的應用實例:
importgetopt,sys defmain(): try: opts, args = getopt.getopt(sys.argv[1:],"ho:v", ["help","output="]) except getopt.GetoptErroras err: # print help information and exit: printstr(err) # will print something like "option -a not recognized" usage() sys.exit(2) output =None verbose =False for o, a in opts: if o =="-v": verbose =True elif o in ("-h","--help"): usage() sys.exit() elif o in ("-o","--output"): output = a else: assertFalse,"unhandled option" # ... if __name__ =="__main__": main()
argparse模塊
argparse模塊使得編寫用戶友好的命令行接口非常容易。程序只需定義好它要求的參數(shù),然后argparse將負責如何從sys.argv中解析出這些參數(shù)。argparse模塊還會自動生成幫助和使用信息并且當用戶賦給程序非法的參數(shù)時產生錯誤信息。
使用argparse模塊一般需要三個步驟:
1. 創(chuàng)建一個解析器
使用argparse的第一步是創(chuàng)建一個ArgumentParser對象:
>>> parser= argparse.ArgumentParser()
ArgumentParser對象會保存把命令行解析成Python數(shù)據(jù)類型所需要的所有信息。
2. 添加參數(shù)
通過調用add_argument()方法向ArgumentParser添加程序的參數(shù)信息。通常情況下,這些信息告訴ArgumentParser如何接收命令行上的字符串并將它們轉換成對象。這些信息被保存下來并在調用parse_args()時用到。例如:
>>> parser.add_argument('--name', help='username') >>> parser.add_argument('--pass', help='password ')
接下來,調用parse_args()返回的對象將帶有兩個屬性,name和pass。分別保存著用戶名與密碼。
3. 解析參數(shù)
ArgumentParser通過parse_args()方法解析參數(shù)。它將檢查命令行,把每個參數(shù)轉換成恰當?shù)念愋筒⒉扇∏‘數(shù)膭幼?。在大部分情況下,這意味著將從命令行中解析出來的屬性建立一個簡單的 Namespace對象。
>>> argments = parser.parse_args(['--name','li','--pass','si'])
在腳本中,parse_args()
調用一般不帶參數(shù),ArgumentParser
將根據(jù)sys.argv
自動確定命令行參數(shù)。
ArgumentParser 對象
class argparse.ArgumentParser(prog=None, usage=None, description=None, epilog=None, parents=[], formatter_class=argparse.HelpFormatter,prefix_chars='-', fromfile_prefix_chars=None, argument_default=None, conflict_handler='error', add_help=True)
創(chuàng)建一個新的argmentParserr對象。所有的參數(shù)應該以關鍵字參數(shù)傳遞。下面有對每個參數(shù)各自詳細的描述,但是簡短地講它們是:
- prog - 程序的名字(默認:sys.argv[0])
- useage - 描述程序用法的字符串(默認:從解析器的參數(shù)生成)
- description - 參數(shù)幫助信息之前的文本(默認:空)
- epilog- 參數(shù)幫助信息之后的文本(默認:空)
- parents - ArgmentParser 對象的一個列表,這些對象的參數(shù)應該包括進去
- ormatter_class - 定制化幫助信息的類
- prefix_chars - 可選參數(shù)的前綴字符集(默認:‘-‘)
- fromfile_prefix_chars - 額外的參數(shù)應該讀取的文件的前綴字符集(默認:None)
- argument_default - 參數(shù)的全局默認值(默認:None)
- conflict_handler - 解決沖突的可選參數(shù)的策略(通常沒有必要)
- add_help - 給解析器添加-h/–help 選項(默認:True)
add_argument() 方法
ArgumentParser.add_argument(nameor flags...[, action][, nargs][, const][, default][, type][, choices][, required][, help][,metavar][, dest])
定義應該如何解析一個命令行參數(shù)。下面每個參數(shù)有它們自己詳細的描述,簡單地講它們是:
- name or flags- 選項字符串的名字或者列表,例如foo 或者-f, --foo。
- action - 在命令行遇到該參數(shù)時采取的基本動作類型。
- nargs - 應該讀取的命令行參數(shù)數(shù)目。
- const- 某些action和nargs選項要求的常數(shù)值。
- default - 如果命令行中沒有出現(xiàn)該參數(shù)時的默認值。
- type- 命令行參數(shù)應該被轉換成的類型。
- choices - 參數(shù)可允許的值的一個容器。
- required - 該命令行選項是否可以省略(只針對可選參數(shù))。
- help - 參數(shù)的簡短描述。
- metavar - 參數(shù)在幫助信息中的名字。
- dest - 給parse_args()返回的對象要添加的屬性名稱。
總結
以上就是本文關于Python命令行解析模塊詳解的全部內容,希望對大家有所幫助。感興趣的朋友可以繼續(xù)參閱本站其他相關專題,如有不足之處,歡迎留言指出。感謝朋友們對本站的支持!
相關文章
Python使用Apache Kafka時Poll拉取速度慢的解決方法
在使用Apache Kafka時,poll方法拉取消息速度慢常見于網絡延遲、消息大小過大、消費者配置不當或高負載情況,本文提供了優(yōu)化消費者配置、并行消費、優(yōu)化消息處理邏輯和監(jiān)控調試的解決方案,并附有Python代碼示例和相關類圖、序列圖以幫助理解和實現(xiàn)2024-09-09python try...finally...的實現(xiàn)方法
這篇文章主要介紹了python try...finally...的實現(xiàn)方法,幫助大家更好的理解和使用python,感興趣的朋友可以了解下2020-11-11淺談Python中os模塊及shutil模塊的常規(guī)操作
這篇文章主要介紹了淺談Python中os模塊及shutil模塊的常規(guī)操作,具有很好的參考價值,希望對大家有所幫助。一起跟隨小編過來看看吧2020-04-04