14.3.4.2 コールバック関数はどのように呼び出されるか

コールバックは全て以下の形式で呼び出されます:

func(option, opt_str, value, parser, *args, **kwargs)

ここで、

option

コールバックを呼び出している Option のインスタンスです。

opt_str

は、コールバック呼び出しのきっかけとなったコマンドライン上のオプション文字列です。 (長い形式のオプションに対する省略形が使われている場合、opt は完全な、正式な形のオプション文字列となります -- 例えば、ユーザが --foobar の短縮形として "-foo" をコマンドラインに入力した時には、opt_str は "-foobar" となります。)

value

オプションの引数で、コマンドライン上に見つかったものです。 optparse は、type が設定されている場合、単一の引数しかとりません;value の型はオプションの型として指定された型になります。このオプションに対する type が None である(引数なしの) 場合、value は None になります。 "nargs" > 1 であれば、value はは適切な型をもつ値のタプルになります。

parser

現在のオプション解析の全てを駆動している OptionParser インスタンスです。この変数が有用なのは、この値を介してインスタンス属性としていくつかの興味深いデータにアクセスできるからです:

parser.largs: 現在放置されている引数、すなわち、すでに消費されたものの、オプションでもオプション引数でもない引数からなるリストです。 parser.largs は自由に変更でき、たとえば引数を追加したりできます (このリストは args 、すなわち parse_args() の二つ目の戻り値になります)
parser.rargs: 現在残っている引数、すなわち、 opt_str および value があれば除き、それ以外の引数が残っているリストです。 parser.rargs は自由に変更でき、例えばさらに引数を消費したりできます。
parser.values: オプションの値がデフォルトで保存されるオブジェクト (optparse.OptionValues のインスタンス) です。この値を使うと、コールバック関数がオプションの値を記憶するために、他のoptparse と同じ機構を使えるようにするため、グローバル変数や閉包 (closure) を台無しにしないので便利です。コマンドライン上にすでに現れているオプションの値にもアクセスできます。

args

callback_args オプション属性で与えられた任意の固定引数からなるタプルです。

kwargs

callback_args オプション属性で与えられた任意のキーワード引数からなるタプルです。

ご意見やご指摘をお寄せになりたい方は、 このドキュメントについて... をご覧ください。