最近在研究pathon的命令行解析工具，argparse，它是Python標準庫中推薦使用的編寫命令行程式的工具。 以前老是做UI程式，今天試了下命令行程式，感覺相當好，不用再花大把時間去研究界面問題，尤其是vc++中尤其繁瑣。 現在用python來實現命令行，核心計算模塊可以用c自己寫擴展庫，效果 ...
最近在研究pathon的命令行解析工具，argparse，它是Python標準庫中推薦使用的編寫命令行程式的工具。
以前老是做UI程式，今天試了下命令行程式，感覺相當好，不用再花大把時間去研究界面問題，尤其是vc++中尤其繁瑣。
現在用python來實現命令行，核心計算模塊可以用c自己寫擴展庫，效果挺好。
學習了argparse，在官方文檔中找到一篇toturial，簡單翻譯了下。
http://docs.python.org/2/howto/argparse.html#id1
Argparse Tutorial
這篇教程簡明地介紹了Python標準庫推薦使用的命令行參數解析模塊——Argparse的使用。
基本概念
在這篇教程中我們通過一個常見的ls命令來展示argparse的功能。
$ ls cpython devguide prog.py pypy rm-unused-function.patch $ ls pypy ctypes_configure demo dotviewer include lib_pypy lib-python ... $ ls -l total 20 drwxr-xr-x 19 wena wena 4096 Feb 18 18:51 cpython drwxr-xr-x 4 wena wena 4096 Feb 8 12:04 devguide -rwxr-xr-x 1 wena wena 535 Feb 19 00:05 prog.py drwxr-xr-x 14 wena wena 4096 Feb 7 00:59 pypy -rw-r--r-- 1 wena wena 741 Feb 18 01:01 rm-unused-function.patch $ ls --help Usage: ls [OPTION]... [FILE]... List information about the FILEs (the current directory by default). Sort entries alphabetically if none of -cftuvSUX nor --sort is specified.
從以上的四個命令中，我們能夠瞭解以下幾個基本概念：
- ls命令在沒有參數的情況下也是可以運行的，預設列印出當前目錄下的所有內容。
- 如果我們想讓它展示更多內容，那麼我們需要給它多一點參數。在這種情況下，我們想顯示一個不同的目錄，pypy。我們所做的就是明確了常見的定位參數（positional argument），這樣命名是因為需要程式根據參數在命令行中的位置而決定做什麼。這個概念與命令cp更為接近，它的用法是cp src dest，src表示的是你想要拷貝的文件，dest表示你想要將文件拷貝到哪裡。
- 現在，我想要改變程式的行為。在我們的例子中，我想顯示文件的向西信息而不僅僅是文件名，參數-l 則是我們所知道的可選參數(optinal argument)
- 最後一句是顯示幫助的文檔的一個片段，當你遇到你從未使用過的命令時，你可以通過它學習怎麼使用。
基本認識
我們從一個基本的程式開始（它什麼也不做）
import argparse parser = argparse.ArgumentParser() parser.parse_args()
運行結果：
$ python prog.py $ python prog.py --help usage: prog.py [-h] optional arguments: -h, --help show this help message and exit $ python prog.py --verbose usage: prog.py [-h] prog.py: error: unrecognized arguments: --verbose $ python prog.py foo usage: prog.py [-h] prog.py: error: unrecognized arguments: foo
結果分析：
- 若不給參數而運行這個程式，將不會得到任何結果。
- 第二條命名顯示了使用的argparse的好處，你什麼也沒做，卻得到了一個很好的幫助信息。
- 我們無需人為設置--help參數，就能得到一個良好的幫助信息。但是若給其他參數（比如foo）就會產生一個錯誤。
位置參數
首先，給一個例子：
import argparse
parser = argparse.ArgumentParser()
parser.add_argument("echo")
args = parser.parse_args()
print args.echo
運行結果:
$ python prog.py usage: prog.py [-h] echo prog.py: error: the following arguments are required: echo $ python prog.py --help usage: prog.py [-h] echo positional arguments: echo optional arguments: -h, --help show this help message and exit $ python prog.py foo foo
結果分析：
- 這次，我們增加了一個add_argument()方法，用來設置程式可接受的命令行參數。
- 現在要運行程式，就必須設置一個參數。
- parse_args()方法實際上從我們的命令行參數中返回了一些數據，在上面的例子中是echo
- 這個像“魔法”一樣的過程，是argparse自動完成的。
儘管自動產生的幫助信息展示地很美觀，但是我們仍然無法只根據echo這個參數知道它是做什麼的。所以，我們增加了一些東西，使得它變得更有用。
import argparse
parser = argparse.ArgumentParser()
parser.add_argument("echo", help="echo the string you use here")
args = parser.parse_args()
print args.echo
運行結果：
$ python prog.py -h usage: prog.py [-h] echo positional arguments: echo echo the string you use here optional arguments: -h, --help show this help message and exit
在此基礎上，我們再多改變一點：（計算輸入參數square的平方）
import argparse
parser = argparse.ArgumentParser()
parser.add_argument("square", help="display a square of a given number")
args = parser.parse_args()
print args.square**2
下麵是運行結果：
$ python prog.py 4
Traceback (most recent call last):
File "prog.py", line 5, in <module>
print args.square**2
TypeError: unsupported operand type(s) for ** or pow(): 'str' and 'int'
這個程式並不能正確運行，因為argparse會將輸入當作字元串處理，所以我們需要設置它的類型：（type=int）
import argparse
parser = argparse.ArgumentParser()
parser.add_argument("square", help="display a square of a given number",
type=int)
args = parser.parse_args()
print args.square**2
下麵是運行結果:
$ python prog.py 4 16 $ python prog.py four usage: prog.py [-h] square prog.py: error: argument square: invalid int value: 'four'
現在，這個程式能夠順利運行，而且能夠處理一些錯誤輸入。
From: http://www.cnblogs.com/jianboqi/archive/2013/01/10/2854726.html
