Python詳解argparse參數(shù)模塊之命令行參數(shù)
help(argparse)查看說明文檔,“argparse - Command-line parsing library”我們可以知道是一個命令行解析庫,是關(guān)于參數(shù)解析相關(guān)的一個模塊。
示例一:最簡參數(shù)對象
先來一段簡單的代碼,快速熟知下這個參數(shù)是個啥。
保存為t.py這樣一個文件
import argparse parser = argparse.ArgumentParser(description='最簡單的測試') parser.add_argument('--test', type=str, default='China') args = parser.parse_args() print(args.test)
然后我們在命令行中運(yùn)行這個文件
C:\Users\Tony>python t.py --test "I love China"
I love China
我們來分析下這段代碼,首先就是創(chuàng)建一個參數(shù)解析對象賦給parser,然后在parser對象中使用add_argument方法添加參數(shù)以及各種選項,其中--test就是參數(shù),這個參數(shù)的名稱依其作用自定義,type=str指定輸入值類型為字符串,default='China'是默認(rèn)值,就是說如果不指定參數(shù),就顯示China這個默認(rèn)值
對于parser.parse_args()解析參數(shù)之后的調(diào)用,需要說明下,如果沒有指定dest,那就是直接調(diào)用去掉短橫線的名稱,如果指定了,比如dest='showstr',那么就調(diào)用args.showstr屬性,如果還是調(diào)用test就會報錯,需要修改為print(args.showstr)
AttributeError: 'Namespace' object has no attribute 'test'
示例二:整數(shù)求和
若沒有指定參數(shù)就取這些整數(shù)當(dāng)中的最大值:
#p.py import argparse #創(chuàng)建ArgumentParser對象,用來解析 parser = argparse.ArgumentParser(description='處理一些整數(shù)') #向?qū)ο筇砑訁?shù) parser.add_argument('integers', metavar='N', type=int, nargs='+',help='累加的整數(shù)') parser.add_argument('--sum', dest='accumulate', action='store_const',const=sum, default=max,help='求和(默認(rèn)求最大值)') #解析參數(shù) args = parser.parse_args() print(args.accumulate(args.integers))
其中調(diào)用parse_args()方法時,將返回兩個參數(shù)屬性(integers和accumulate),integers屬性是一個或多個的整數(shù),accumulate屬性是sum()求和函數(shù),如果沒有--sum參數(shù)的話就是默認(rèn)max()最大值函數(shù),default=max
另外N可以指定個數(shù),nargs='+',表示一個或多個,對正則表達(dá)式熟悉的那就很簡單了,是一個通配符,另外還有'?'表示一個,'*'表示0個或多個。
print(parser.parse_args(['--sum','1','33','5','6'])) ''' Namespace(accumulate=<built-in function sum>, integers=[1, 33, 5, 6]) '''
我們可以看到出現(xiàn)一個命名空間,其中accumulate屬性是一個sum方法, integers屬性是一系列的整數(shù)。
可以查看使用幫助說明:
C:\Users\Tony>python p.py -h
usage: p.py [-h] [--sum] N [N ...]
處理一些整數(shù)
positional arguments:
N累加的整數(shù)optional arguments:
-h, --help show this help message and exit
--sum 求和(默認(rèn)求最大值)
帶參與不帶參的操作:
C:\Users\Tony>python p.py 1 33 5 6
33C:\Users\Tony>python p.py -sum 1 33 5 6
或
C:\Users\Tony>python p.py 1 33 5 6 --sum
45
當(dāng)然如果是沒有按照參數(shù)設(shè)定的情況,會報錯:
C:\Users\Tony>python p.py
#需要輸入值N
usage: p.py [-h] [--sum] N [N ...]
p.py: error: the following arguments are required: NC:\Users\Tony>python p.py 1 33 5.1 6
#需要輸入整數(shù),浮點數(shù)就報錯
usage: p.py [-h] [--sum] N [N ...]
p.py: error: argument N: invalid int value: '5.1'
可以看出這個參數(shù)對象除了可以在命令行界面方便使用之外,還可以對其做一些嚴(yán)格的限定。比如類型的限定,示例二的類型指定為int,那就不能是浮點數(shù),如果可以是浮點數(shù)就指定成type=float
示例三:文件是否被篡改
我們來看下,test目錄下面(放了三個文本文件),生成每個文件的md5值,如果和官網(wǎng)提供的md5一樣就說明內(nèi)容沒有被篡改,執(zhí)行完之后將顯示每個文件生成的MD5值以及生成一個名為"目錄后綴.txt"文檔(內(nèi)容一樣)
#m.py import os from hashlib import md5 import argparse def parse_args(): parser =argparse.ArgumentParser() parser.add_argument('--file_dir', type=str) return parser.parse_args() def generate_md5(file_path): m =md5() file = open(file_path, 'rb') f = file.read() m.update(f) file.close() return m.hexdigest() if __name__ == '__main__': args = parse_args() file_dir = args.file_dir log_path = args.file_dir + '.txt' log = open(log_path, 'w+') for root, _, files in os.walk(file_dir): for file in files: file_path = os.path.join(root, file) md5_value = generate_md5(file_path) print(file + " : " + md5_value) log.write(file + " : " + md5_value + '\n')
命令行執(zhí)行:
C:\Users\Tony>python m.py --file_dir "C:/Users/Tony/test"
1.txt : 81dc9bdb52d04dc20036dbd8313ed055
2.txt : d84b0391f5ce6b011e4086ed73d9dd9b
3.txt : 2b3b15ac34d69fa01e851d483e61f029
這段代碼可以看出,只需指定一個文件目錄的參數(shù)即可求出目錄下面所有文件的md5值。當(dāng)然也可以跟示例二那樣做一些說明:parser.add_argument('--file_dir', type=str,help='指定文件所在目錄') 加一個help參數(shù)的說明文字。
C:\Users\Tony>python m.py -h
usage: m.py [-h] [--file_dir FILE_DIR]optional arguments:
-h, --helpshow this help message and exit
--file_dir FILE_DIR 指定文件所在目錄
parser = argparse.ArgumentParser('對文件批量生成MD5值') parser.add_argument('--file_dir',dest='fdir',type=str,help='指定文件所在目錄') print(parser.print_help()) ''' usage: 對文件批量生成MD5值 [-h] [--file_dir FDIR] optional arguments: -h, --help show this help message and exit --file_dir FDIR 指定文件所在目錄 None '''
自定義類型
除了基本類型之外,還可以自定義類型,如下定義一個類型只能是完全平方數(shù)的值
#d.py import argparse import math def perfect_square(s): v=int(s) vs=math.sqrt(v) if vs!=int(vs): msg="%r 不是一個完全平方數(shù)" %s raise argparse.ArgumentTypeError(msg) return v parser=argparse.ArgumentParser(description='自定義類型') parser.add_argument('hi',type=perfect_square,help='只能是完全平方數(shù)') args = parser.parse_args() print(args.hi)
命令行運(yùn)行:
C:\Users\Tony>python d.py 3
usage: d.py [-h] hi
d.py: error: argument hi: '3' 不是一個完全平方數(shù)
C:\Users\Tony>python d.py -h
usage: d.py [-h] hi自定義類型:
positional arguments:
hi 只能是完全平方數(shù)optional arguments:
-h, --help show this help message and exit
可以看到hi參數(shù)是一個positional arguments(位置參數(shù)),也就是說是必須的,不像前面有短橫線的optional arguments(可選參數(shù))
choices選項限定
除了上述類型限定和可以自定義類型之外,還可以限定在一些自定義的范圍內(nèi)
#c.py parser=argparse.ArgumentParser(description='自定義選項') parser.add_argument('sel',type=int,choices=range(1,9),help='請輸入[1-9)范圍的整數(shù)') args = parser.parse_args() print(args.sel)
命令行執(zhí)行:
C:\Users\Tony>python c.py 10
usage: c.py [-h] {1,2,3,4,5,6,7,8}
c.py: error: argument sel: invalid choice: 10 (choose from 1, 2, 3, 4, 5, 6, 7, 8)
required必選參數(shù)
我們也可以對可選參數(shù)指定為必選,不指定的情況:
parser=argparse.ArgumentParser(description='自定義選項') parser.add_argument('--sel',type=int,choices=range(1,9),help='請輸入[1-9)范圍的整數(shù)') print(parser.parse_args([]))
這個例子,我們知道sel參數(shù)是可選的,這樣不會出錯,結(jié)果:Namespace(sel=None)
如果加一個required=True
parser.add_argument('--sel',required=True,type=int,choices=range(1,9),help='請輸入[1-9)范圍的整數(shù)') #執(zhí)行就會報錯: usage: ipykernel_launcher.py [-h] --sel {1,2,3,4,5,6,7,8} ipykernel_launcher.py: error: the following arguments are required: --sel An exception has occurred, use %tb to see the full traceback. #這個時候的參數(shù)sel就是必選參數(shù)了 print(parser.parse_args(['--sel','2'])) Namespace(sel=2)
子命令
主要是set_defaults方法的用途,在多個解析器的時候顯得很重要。 #s.py def f(v): r=v.x + v.y + v.z print('x+y+z=',r) parser = argparse.ArgumentParser(description='求三個輸入值的和') subparsers = parser.add_subparsers(help='子命令的用法') parser_a = subparsers.add_parser('add', help='加法運(yùn)算') parser_a.add_argument('--x', type=int) parser_a.add_argument('--y', type=int) parser_a.add_argument('--z', type=int) parser_a.set_defaults(func=f)#parser_a設(shè)置默認(rèn)函數(shù)為f args = parser.parse_args() args.func(args)#運(yùn)行函數(shù)
命令行執(zhí)行:
C:\Users\Tony>python s.py add --x 11 --y 2 --z 9
x+y+z= 22
到此這篇關(guān)于Python詳解argparse參數(shù)模塊之命令行參數(shù)的文章就介紹到這了,更多相關(guān)Python argparse 內(nèi)容請搜索本站以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持本站!
版權(quán)聲明:本站文章來源標(biāo)注為YINGSOO的內(nèi)容版權(quán)均為本站所有,歡迎引用、轉(zhuǎn)載,請保持原文完整并注明來源及原文鏈接。禁止復(fù)制或仿造本網(wǎng)站,禁止在非www.sddonglingsh.com所屬的服務(wù)器上建立鏡像,否則將依法追究法律責(zé)任。本站部分內(nèi)容來源于網(wǎng)友推薦、互聯(lián)網(wǎng)收集整理而來,僅供學(xué)習(xí)參考,不代表本站立場,如有內(nèi)容涉嫌侵權(quán),請聯(lián)系alex-e#qq.com處理。