一、argparse介紹

官方文檔

argparse 模塊是 Python 內(nèi)置的一個(gè)用于命令項(xiàng)選項(xiàng)與參數(shù)解析的模塊，argparse 模塊可以讓人輕松編寫用戶友好的命令行接口。通過(guò)在程序中定義好我們需要的參數(shù)，然后 argparse 將會(huì)從 sys.argv 解析出這些參數(shù)。argparse 模塊還會(huì)自動(dòng)生成幫助和使用手冊(cè)，并在用戶給程序傳入無(wú)效參數(shù)時(shí)報(bào)出錯(cuò)誤信息。

二、argparse使用——代碼示例

一個(gè)簡(jiǎn)單的示例。

import argparse

parser = argparse.ArgumentParser(description='test')

parser.add_argument('--sparse', action='store_true', default=False, help='GAT with sparse version or not.')
parser.add_argument('--seed', type=int, default=72, help='Random seed.')
parser.add_argument('--epochs', type=int, default=10000, help='Number of epochs to train.')

args = parser.parse_args()
print(args.sparse)
print(args.seed)
print(args.epochs)

三個(gè)步驟：

1、創(chuàng)建一個(gè)解析器——創(chuàng)建 ArgumentParser() 對(duì)象

2、添加參數(shù)——調(diào)用 add_argument() 方法添加參數(shù)

3、解析參數(shù)——使用 parse_args() 解析添加的參數(shù)

1、創(chuàng)建一個(gè)解析器——創(chuàng)建 ArgumentParser() 對(duì)象

使用 argparse 的第一步是創(chuàng)建一個(gè) ArgumentParser 對(duì)象：

parser = argparse.ArgumentParser(description='test')

ArgumentParser 對(duì)象包含將命令行解析成 Python 數(shù)據(jù)類型所需的全部信息。

描述description

大多數(shù)對(duì) ArgumentParser 構(gòu)造方法的調(diào)用都會(huì)使用 description= 關(guān)鍵字參數(shù)。這個(gè)參數(shù)簡(jiǎn)要描述這個(gè)程度做什么以及怎么做。在幫助消息中，這個(gè)描述會(huì)顯示在命令行用法字符串和各種參數(shù)的幫助消息之間。

2、添加參數(shù)——調(diào)用 add_argument() 方法添加參數(shù)

給一個(gè) ArgumentParser 添加程序參數(shù)信息是通過(guò)調(diào)用 add_argument() 方法完成的。通常，這些調(diào)用指定 ArgumentParser 如何獲取命令行字符串并將其轉(zhuǎn)換為對(duì)象。這些信息在 parse_args() 調(diào)用時(shí)被存儲(chǔ)和使用。例如

parser.add_argument('--sparse', action='store_true', default=False, help='GAT with sparse version or not.')
parser.add_argument('--seed', type=int, default=72, help='Random seed.')
parser.add_argument('--epochs', type=int, default=10000, help='Number of epochs to train.')

add_argument() 方法定義如何解析命令行參數(shù)

ArgumentParser.add_argument(name or flags...[, action][, nargs][, const][, default][, type][, choices][, required][, help][, metavar][, dest])

每個(gè)參數(shù)解釋如下:

• name or flags - 選項(xiàng)字符串的名字或者列表，例如 foo 或者 -f, --foo。
• action - 命令行遇到參數(shù)時(shí)的動(dòng)作，默認(rèn)值是 store。
• store_const，表示賦值為const；
• append，將遇到的值存儲(chǔ)成列表，也就是如果參數(shù)重復(fù)則會(huì)保存多個(gè)值;
• append_const，將參數(shù)規(guī)范中定義的一個(gè)值保存到一個(gè)列表；
• count，存儲(chǔ)遇到的次數(shù)；此外，也可以繼承 argparse.Action 自定義參數(shù)解析；
• nargs - 應(yīng)該讀取的命令行參數(shù)個(gè)數(shù)，可以是具體的數(shù)字，或者是?號(hào)，當(dāng)不指定值時(shí)對(duì)于 Positional argument 使用 default，對(duì)于 Optional argument 使用 const；或者是 * 號(hào)，表示 0 或多個(gè)參數(shù)；或者是 + 號(hào)表示 1 或多個(gè)參數(shù)。
• const - action 和 nargs 所需要的常量值。
• default - 不指定參數(shù)時(shí)的默認(rèn)值。
• type - 命令行參數(shù)應(yīng)該被轉(zhuǎn)換成的類型。
• choices - 參數(shù)可允許的值的一個(gè)容器。
• required - 可選參數(shù)是否可以省略 (僅針對(duì)可選參數(shù))。
• help - 參數(shù)的幫助信息，當(dāng)指定為 argparse.SUPPRESS 時(shí)表示不顯示該參數(shù)的幫助信息.
• metavar - 在 usage 說(shuō)明中的參數(shù)名稱，對(duì)于必選參數(shù)默認(rèn)就是參數(shù)名稱，對(duì)于可選參數(shù)默認(rèn)是全大寫的參數(shù)名稱.
• dest - 解析后的參數(shù)名稱，默認(rèn)情況下，對(duì)于可選參數(shù)選取最長(zhǎng)的名稱，中劃線轉(zhuǎn)換為下劃線.

