一、argparse介紹

官方文檔

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

二、argparse使用——代碼示例

一個簡單的示例。

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)

三個步驟：

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

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

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

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

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

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

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

描述description

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

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

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

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])

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

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

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

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

args = parser.parse_args()

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

三、結(jié)果測試

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)

顯示幫助文檔：

輸錯命令會告訴你usage用法：

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

action='store_true’的使用說明

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

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

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

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

四、python args parse_args() 報錯解決

1、error: the following arguments are required: xxx

報錯：

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

原因：

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

五、其他問題匯總（評論小伙伴問的）

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

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

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

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

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

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

總結(jié)

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

最新評論