私はもともとCプログラマです。私はたくさんの異なった議論を読むためのたくさんのトリックと「ハック」を見ました。
Pythonプログラマーがこれを行うことができる方法のいくつかは何ですか?
標準ライブラリの標準的な解決策はargparse
( docs )です。
これが一例です。
from argparse import ArgumentParser
parser = ArgumentParser()
parser.add_argument("-f", "--file", dest="filename",
help="write report to FILE", metavar="FILE")
parser.add_argument("-q", "--quiet",
action="store_false", dest="verbose", default=True,
help="don't print status messages to stdout")
args = parser.parse_args()
argparse
は(とりわけ)サポートしています。
import sys
print("\n".join(sys.argv))
sys.argv
は、コマンドラインでスクリプトに渡されたすべての引数を含むリストです。
基本的に、
import sys
print(sys.argv[1:])
(リンクからコピー)
argparseモジュールは位置引数とオプション引数を処理できますが、optparseモジュールはオプション引数のみを処理できます。
argparseは、あなたのコマンドラインインターフェースがどうあるべきかについては教義的ではありません - 必須のオプションとして、-fileや/ fileのようなオプションがサポートされています。 Optparseはこれらの機能をサポートすることを拒否し、実用性よりも純粋さを好む
argparseは、引数から決定されたコマンドラインの使用法、位置引数とオプション引数の両方に関するヘルプメッセージなど、より有益な使用法メッセージを生成します。 optparseモジュールはあなたがあなた自身の用法文字列を書くことを必要とし、位置引数のヘルプを表示する方法がありません。
argparseは可変数のコマンドライン引数を消費するアクションをサポートしますが、optparseは正確な数の引数(例えば1、2、3)を事前に知っておく必要があります。
argparseはサブコマンドにディスパッチするパーサをサポートしますが、optparseはallow_interspersed_args
を設定して手動でパーサをディスパッチする必要があります。
そして私の個人的なお気に入り:
add_argument()
に指定することを可能にします、一方optparseは適切な引数チェックを得るためにSTORE_ACTIONS
またはCHECK_METHODS
のようなクラス属性をハッキングすることを必要としますargparse
stdlibモジュール (stdlibのoptparse
モジュールの「改善」)もあります。 argparseの紹介 の例:
# script.py
import argparse
if __== '__main__':
parser = argparse.ArgumentParser()
parser.add_argument(
'integers', metavar='int', type=int, choices=range(10),
nargs='+', help='an integer in the range 0..9')
parser.add_argument(
'--sum', dest='accumulate', action='store_const', const=sum,
default=max, help='sum the integers (default: find the max)')
args = parser.parse_args()
print(args.accumulate(args.integers))
使用法:
$ script.py 1 2 3 4
4
$ script.py --sum 1 2 3 4
10
その1つの方法はsys.argv
を使うことです。これにより、最初の引数としてスクリプト名が渡され、その他のすべてのパラメータが渡されます。
import sys
for arg in sys.argv:
print arg
docopt ライブラリは本当に滑らかです。それはあなたのアプリの用法文字列から引数の辞書を構築します。
Docopt readmeからの例:
"""Naval Fate.
Usage:
naval_fate.py ship new <name>...
naval_fate.py ship <name> move <x> <y> [--speed=<kn>]
naval_fate.py ship shoot <x> <y>
naval_fate.py mine (set|remove) <x> <y> [--moored | --drifting]
naval_fate.py (-h | --help)
naval_fate.py --version
Options:
-h --help Show this screen.
--version Show version.
--speed=<kn> Speed in knots [default: 10].
--moored Moored (anchored) mine.
--drifting Drifting mine.
"""
from docopt import docopt
if __== '__main__':
arguments = docopt(__doc__, version='Naval Fate 2.0')
print(arguments)
あなたが速く何かを必要とし、あまり柔軟ではない場合
main.py:
import sys
first_name = sys.argv[1]
last_name = sys.argv[2]
print("Hello " + first_name + " " + last_name)
それからpython main.py James Smith
を実行してください。
次のように出力します。
こんにちはジェームズスミス
#set default args as -h , if no args:
if len(sys.argv) == 1: sys.argv[1:] = ["-h"]
私は自分でoptparseを使っていますが、Simon Willisonが最近紹介した optfunc libraryで取っている方向と同じように思います。それは働きます:
msgstr "" "関数定義(その引数とそのデフォルト値を含む)をイントロスペクトしてそれを使ってコマンドライン引数パーサを構築します。"
それで、例えば、この関数定義は:
def geocode(s, api_key='', geocoder='google', list_geocoders=False):
このoptparseヘルプテキストに変わります:
Options:
-h, --help show this help message and exit
-l, --list-geocoders
-a API_KEY, --api-key=API_KEY
-g GEOCODER, --geocoder=GEOCODER
Stdlibのgetoptが好きです。例えば:
try:
opts, args = getopt.getopt(sys.argv[1:], 'h', ['help'])
except getopt.GetoptError, err:
usage(err)
for opt, arg in opts:
if opt in ('-h', '--help'):
usage()
if len(args) != 1:
usage("specify thing...")
最近、私は物事をより冗長にするためにこれに似た何かをラップしています(例えば、「-h」を暗黙的にする)。
あなたは私が書いた小さなPythonモジュールに興味があるかもしれません(オープンソースと自由に使える) - Commando
私は docopt をこれらの他のものへの単純な代替として見ることを勧めます。
docoptは、あなたが自分ですべてを実装することを要求するのではなく、あなたの--help使用法メッセージを解析することによって機能する新しいプロジェクトです。使用法メッセージをPOSIX形式にするだけです。
import argparse
parser = argparse.ArgumentParser(description='Process some integers.')
parser.add_argument('integers', metavar='N', type=int, nargs='+',
help='an integer for the accumulator')
parser.add_argument('--sum', dest='accumulate', action='store_const',
const=sum, default=max,
help='sum the integers (default: find the max)')
args = parser.parse_args()
print(args.accumulate(args.integers))
Assuming the Python code above is saved into a file called prog.py
$ python prog.py -h
Ref-link: https://docs.python.org/3.3/library/argparse.html
さらに別の選択肢は argh です。それはargparseの上に構築されており、そしてあなたに次のようなことを書かせることができます:
import argh
# declaring:
def echo(text):
"Returns given Word as is."
return text
def greet(name, greeting='Hello'):
"Greets the user with given name. The greeting is customizable."
return greeting + ', ' + name
# assembling:
parser = argh.ArghParser()
parser.add_commands([echo, greet])
# dispatching:
if __== '__main__':
parser.dispatch()
それは自動的にヘルプなどを生成するでしょう、そしてあなたは引数解析がどのように働くべきであるかに関する追加ガイダンスを提供するためにデコレータを使うことができます。
私の解決策は entrypoint2 です。例:
from entrypoint2 import entrypoint
@entrypoint
def add(file, quiet=True):
''' This function writes report.
:param file: write report to FILE
:param quiet: don't print status messages to stdout
'''
print file,quiet
ヘルプテキスト:
usage: report.py [-h] [-q] [--debug] file
This function writes report.
positional arguments:
file write report to FILE
optional arguments:
-h, --help show this help message and exit
-q, --quiet don't print status messages to stdout
--debug set logging level to DEBUG