3、解析參數(shù)——使用 parse_args() 解析添加的參數(shù)

ArgumentParser 通過(guò) parse_args() 方法解析參數(shù)。它將檢查命令行，把每個(gè)參數(shù)轉(zhuǎn)換為適當(dāng)?shù)念愋腿缓笳{(diào)用相應(yīng)的操作。在大多數(shù)情況下，這意味著一個(gè)簡(jiǎn)單的 Namespace 對(duì)象將從命令行解析出的屬性構(gòu)建：

args = parser.parse_args()

在腳本中，通常 parse_args() 會(huì)被不帶參數(shù)調(diào)用，而 ArgumentParser 將自動(dòng)從 sys.argv 中確定命令行參數(shù)。

三、結(jié)果測(cè)試

import argparse

parser = argparse.ArgumentParser(description='test')

parser.add_argument('--sparse', action='store_true', default=False, help='GAT with sparse version or not.')
parser.add_argument('--seed', type=int, default=72, help='Random seed.')
parser.add_argument('--epochs', type=int, default=10000, help='Number of epochs to train.')

args = parser.parse_args()

print(args.sparse)
print(args.seed)
print(args.epochs)

顯示幫助文檔：

輸錯(cuò)命令會(huì)告訴你usage用法：

使用命令修改參數(shù)：

action='store_true’的使用說(shuō)明

action·- 命令行遇到參數(shù)時(shí)的動(dòng)作，默認(rèn)值是 store。

直接運(yùn)行python test.py，輸出結(jié)果False

運(yùn)行python test.py --sparse，輸出結(jié)果True

也就是說(shuō)，action=‘store_true’，只要運(yùn)行時(shí)該變量有傳參就將該變量設(shè)為True。

四、python args parse_args() 報(bào)錯(cuò)解決

1、error: the following arguments are required: xxx

報(bào)錯(cuò)：

usage: test.py [-h] xxx
test.py: error: the following arguments are required: xxx

原因：

• args分為可選參數(shù)（用--指定）和必選參數(shù)（不加--指定）。
• 如果你定義參數(shù)xxx時(shí)，沒(méi)有用--指定，那么該參數(shù)為需要在命令行內(nèi)手動(dòng)指定。此時(shí)即使通過(guò)default設(shè)置默認(rèn)參數(shù)，也還是會(huì)報(bào)錯(cuò)。

五、其他問(wèn)題匯總（評(píng)論小伙伴問(wèn)的）

1、下劃線_和橫線-的區(qū)別

Q1：請(qǐng)問(wèn)博主，第一個(gè)位置參數(shù)假如說(shuō)是--max_episode_len,然后也有人寫是--max-episode-len,但是他在調(diào)用的時(shí)候仍然用的是args.max_episode_len，也沒(méi)報(bào)錯(cuò)，請(qǐng)問(wèn)這個(gè)下劃線_和-的區(qū)別在哪里呢？

A1：沒(méi)啥區(qū)別，在這里表示同一個(gè)意思，-對(duì)應(yīng)_，代碼里寫的不一樣或者都改成一樣的都可以

2、debug怎么進(jìn)行？

Q2：這種運(yùn)行是不是脫離ide，那debug怎么進(jìn)行??？

A2：有l(wèi)inux下，命令行單點(diǎn)調(diào)試的方法，python -m pdb test.py，搜一搜，網(wǎng)上挺多

總結(jié)

到此這篇關(guān)于python中parser.add_argument()用法的文章就介紹到這了,更多相關(guān)python parser.add_argument()用法內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論