argparse.po

# SOME DESCRIPTIVE TITLE.
# Copyright (C) 1990-2021, Python Software Foundation
# This file is distributed under the same license as the Python package.
#
# Translators:
# tomo, 2017
msgid ""
msgstr ""
"Project-Id-Version: Python 2.7\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2021-01-01 01:01+0900\n"
"PO-Revision-Date: 2020-03-13 06:09+0000\n"
"Last-Translator: Naoki Nakamura <agent@sohzoh.com>\n"
"Language-Team: Japanese (http://www.transifex.com/python-doc/python-27/"
"language/ja/)\n"
"Language: ja\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=1; plural=0;\n"

#: ../../library/argparse.rst:2
msgid ""
":mod:`argparse` --- Parser for command-line options, arguments and sub-"
"commands"
msgstr ""
":mod:`argparse` --- コマンドラインオプション、引数、サブコマンドのパーサー"

#: ../../library/argparse.rst:11
msgid "**Source code:** :source:`Lib/argparse.py`"
msgstr "**ソースコード:** :source:`Lib/argparse.py`"

#: ../../library/argparse.rstNone
msgid "Tutorial"
msgstr "チュートリアル"

#: ../../library/argparse.rst:17
msgid ""
"This page contains the API reference information. For a more gentle "
"introduction to Python command-line parsing, have a look at the :ref:"
"`argparse tutorial <argparse-tutorial>`."
msgstr ""
"このページでは API のリファレンス情報が記載されています。:ref:`argparse "
"チュートリアル <argparse-tutorial>` では、コマンドラインの解析についてより優"
"しく説明しています。"

#: ../../library/argparse.rst:21
msgid ""
"The :mod:`argparse` module makes it easy to write user-friendly command-line "
"interfaces. The program defines what arguments it requires, and :mod:"
"`argparse` will figure out how to parse those out of :data:`sys.argv`.  The :"
"mod:`argparse` module also automatically generates help and usage messages "
"and issues errors when users give the program invalid arguments."
msgstr ""
":mod:`argparse` モジュールはユーザーフレンドリーなコマンドラインインタフェー"
"スの作成を簡単にします。プログラムがどんな引数を必要としているのかを定義する"
"と、:mod:`argparse` が :data:`sys.argv` からそのオプションを解析する部分の面"
"倒を見ます。:mod:`argparse` モジュールは自動的にヘルプと使用方法メッセージを"
"生成し、ユーザーが不正な引数をプログラムに指定したときにエラーを発生させま"
"す。"

#: ../../library/argparse.rst:29
msgid "Example"
msgstr "例"

#: ../../library/argparse.rst:31
msgid ""
"The following code is a Python program that takes a list of integers and "
"produces either the sum or the max::"
msgstr ""
"次のコードは、整数のリストを受け取って合計か最大値を返す Python プログラムで"
"す::"

#: ../../library/argparse.rst:46
msgid ""
"Assuming the Python code above is saved into a file called ``prog.py``, it "
"can be run at the command line and provides useful help messages:"
msgstr ""
"上の Python コードが ``prog.py`` という名前のファイルに保存されたと仮定しま"
"す。コマンドラインから便利なヘルプメッセージを表示できます:"

#: ../../library/argparse.rst:63
msgid ""
"When run with the appropriate arguments, it prints either the sum or the max "
"of the command-line integers:"
msgstr ""
"適切な引数を与えて実行した場合、このプログラムはコマンドライン引数の整数列の"
"合計か最大値を表示します:"

#: ../../library/argparse.rst:74
msgid "If invalid arguments are passed in, it will issue an error:"
msgstr "不正な引数が与えられた場合、エラーを発生させます:"

#: ../../library/argparse.rst:82
msgid "The following sections walk you through this example."
msgstr "以降の節では、この例をひと通り説明して行きます。"

#: ../../library/argparse.rst:86
msgid "Creating a parser"
msgstr "パーサーを作る"

#: ../../library/argparse.rst:88
msgid ""
"The first step in using the :mod:`argparse` is creating an :class:"
"`ArgumentParser` object::"
msgstr ""
":mod:`argparse` を使う時の最初のステップは、:class:`ArgumentParser` オブジェ"
"クトを生成することです::"

#: ../../library/argparse.rst:93
msgid ""
"The :class:`ArgumentParser` object will hold all the information necessary "
"to parse the command line into Python data types."
msgstr ""
":class:`ArgumentParser` オブジェクトはコマンドラインを解析して Python データ"
"型にするために必要なすべての情報を保持します。"

#: ../../library/argparse.rst:98
msgid "Adding arguments"
msgstr "引数を追加する"

#: ../../library/argparse.rst:100
msgid ""
"Filling an :class:`ArgumentParser` with information about program arguments "
"is done by making calls to the :meth:`~ArgumentParser.add_argument` method. "
"Generally, these calls tell the :class:`ArgumentParser` how to take the "
"strings on the command line and turn them into objects.  This information is "
"stored and used when :meth:`~ArgumentParser.parse_args` is called. For "
"example::"
msgstr ""
":class:`ArgumentParser` にプログラム引数の情報を与えるために、:meth:"
"`~ArgumentParser.add_argument` メソッドを呼び出します。一般的に、このメソッド"
"の呼び出しは :class:`ArgumentParser` に、コマンドラインの文字列を受け取ってそ"
"れをオブジェクトにする方法を教えます。この情報は保存され、:meth:"
"`~ArgumentParser.parse_args` が呼び出されたときに利用されます。例えば::"

#: ../../library/argparse.rst:112
msgid ""
"Later, calling :meth:`~ArgumentParser.parse_args` will return an object with "
"two attributes, ``integers`` and ``accumulate``.  The ``integers`` attribute "
"will be a list of one or more ints, and the ``accumulate`` attribute will be "
"either the :func:`sum` function, if ``--sum`` was specified at the command "
"line, or the :func:`max` function if it was not."
msgstr ""
"あとで :meth:`~ArgumentParser.parse_args` を呼び出すと、``integers`` と "
"``accumulate`` という2つの属性を持ったオブジェクトを返します。``integers`` 属"
"性は1つ以上の整数のリストで、``accumulate`` 属性はコマンドラインから ``--"
"sum`` が指定された場合は :func:`sum` 関数に、それ以外の場合は :func:`max` 関"
"数になります。"

#: ../../library/argparse.rst:120
msgid "Parsing arguments"
msgstr "引数を解析する"

#: ../../library/argparse.rst:122
msgid ""
":class:`ArgumentParser` parses arguments through the :meth:`~ArgumentParser."
"parse_args` method.  This will inspect the command line, convert each "
"argument to the appropriate type and then invoke the appropriate action. In "
"most cases, this means a simple :class:`Namespace` object will be built up "
"from attributes parsed out of the command line::"
msgstr ""
":class:`ArgumentParser` は引数を :meth:`~ArgumentParser.parse_args` メソッド"
"で解析します。このメソッドはコマンドラインを調べ、各引数を正しい型に変換し"
"て、適切なアクションを実行します。ほとんどの場合、これはコマンドラインの解析"
"結果から、シンプルな :class:`Namespace` オブジェクトを構築することを意味しま"
"す::"

#: ../../library/argparse.rst:131
msgid ""
"In a script, :meth:`~ArgumentParser.parse_args` will typically be called "
"with no arguments, and the :class:`ArgumentParser` will automatically "
"determine the command-line arguments from :data:`sys.argv`."
msgstr ""
"スクリプト内では、:meth:`~ArgumentParser.parse_args` は通常引数なしで呼び出さ"
"れ、:class:`ArgumentParser` は自動的に :data:`sys.argv` からコマンドライン引"
"数を取得します。"

#: ../../library/argparse.rst:137
msgid "ArgumentParser objects"
msgstr "ArgumentParser オブジェクト"

#: ../../library/argparse.rst:146
msgid ""
"Create a new :class:`ArgumentParser` object. All parameters should be passed "
"as keyword arguments. Each parameter has its own more detailed description "
"below, but in short they are:"
msgstr ""
"新しい :class:`ArgumentParser` オブジェクトを生成します。すべての引数はキー"
"ワード引数として渡すべきです。各引数についてはあとで詳しく説明しますが、簡単"
"に言うと:"

#: ../../library/argparse.rst:150
msgid "prog_ - The name of the program (default: ``sys.argv[0]``)"
msgstr "prog_ - プログラム名 (デフォルト: ``sys.argv[0]``)"

#: ../../library/argparse.rst:152
msgid ""
"usage_ - The string describing the program usage (default: generated from "
"arguments added to parser)"
msgstr ""
"usage_ - プログラムの利用方法を記述する文字列 (デフォルト: パーサーに追加され"
"た引数から生成される)"

#: ../../library/argparse.rst:155
msgid "description_ - Text to display before the argument help (default: none)"
msgstr "description_ - 引数のヘルプの前に表示されるテキスト (デフォルト: none)"

#: ../../library/argparse.rst:157
msgid "epilog_ - Text to display after the argument help (default: none)"
msgstr "epilog_ - 引数のヘルプの後で表示されるテキスト (デフォルト: none)"

#: ../../library/argparse.rst:159
msgid ""
"parents_ - A list of :class:`ArgumentParser` objects whose arguments should "
"also be included"
msgstr ""
"parents_ - :class:`ArgumentParser` オブジェクトのリストで、このオブジェクトの"
"引数が追加される"

#: ../../library/argparse.rst:162
msgid "formatter_class_ - A class for customizing the help output"
msgstr "formatter_class_ - ヘルプ出力をカスタマイズするためのクラス"

#: ../../library/argparse.rst:164
msgid ""
"prefix_chars_ - The set of characters that prefix optional arguments "
"(default: '-')"
msgstr ""
"prefix_chars_ - オプションの引数の prefix になる文字集合 (デフォルト: '-')"

#: ../../library/argparse.rst:167
msgid ""
"fromfile_prefix_chars_ - The set of characters that prefix files from which "
"additional arguments should be read (default: ``None``)"
msgstr ""
"fromfile_prefix_chars_ - 追加の引数を読み込むファイルの prefix になる文字集"
"合 (デフォルト: ``None``)"

#: ../../library/argparse.rst:170
msgid ""
"argument_default_ - The global default value for arguments (default: "
"``None``)"
msgstr ""
"argument_default_ - 引数のグローバルなデフォルト値 (デフォルト: ``None``)"

#: ../../library/argparse.rst:173
msgid ""
"conflict_handler_ - The strategy for resolving conflicting optionals "
"(usually unnecessary)"
msgstr "conflict_handler_ - 衝突するオプションを解決する方法 (通常は不要)"

#: ../../library/argparse.rst:176
msgid ""
"add_help_ - Add a ``-h/--help`` option to the parser (default: ``True``)"
msgstr ""
"add_help_ - ``-h/--help`` オプションをパーサーに追加する (デフォルト: "
"``True``)"

#: ../../library/argparse.rst:178 ../../library/argparse.rst:637
msgid "The following sections describe how each of these are used."
msgstr "以下の節では各オプションの利用方法を説明します。"

#: ../../library/argparse.rst:182
msgid "prog"
msgstr "prog"

#: ../../library/argparse.rst:184
msgid ""
"By default, :class:`ArgumentParser` objects use ``sys.argv[0]`` to determine "
"how to display the name of the program in help messages.  This default is "
"almost always desirable because it will make the help messages match how the "
"program was invoked on the command line.  For example, consider a file named "
"``myprogram.py`` with the following code::"
msgstr ""
"デフォルトでは、:class:`ArgumentParser` オブジェクトはヘルプメッセージ中に表"
"示するプログラム名を ``sys.argv[0]`` から取得します。\n"
"このデフォルトの動作は、プログラムがコマンドライン上の起動方法に合わせてヘル"
"プメッセージを作成するため、ほとんどの場合望ましい挙動になります。\n"
"例えば、``myprogram.py`` という名前のファイルに次のコードがあるとします::"

#: ../../library/argparse.rst:195
msgid ""
"The help for this program will display ``myprogram.py`` as the program name "
"(regardless of where the program was invoked from):"
msgstr ""
"このプログラムのヘルプは、プログラム名として (プログラムがどこから起動された"
"のかに関わらず) ``myprogram.py`` を表示します:"

#: ../../library/argparse.rst:214
msgid ""
"To change this default behavior, another value can be supplied using the "
"``prog=`` argument to :class:`ArgumentParser`::"
msgstr ""
"このデフォルトの動作を変更するには、:class:`ArgumentParser` の ``prog=`` 引数"
"に他の値を指定します::"

#: ../../library/argparse.rst:224
msgid ""
"Note that the program name, whether determined from ``sys.argv[0]`` or from "
"the ``prog=`` argument, is available to help messages using the ``%(prog)s`` "
"format specifier."
msgstr ""
"プログラム名は、``sys.argv[0]`` から取られた場合でも ``prog=`` 引数で与えられ"
"た場合でも、ヘルプメッセージ中では ``%(prog)s`` フォーマット指定子で利用でき"
"ます。"

#: ../../library/argparse.rst:241
msgid "usage"
msgstr "usage"

#: ../../library/argparse.rst:243
msgid ""
"By default, :class:`ArgumentParser` calculates the usage message from the "
"arguments it contains::"
msgstr ""
"デフォルトでは、 :class:`ArgumentParser` は使用法メッセージを、保持している引"
"数から生成します::"

#: ../../library/argparse.rst:259
msgid ""
"The default message can be overridden with the ``usage=`` keyword argument::"
msgstr "デフォルトのメッセージは ``usage=`` キーワード引数で変更できます::"

#: ../../library/argparse.rst:274
msgid ""
"The ``%(prog)s`` format specifier is available to fill in the program name "
"in your usage messages."
msgstr ""
"``%(prog)s`` フォーマット指定子を、使用法メッセージ内でプログラム名として利用"
"できます。"

#: ../../library/argparse.rst:279
msgid "description"
msgstr "description"

#: ../../library/argparse.rst:281
msgid ""
"Most calls to the :class:`ArgumentParser` constructor will use the "
"``description=`` keyword argument.  This argument gives a brief description "
"of what the program does and how it works.  In help messages, the "
"description is displayed between the command-line usage string and the help "
"messages for the various arguments::"
msgstr ""
"多くの場合、:class:`ArgumentParser` のコンストラクターを呼び出すときに "
"``description=`` キーワード引数が使用されます。この引数はプログラムが何をして"
"どう動くのかについての短い説明になります。ヘルプメッセージで、この説明がコマ"
"ンドラインの利用法と引数のヘルプメッセージの間に表示されます::"

#: ../../library/argparse.rst:296
msgid ""
"By default, the description will be line-wrapped so that it fits within the "
"given space.  To change this behavior, see the formatter_class_ argument."
msgstr ""
"デフォルトでは、説明は与えられたスペースに合わせて折り返されます。この挙動を"
"変更するには、formatter_class_ 引数を参照してください。"

#: ../../library/argparse.rst:301
msgid "epilog"
msgstr "epilog"

#: ../../library/argparse.rst:303
msgid ""
"Some programs like to display additional description of the program after "
"the description of the arguments.  Such text can be specified using the "
"``epilog=`` argument to :class:`ArgumentParser`::"
msgstr ""
"いくつかのプログラムは、プログラムについての追加の説明を引数の説明の後に表示"
"します。このテキストは :class:`ArgumentParser` の ``epilog=`` 引数に指定でき"
"ます::"

#: ../../library/argparse.rst:320
msgid ""
"As with the description_ argument, the ``epilog=`` text is by default line-"
"wrapped, but this behavior can be adjusted with the formatter_class_ "
"argument to :class:`ArgumentParser`."
msgstr ""
"description_ 引数と同じく、``epilog=`` テキストもデフォルトで折り返され、:"
"class:`ArgumentParser` の formatter_class_ 引数で動作を調整できます。"

#: ../../library/argparse.rst:326
msgid "parents"
msgstr "parents"

#: ../../library/argparse.rst:328
msgid ""
"Sometimes, several parsers share a common set of arguments. Rather than "
"repeating the definitions of these arguments, a single parser with all the "
"shared arguments and passed to ``parents=`` argument to :class:"
"`ArgumentParser` can be used.  The ``parents=`` argument takes a list of :"
"class:`ArgumentParser` objects, collects all the positional and optional "
"actions from them, and adds these actions to the :class:`ArgumentParser` "
"object being constructed::"
msgstr ""
"ときどき、いくつかのパーサーが共通の引数セットを共有することがあります。それ"
"らの引数を繰り返し定義する代わりに、すべての共通引数を持ったパーサーを :"
"class:`ArgumentParser` の ``parents=`` 引数に渡すことができます。 "
"``parents=`` 引数は :class:`ArgumentParser` オブジェクトのリストを受け取り、"
"すべての位置アクションとオプションのアクションをそれらから集め、そのアクショ"
"ンを構築中の :class:`ArgumentParser` オブジェクトに追加します::"

#: ../../library/argparse.rst:348
msgid ""
"Note that most parent parsers will specify ``add_help=False``.  Otherwise, "
"the :class:`ArgumentParser` will see two ``-h/--help`` options (one in the "
"parent and one in the child) and raise an error."
msgstr ""
"一番親になるパーサーに ``add_help=False`` を指定していることに注目してくださ"
"い。こうしないと、:class:`ArgumentParser` は2つの ``-h/--help`` オプションを"
"与えられる (1つは親から、もうひとつは子から) ことになり、エラーを発生します。"

#: ../../library/argparse.rst:353
msgid ""
"You must fully initialize the parsers before passing them via ``parents=``. "
"If you change the parent parsers after the child parser, those changes will "
"not be reflected in the child."
msgstr ""
"``parents=`` に渡す前にパーサーを完全に初期化する必要があります。子パーサーを"
"作成してから親パーサーを変更した場合、その変更は子パーサーに反映されません。"

#: ../../library/argparse.rst:359
msgid "formatter_class"
msgstr "formatter_class"

#: ../../library/argparse.rst:361
msgid ""
":class:`ArgumentParser` objects allow the help formatting to be customized "
"by specifying an alternate formatting class.  Currently, there are three "
"such classes:"
msgstr ""
":class:`ArgumentParser` オブジェクトは代わりのフォーマットクラスを指定するこ"
"とでヘルプのフォーマットをカスタマイズできます。現在、3つのフォーマットクラス"
"があります:"

#: ../../library/argparse.rst:369
msgid ""
"The first two allow more control over how textual descriptions are "
"displayed, while the last automatically adds information about argument "
"default values."
msgstr ""
"最初の2つは説明のテキストがどう表示されるかについてより制御できるようになって"
"おり、残りの1つは引数のデフォルト値についての情報を自動的に追加します。"

#: ../../library/argparse.rst:372
msgid ""
"By default, :class:`ArgumentParser` objects line-wrap the description_ and "
"epilog_ texts in command-line help messages::"
msgstr ""
"デフォルトでは :class:`ArgumentParser` オブジェクトはコマンドラインヘルプの中"
"の description_ と epilog_ を折り返して表示します::"

#: ../../library/argparse.rst:395
msgid ""
"Passing :class:`RawDescriptionHelpFormatter` as ``formatter_class=`` "
"indicates that description_ and epilog_ are already correctly formatted and "
"should not be line-wrapped::"
msgstr ""
"``formatter_class=`` に :class:`RawDescriptionHelpFormatter` を渡した場合、 "
"description_ と epilog_ は整形済みとされ改行されません::"

#: ../../library/argparse.rst:421
msgid ""
":class:`RawTextHelpFormatter` maintains whitespace for all sorts of help "
"text, including argument descriptions. However, multiple new lines are "
"replaced with one. If you wish to preserve multiple blank lines, add spaces "
"between the newlines."
msgstr ""
":class:`RawTextHelpFormatter` は引数の説明を含めてすべての種類のヘルプテキス"
"トで空白を維持します。例外として、複数の空行はひとつにまとめられます。複数の"
"空白行を保ちたい場合には、行に空白を含めるようにして下さい。"

#: ../../library/argparse.rst:426
msgid ""
"The other formatter class available, :class:`ArgumentDefaultsHelpFormatter`, "
"will add information about the default value of each of the arguments::"
msgstr ""
"残りの利用できるフォーマットクラスである :class:"
"`ArgumentDefaultsHelpFormatter` は各引数のデフォルト値を自動的にヘルプに追加"
"します::"

#: ../../library/argparse.rst:446
msgid "prefix_chars"
msgstr "prefix_chars"

#: ../../library/argparse.rst:448
msgid ""
"Most command-line options will use ``-`` as the prefix, e.g. ``-f/--foo``. "
"Parsers that need to support different or additional prefix characters, e.g. "
"for options like ``+f`` or ``/foo``, may specify them using the "
"``prefix_chars=`` argument to the ArgumentParser constructor::"
msgstr ""
"ほとんどのコマンドラインオプションは、``-f/--foo`` のように接頭辞に ``-`` を"
"使います。``+f`` や ``/foo`` のような、他の、あるいは追加の接頭辞文字をサポー"
"トしなければならない場合、ArgumentParser のコンストラクターに "
"``prefix_chars=`` 引数を使って指定します::"

#: ../../library/argparse.rst:460
msgid ""
"The ``prefix_chars=`` argument defaults to ``'-'``. Supplying a set of "
"characters that does not include ``-`` will cause ``-f/--foo`` options to be "
"disallowed."
msgstr ""
"``prefix_chars=`` 引数のデフォルトは ``'-'`` です。``-`` を含まない文字セット"
"を指定すると、``-f/--foo`` オプションが使用できなくなります。"

#: ../../library/argparse.rst:466
msgid "fromfile_prefix_chars"
msgstr "fromfile_prefix_chars"

#: ../../library/argparse.rst:468
msgid ""
"Sometimes, for example when dealing with a particularly long argument lists, "
"it may make sense to keep the list of arguments in a file rather than typing "
"it out at the command line.  If the ``fromfile_prefix_chars=`` argument is "
"given to the :class:`ArgumentParser` constructor, then arguments that start "
"with any of the specified characters will be treated as files, and will be "
"replaced by the arguments they contain.  For example::"
msgstr ""
"ときどき、例えば非常に長い引数リストを扱う場合に、その引数リストを毎回コマン"
"ドラインにタイプする代わりにファイルに置いておきたい場合があります。:class:"
"`ArgumentParser` のコンストラクターに ``fromfile_prefix_chars=`` 引数が渡され"
"た場合、指定された文字のいずれかで始まる引数はファイルとして扱われ、そのファ"
"イルに含まれる引数リストに置換されます。例えば::"

#: ../../library/argparse.rst:482
msgid ""
"Arguments read from a file must by default be one per line (but see also :"
"meth:`~ArgumentParser.convert_arg_line_to_args`) and are treated as if they "
"were in the same place as the original file referencing argument on the "
"command line.  So in the example above, the expression ``['-f', 'foo', "
"'@args.txt']`` is considered equivalent to the expression ``['-f', 'foo', '-"
"f', 'bar']``."
msgstr ""
"ファイルから読み込まれる引数は、デフォルトでは1行に1つ (ただし、:meth:"
"`~ArgumentParser.convert_arg_line_to_args` も参照してください) で、コマンドラ"
"イン上でファイルを参照する引数があった場所にその引数があったものとして扱われ"
"ます。なので、上の例では、``['-f', 'foo', '@args.txt']`` は ``['-f', 'foo', "
"'-f', 'bar']`` と等価になります。"

#: ../../library/argparse.rst:488
msgid ""
"The ``fromfile_prefix_chars=`` argument defaults to ``None``, meaning that "
"arguments will never be treated as file references."
msgstr ""
"``fromfile_prefix_chars=`` 引数のデフォルト値は ``None`` で、引数がファイル参"
"照として扱われることが無いことを意味しています。"

#: ../../library/argparse.rst:493
msgid "argument_default"
msgstr "argument_default"

#: ../../library/argparse.rst:495
msgid ""
"Generally, argument defaults are specified either by passing a default to :"
"meth:`~ArgumentParser.add_argument` or by calling the :meth:`~ArgumentParser."
"set_defaults` methods with a specific set of name-value pairs.  Sometimes "
"however, it may be useful to specify a single parser-wide default for "
"arguments.  This can be accomplished by passing the ``argument_default=`` "
"keyword argument to :class:`ArgumentParser`.  For example, to globally "
"suppress attribute creation on :meth:`~ArgumentParser.parse_args` calls, we "
"supply ``argument_default=SUPPRESS``::"
msgstr ""
"一般的には、引数のデフォルト値は :meth:`~ArgumentParser.add_argument` メソッ"
"ドにデフォルト値を渡すか、:meth:`~ArgumentParser.set_defaults` メソッドに名前"
"と値のペアを渡すことで指定します。しかしまれに、1つのパーサー全体に適用される"
"デフォルト引数が便利なことがあります。これを行うには、 :class:"
"`ArgumentParser` に ``argument_default=`` キーワード引数を渡します。例えば、"
"全体で :meth:`~ArgumentParser.parse_args` メソッド呼び出しの属性の生成を抑制"
"するには、``argument_default=SUPPRESS`` を指定します::"

#: ../../library/argparse.rst:514
msgid "conflict_handler"
msgstr "conflict_handler"

#: ../../library/argparse.rst:516
msgid ""
":class:`ArgumentParser` objects do not allow two actions with the same "
"option string.  By default, :class:`ArgumentParser` objects raise an "
"exception if an attempt is made to create an argument with an option string "
"that is already in use::"
msgstr ""
":class:`ArgumentParser` オブジェクトは同じオプション文字列に対して複数のアク"
"ションを許可していません。\n"
"デフォルトでは、:class:`ArgumentParser` オブジェクトは、すでに利用されている"
"オプション文字列を使って新しい引数をつくろうとしたときに例外を送出します::"

#: ../../library/argparse.rst:528
msgid ""
"Sometimes (e.g. when using parents_) it may be useful to simply override any "
"older arguments with the same option string.  To get this behavior, the "
"value ``'resolve'`` can be supplied to the ``conflict_handler=`` argument "
"of :class:`ArgumentParser`::"
msgstr ""
"ときどき (例えば parents_ を利用する場合など)、古い引数を同じオプション文字列"
"で上書きするほうが便利な場合があります。この動作をするには、:class:"
"`ArgumentParser` の ``conflict_handler=`` 引数に ``'resolve'`` を渡します::"

#: ../../library/argparse.rst:544
msgid ""
"Note that :class:`ArgumentParser` objects only remove an action if all of "
"its option strings are overridden.  So, in the example above, the old ``-f/--"
"foo`` action is retained as the ``-f`` action, because only the ``--foo`` "
"option string was overridden."
msgstr ""
":class:`ArgumentParser` オブジェクトは、すべてのオプション文字列が上書きされ"
"た場合にだけアクションを削除することに注目してください。上の例では、 ``--"
"foo`` オプション文字列だけが上書きされているので、古い ``-f/--foo`` アクショ"
"ンは ``-f`` アクションとして残っています。"

#: ../../library/argparse.rst:551
msgid "add_help"
msgstr "add_help"

#: ../../library/argparse.rst:553
msgid ""
"By default, ArgumentParser objects add an option which simply displays the "
"parser's help message. For example, consider a file named ``myprogram.py`` "
"containing the following code::"
msgstr ""
"デフォルトでは、ArgumentParser オブジェクトはシンプルにパーサーのヘルプメッ"
"セージを表示するオプションを自動的に追加します。例えば、以下のコードを含む "
"``myprogram.py`` ファイルについて考えてください::"

#: ../../library/argparse.rst:562
msgid ""
"If ``-h`` or ``--help`` is supplied at the command line, the ArgumentParser "
"help will be printed:"
msgstr ""
"コマンドラインに ``-h`` か ``--help`` が指定された場合、ArgumentParser の "
"help が表示されます:"

#: ../../library/argparse.rst:574
msgid ""
"Occasionally, it may be useful to disable the addition of this help option. "
"This can be achieved by passing ``False`` as the ``add_help=`` argument to :"
"class:`ArgumentParser`::"
msgstr ""
"必要に応じて、この help オプションを無効にする場合があります。これは :class:"
"`ArgumentParser` の ``add_help=`` 引数に ``False`` を渡すことで可能です::"

#: ../../library/argparse.rst:586
msgid ""
"The help option is typically ``-h/--help``. The exception to this is if the "
"``prefix_chars=`` is specified and does not include ``-``, in which case ``-"
"h`` and ``--help`` are not valid options.  In this case, the first character "
"in ``prefix_chars`` is used to prefix the help options::"
msgstr ""
"ヘルプオプションは通常 ``-h/--help`` です。例外は ``prefix_chars=`` が指定さ"
"れてその中に ``-`` が無かった場合で、その場合は ``-h`` と ``--help`` は有効な"
"オプションではありません。この場合、``prefix_chars`` の最初の文字がヘルプオプ"
"ションの接頭辞として利用されます::"

#: ../../library/argparse.rst:601
msgid "The add_argument() method"
msgstr "add_argument() メソッド"

#: ../../library/argparse.rst:607
msgid ""
"Define how a single command-line argument should be parsed.  Each parameter "
"has its own more detailed description below, but in short they are:"
msgstr ""
"1つのコマンドライン引数がどう解析されるかを定義します。各引数についての詳細は"
"後述しますが、簡単に言うと:"

#: ../../library/argparse.rst:610
msgid ""
"`name or flags`_ - Either a name or a list of option strings, e.g. ``foo`` "
"or ``-f, --foo``."
msgstr ""
"`name or flags`_ - 名前か、あるいはオプション文字列のリスト (例: ``foo`` や "
"``-f, --foo``)。"

#: ../../library/argparse.rst:613
msgid ""
"action_ - The basic type of action to be taken when this argument is "
"encountered at the command line."
msgstr "action_ - コマンドラインにこの引数があった時のアクション。"

#: ../../library/argparse.rst:616
msgid "nargs_ - The number of command-line arguments that should be consumed."
msgstr "nargs_ - 消費すべきコマンドライン引数の数。"

#: ../../library/argparse.rst:618
msgid ""
"const_ - A constant value required by some action_ and nargs_ selections."
msgstr "const_ - 一部の action_ と nargs_ の組み合わせで利用される定数。"

#: ../../library/argparse.rst:620
msgid ""
"default_ - The value produced if the argument is absent from the command "
"line."
msgstr "default_ - コマンドラインに引数がなかった場合に生成される値。"

#: ../../library/argparse.rst:623
msgid ""
"type_ - The type to which the command-line argument should be converted."
msgstr "type_ - コマンドライン引数が変換されるべき型。"

#: ../../library/argparse.rst:625
msgid "choices_ - A container of the allowable values for the argument."
msgstr "choices_ - 引数として許される値のコンテナー。"

#: ../../library/argparse.rst:627
msgid ""
"required_ - Whether or not the command-line option may be omitted (optionals "
"only)."
msgstr ""
"required_ - コマンドラインオプションが省略可能かどうか (オプション引数のみ)。"

#: ../../library/argparse.rst:630
msgid "help_ - A brief description of what the argument does."
msgstr "help_ - 引数が何なのかを示す簡潔な説明。"

#: ../../library/argparse.rst:632
msgid "metavar_ - A name for the argument in usage messages."
msgstr "metavar_ - 使用法メッセージの中で使われる引数の名前。"

#: ../../library/argparse.rst:634
msgid ""
"dest_ - The name of the attribute to be added to the object returned by :"
"meth:`parse_args`."
msgstr "dest_ - :meth:`parse_args` が返すオブジェクトに追加される属性名。"

#: ../../library/argparse.rst:641
msgid "name or flags"
msgstr "name or flags"

#: ../../library/argparse.rst:643
msgid ""
"The :meth:`~ArgumentParser.add_argument` method must know whether an "
"optional argument, like ``-f`` or ``--foo``, or a positional argument, like "
"a list of filenames, is expected.  The first arguments passed to :meth:"
"`~ArgumentParser.add_argument` must therefore be either a series of flags, "
"or a simple argument name.  For example, an optional argument could be "
"created like::"
msgstr ""
":meth:`~ArgumentParser.add_argument` メソッドは、指定されている引数が ``-f`` "
"や ``--foo`` のようなオプション引数なのか、ファイル名リストなどの位置引数なの"
"かを知る必要があります。そのため、:meth:`~ArgumentParser.add_argument` の第1"
"引数は、フラグのリストか、シンプルな引数名のどちらかになります。例えば、オプ"
"ション引数は次のようにして作成します::"

#: ../../library/argparse.rst:652
msgid "while a positional argument could be created like::"
msgstr "一方、位置引数は次のように作成します::"

#: ../../library/argparse.rst:656
msgid ""
"When :meth:`~ArgumentParser.parse_args` is called, optional arguments will "
"be identified by the ``-`` prefix, and the remaining arguments will be "
"assumed to be positional::"
msgstr ""
":meth:`~ArgumentParser.parse_args` が呼ばれた時、オプション引数は接頭辞 ``-"
"`` により識別され、それ以外の引数は位置引数として扱われます::"

#: ../../library/argparse.rst:673
msgid "action"
msgstr "action"

#: ../../library/argparse.rst:675
msgid ""
":class:`ArgumentParser` objects associate command-line arguments with "
"actions.  These actions can do just about anything with the command-line "
"arguments associated with them, though most actions simply add an attribute "
"to the object returned by :meth:`~ArgumentParser.parse_args`.  The "
"``action`` keyword argument specifies how the command-line arguments should "
"be handled. The supplied actions are:"
msgstr ""
":class:`ArgumentParser` オブジェクトはコマンドライン引数にアクションを割り当"
"てます。このアクションは、割り当てられたコマンドライン引数に関してどんな処理"
"でもできますが、ほとんどのアクションは単に :meth:`~ArgumentParser."
"parse_args` が返すオブジェクトに属性を追加するだけです。``action`` キーワード"
"引数は、コマンドライン引数がどう処理されるかを指定します。提供されているアク"
"ションは:"

#: ../../library/argparse.rst:681
msgid ""
"``'store'`` - This just stores the argument's value.  This is the default "
"action. For example::"
msgstr ""
"``'store'`` - これは単に引数の値を格納します。これはデフォルトのアクションで"
"す。例えば::"

#: ../../library/argparse.rst:689
msgid ""
"``'store_const'`` - This stores the value specified by the const_ keyword "
"argument.  The ``'store_const'`` action is most commonly used with optional "
"arguments that specify some sort of flag.  For example::"
msgstr ""
"``'store_const'`` - このアクションは const_ キーワード引数で指定された値を格"
"納します。``'store_const'`` アクションは、何かの種類のフラグを指定するオプ"
"ション引数によく使われます。例えば:"

#: ../../library/argparse.rst:698
msgid ""
"``'store_true'`` and ``'store_false'`` - These are special cases of "
"``'store_const'`` using for storing the values ``True`` and ``False`` "
"respectively.  In addition, they create default values of ``False`` and "
"``True`` respectively.  For example::"
msgstr ""
"``'store_true'``, ``'store_false'`` - これらは ``'store_const'`` の特別版で、"
"それぞれ ``True`` と ``False`` を格納するのに使います。\n"
"さらに、これらはデフォルト値をそれぞれ ``False`` と ``True`` にします。例え"
"ば::"

#: ../../library/argparse.rst:710
msgid ""
"``'append'`` - This stores a list, and appends each argument value to the "
"list.  This is useful to allow an option to be specified multiple times. "
"Example usage::"
msgstr ""
"``'append'`` - このアクションはリストを格納して、各引数の値をそのリストに追加"
"します。このアクションは複数回指定を許可したいオプションに便利です。利用例::"

#: ../../library/argparse.rst:719
msgid ""
"``'append_const'`` - This stores a list, and appends the value specified by "
"the const_ keyword argument to the list.  (Note that the const_ keyword "
"argument defaults to ``None``.)  The ``'append_const'`` action is typically "
"useful when multiple arguments need to store constants to the same list. For "
"example::"
msgstr ""
"``'append_const'`` - このアクションはリストを格納して、const_ キーワード引数"
"に与えられた値をそのリストに追加します (const_ キーワード引数のデフォルト値は"
"あまり役に立たない ``None`` であることに注意)。``'append_const'`` アクション"
"は、定数を同じリストに複数回格納する場合に便利です。例えば::"

#: ../../library/argparse.rst:731
msgid ""
"``'count'`` - This counts the number of times a keyword argument occurs. For "
"example, this is useful for increasing verbosity levels::"
msgstr ""
"``'count'`` - このアクションはキーワード引数の数を数えます。例えば、verboseレ"
"ベルを上げるのに役立ちます::"

#: ../../library/argparse.rst:739
msgid ""
"``'help'`` - This prints a complete help message for all the options in the "
"current parser and then exits. By default a help action is automatically "
"added to the parser. See :class:`ArgumentParser` for details of how the "
"output is created."
msgstr ""
"``'help'`` - このアクションは現在のパーサー中のすべてのオプションのヘルプメッ"
"セージを表示し、終了します。出力の生成方法の詳細については :class:"
"`ArgumentParser` を参照してください。"

#: ../../library/argparse.rst:744
msgid ""
"``'version'`` - This expects a ``version=`` keyword argument in the :meth:"
"`~ArgumentParser.add_argument` call, and prints version information and "
"exits when invoked::"
msgstr ""
"``'version'`` - このアクションは :meth:`~ArgumentParser.add_argument` の呼び"
"出しに ``version=`` キーワード引数を期待します。指定されたときはバージョン情"
"報を表示して終了します::"

#: ../../library/argparse.rst:754
msgid ""
"You may also specify an arbitrary action by passing an Action subclass or "
"other object that implements the same interface.  The recommended way to do "
"this is to extend :class:`Action`, overriding the ``__call__`` method and "
"optionally the ``__init__`` method."
msgstr ""
"Action のサブクラスまたは同じインターフェイスを実装したほかのオブジェクト渡す"
"ことで、任意のアクションを指定することもできます。これをするお奨めの方法"
"は、 :class:`argparse.Action` を継承して、 ``__call__`` と、必要であれば "
"``__init__`` をオーバライドすることです。"

#: ../../library/argparse.rst:759
msgid "An example of a custom action::"
msgstr "カスタムアクションの例です::"

#: ../../library/argparse.rst:779
msgid "For more details, see :class:`Action`."
msgstr "詳細は :class:`Action` を参照してください。"

#: ../../library/argparse.rst:782
msgid "nargs"
msgstr "nargs"

#: ../../library/argparse.rst:784
msgid ""
"ArgumentParser objects usually associate a single command-line argument with "
"a single action to be taken.  The ``nargs`` keyword argument associates a "
"different number of command-line arguments with a single action.  The "
"supported values are:"
msgstr ""
"ArgumentParser オブジェクトは通常1つのコマンドライン引数を1つのアクションに渡"
"します。``nargs`` キーワード引数は1つのアクションにそれ以外の数のコマンドライ"
"ン引数を割り当てます。指定できる値は:"

#: ../../library/argparse.rst:789
msgid ""
"``N`` (an integer).  ``N`` arguments from the command line will be gathered "
"together into a list.  For example::"
msgstr ""
"``N`` (整数) -- ``N`` 個の引数がコマンドラインから集められ、リストに格納され"
"ます。例えば::"

#: ../../library/argparse.rst:798
msgid ""
"Note that ``nargs=1`` produces a list of one item.  This is different from "
"the default, in which the item is produced by itself."
msgstr ""
"``nargs=1`` は1要素のリストを作ることに注意してください。これはデフォルトの、"
"要素がそのまま属性になる動作とは異なります。"

#: ../../library/argparse.rst:801
msgid ""
"``'?'``. One argument will be consumed from the command line if possible, "
"and produced as a single item.  If no command-line argument is present, the "
"value from default_ will be produced.  Note that for optional arguments, "
"there is an additional case - the option string is present but not followed "
"by a command-line argument.  In this case the value from const_ will be "
"produced.  Some examples to illustrate this::"
msgstr ""
"``'?'`` -- 可能なら1つの引数がコマンドラインから取られ、1つのアイテムを作りま"
"す。コマンドライン引数が存在しない場合、default_ の値が生成されます。オプショ"
"ン引数の場合、さらにオプション引数が指定され、その後にコマンドライン引数が無"
"いというケースもありえます。この場合は const_ の値が生成されます。この動作の"
"例です::"

#: ../../library/argparse.rst:818
msgid ""
"One of the more common uses of ``nargs='?'`` is to allow optional input and "
"output files::"
msgstr ""
"``nargs='?'`` のよくある利用例の1つは、入出力ファイルの指定オプションです::"

#: ../../library/argparse.rst:833
msgid ""
"``'*'``.  All command-line arguments present are gathered into a list.  Note "
"that it generally doesn't make much sense to have more than one positional "
"argument with ``nargs='*'``, but multiple optional arguments with "
"``nargs='*'`` is possible.  For example::"
msgstr ""
"``'*'`` -- すべてのコマンドライン引数がリストに集められます。複数の位置引数"
"が ``nargs='*'`` を持つことにあまり意味はありませんが、複数のオプション引数"
"が ``nargs='*'`` を持つことはありえます。例えば::"

#: ../../library/argparse.rst:845
msgid ""
"``'+'``. Just like ``'*'``, all command-line args present are gathered into "
"a list.  Additionally, an error message will be generated if there wasn't at "
"least one command-line argument present.  For example::"
msgstr ""
"``'+'`` -- ``'*'`` と同じように、すべてのコマンドライン引数をリストに集めま"
"す。加えて、最低でも1つのコマンドライン引数が存在しない場合にエラーメッセージ"
"を生成します。例えば::"

#: ../../library/argparse.rst:859
msgid ""
"``argparse.REMAINDER``.  All the remaining command-line arguments are "
"gathered into a list.  This is commonly useful for command line utilities "
"that dispatch to other command line utilities::"
msgstr ""
"``argparse.REMAINDER`` -- コマンドライン引数の残りすべてをリストとして集めま"
"す。これは他のコマンドラインツールに対して処理を渡すようなツールによく使われ"
"ます。例えば::"

#: ../../library/argparse.rst:870
msgid ""
"If the ``nargs`` keyword argument is not provided, the number of arguments "
"consumed is determined by the action_.  Generally this means a single "
"command-line argument will be consumed and a single item (not a list) will "
"be produced."
msgstr ""
"``nargs`` キーワード引数が指定されない場合、消費される引数の数は action_ に"
"よって決定されます。通常これは、1つのコマンドライン引数は1つのアイテムになる "
"(リストにはならない) ことを意味します。"

#: ../../library/argparse.rst:876
msgid "const"
msgstr "const"

#: ../../library/argparse.rst:878
msgid ""
"The ``const`` argument of :meth:`~ArgumentParser.add_argument` is used to "
"hold constant values that are not read from the command line but are "
"required for the various :class:`ArgumentParser` actions.  The two most "
"common uses of it are:"
msgstr ""
":meth:`~ArgumentParser.add_argument` の ``const`` 引数は、コマンドライン引数"
"から読み込まれないけれども :class:`ArgumentParser` のいくつかのアクションで必"
"要とされる値のために使われます。この引数のよくある2つの使用法は:"

#: ../../library/argparse.rst:882
msgid ""
"When :meth:`~ArgumentParser.add_argument` is called with "
"``action='store_const'`` or ``action='append_const'``.  These actions add "
"the ``const`` value to one of the attributes of the object returned by :meth:"
"`~ArgumentParser.parse_args`. See the action_ description for examples."
msgstr ""
":meth:`~ArgumentParser.add_argument` が ``action='store_const'`` か "
"``action='append_const'`` で呼び出された時、これらのアクションは ``const`` の"
"値を :meth:`~ArgumentParser.parse_args` が返すオブジェクトの属性に追加しま"
"す。サンプルは action_ の説明を参照してください。"

#: ../../library/argparse.rst:887
msgid ""
"When :meth:`~ArgumentParser.add_argument` is called with option strings "
"(like ``-f`` or ``--foo``) and ``nargs='?'``.  This creates an optional "
"argument that can be followed by zero or one command-line arguments. When "
"parsing the command line, if the option string is encountered with no "
"command-line argument following it, the value of ``const`` will be assumed "
"instead. See the nargs_ description for examples."
msgstr ""
":meth:`~ArgumentParser.add_argument` がオプション文字列 (``-f`` や ``--"
"foo``) と ``nargs='?'`` で呼び出された場合。この場合0個か1つのコマンドライン"
"引数を取るオプション引数が作られます。オプション引数にコマンドライン引数が続"
"かなかった場合、 ``const`` の値が代わりに利用されます。サンプルは nargs_ の説"
"明を参照してください。"

#: ../../library/argparse.rst:894
msgid ""
"With the ``'store_const'`` and ``'append_const'`` actions, the ``const`` "
"keyword argument must be given.  For other actions, it defaults to ``None``."
msgstr ""
"``'store_const'`` と ``'append_const'`` アクションでは、 ``const`` キーワード"
"引数を与える必要があります。他のアクションでは、デフォルトは ``None`` になり"
"ます。"

#: ../../library/argparse.rst:899
msgid "default"
msgstr "default"

#: ../../library/argparse.rst:901
msgid ""
"All optional arguments and some positional arguments may be omitted at the "
"command line.  The ``default`` keyword argument of :meth:`~ArgumentParser."
"add_argument`, whose value defaults to ``None``, specifies what value should "
"be used if the command-line argument is not present. For optional arguments, "
"the ``default`` value is used when the option string was not present at the "
"command line::"
msgstr ""
"すべてのオプション引数といくつかの位置引数はコマンドライン上で省略されること"
"があります。 :meth:`~ArgumentParser.add_argument` の ``default`` キーワード引"
"数 (デフォルト: ``None``) は、コマンドライン引数が存在しなかった場合に利用す"
"る値を指定します。オプション引数では、オプション文字列がコマンドライン上に存"
"在しなかったときに ``default`` の値が利用されます::"

#: ../../library/argparse.rst:915
msgid ""
"If the ``default`` value is a string, the parser parses the value as if it "
"were a command-line argument.  In particular, the parser applies any type_ "
"conversion argument, if provided, before setting the attribute on the :class:"
"`Namespace` return value.  Otherwise, the parser uses the value as is::"
msgstr ""
"``default`` の値が文字列の場合、パーサーは値をコマンドライン引数のように解析"
"します。具体的には、パーサーは返り値 :class:`Namespace` の属性を設定する前"
"に、type_ 変換引数が与えられていればそれらを適用します。そうでない場合、パー"
"サーは値をそのまま使用します::"

#: ../../library/argparse.rst:926
msgid ""
"For positional arguments with nargs_ equal to ``?`` or ``*``, the "
"``default`` value is used when no command-line argument was present::"
msgstr ""
"nargs_ が ``?`` か ``*`` である位置引数では、コマンドライン引数が指定されな"
"かった場合 ``default`` の値が使われます。例えば::"

#: ../../library/argparse.rst:937
msgid ""
"Providing ``default=argparse.SUPPRESS`` causes no attribute to be added if "
"the command-line argument was not present.::"
msgstr ""
"``default=argparse.SUPPRESS`` を渡すと、コマンドライン引数が存在しないときに"
"属性の追加をしなくなります。::"

#: ../../library/argparse.rst:949
msgid "type"
msgstr "type"

#: ../../library/argparse.rst:951
msgid ""
"By default, :class:`ArgumentParser` objects read command-line arguments in "
"as simple strings. However, quite often the command-line string should "
"instead be interpreted as another type, like a :class:`float` or :class:"
"`int`.  The ``type`` keyword argument of :meth:`~ArgumentParser."
"add_argument` allows any necessary type-checking and type conversions to be "
"performed.  Common built-in types and functions can be used directly as the "
"value of the ``type`` argument::"
msgstr ""
"デフォルトでは、:class:`ArgumentParser` オブジェクトはコマンドライン引数を単"
"なる文字列として読み込みます。しかし、コマンドラインの文字列は :class:"
"`float`, :class:`int` など別の型として扱うべき事がよくあります。:meth:"
"`~ArgumentParser.add_argument` の ``type`` キーワード引数により型チェックと型"
"変換を行うことができます。一般的なビルトインデータ型や関数を ``type`` 引数の"
"値として直接指定できます::"

#: ../../library/argparse.rst:964
msgid ""
"See the section on the default_ keyword argument for information on when the "
"``type`` argument is applied to default arguments."
msgstr ""
"``type`` 引数がデフォルト引数に適用されている場合の情報は、default_ キーワー"
"ド引数の節を参照してください。"

#: ../../library/argparse.rst:967
msgid ""
"To ease the use of various types of files, the argparse module provides the "
"factory FileType which takes the ``mode=`` and ``bufsize=`` arguments of the "
"``file`` object.  For example, ``FileType('w')`` can be used to create a "
"writable file::"
msgstr ""
"いろいろな種類のファイルを簡単に扱うために、 argparse モジュールは ``file`` "
"オブジェクトの ``mode=``, ``bufsize=`` 引数を取る FileType ファクトリを提供し"
"ています。例えば、書き込み可能なファイルを作るために ``FileType('w')`` を利用"
"できます::"

#: ../../library/argparse.rst:977
msgid ""
"``type=`` can take any callable that takes a single string argument and "
"returns the converted value::"
msgstr ""
"``type=`` には1つの文字列を引数に受け取って変換結果を返すような任意の呼び出し"
"可能オブジェクトを渡すことができます::"

#: ../../library/argparse.rst:996
msgid ""
"The choices_ keyword argument may be more convenient for type checkers that "
"simply check against a range of values::"
msgstr ""
"さらに、choices_ キーワード引数を使って、値の範囲をチェックすることもできま"
"す::"

#: ../../library/argparse.rst:1007
msgid "See the choices_ section for more details."
msgstr "詳細は choices_ 節を参照してください。"

#: ../../library/argparse.rst:1011
msgid "choices"
msgstr "choices"

#: ../../library/argparse.rst:1013
msgid ""
"Some command-line arguments should be selected from a restricted set of "
"values. These can be handled by passing a container object as the *choices* "
"keyword argument to :meth:`~ArgumentParser.add_argument`.  When the command "
"line is parsed, argument values will be checked, and an error message will "
"be displayed if the argument was not one of the acceptable values::"
msgstr ""
"コマンドライン引数をいくつかの選択肢の中から選ばせたい場合があります。 これ"
"は :meth:`~ArgumentParser.add_argument` に *choices* キーワード引数を渡すこと"
"で可能です。コマンドラインを解析する時、引数の値がチェックされ、その値が選択"
"肢の中に含まれていない場合はエラーメッセージを表示します::"

#: ../../library/argparse.rst:1028
msgid ""
"Note that inclusion in the *choices* container is checked after any type_ "
"conversions have been performed, so the type of the objects in the *choices* "
"container should match the type_ specified::"
msgstr ""
"*choices* コンテナーに含まれているかどうかのチェックは、type_ による型変換が "
"実行された後であることに注意してください。なので、*choices* に格納する オブ"
"ジェクトの型は指定された type_ にマッチしている必要があります::"

#: ../../library/argparse.rst:1040
msgid ""
"Any object that supports the ``in`` operator can be passed as the *choices* "
"value, so :class:`dict` objects, :class:`set` objects, custom containers, "
"etc. are all supported."
msgstr ""
"``in`` 演算をサポートしている任意のオブジェクトを *choices* に渡すことができ"
"ます。 なので、 :class:`dict`, :class:`set`, その他カスタムコンテナーなどは全"
"てサポート しています。"

#: ../../library/argparse.rst:1046
msgid "required"
msgstr "required"

#: ../../library/argparse.rst:1048
msgid ""
"In general, the :mod:`argparse` module assumes that flags like ``-f`` and "
"``--bar`` indicate *optional* arguments, which can always be omitted at the "
"command line. To make an option *required*, ``True`` can be specified for "
"the ``required=`` keyword argument to :meth:`~ArgumentParser.add_argument`::"
msgstr ""
"通常 :mod:`argparse` モジュールは、``-f`` や ``--bar`` といったフラグは *任意"
"* の引数 (オプション引数) だと仮定し、コマンドライン上になくても良いものとし"
"て扱います。フラグの指定を *必須* にするには、:meth:`~ArgumentParser."
"add_argument` の ``required=`` キーワード引数に ``True`` を指定します::"

#: ../../library/argparse.rst:1061
msgid ""
"As the example shows, if an option is marked as ``required``, :meth:"
"`~ArgumentParser.parse_args` will report an error if that option is not "
"present at the command line."
msgstr ""
"上の例のように、引数が ``required`` と指定されると、:meth:`~ArgumentParser."
"parse_args` はそのフラグがコマンドラインに存在しないときにエラーを表示しま"
"す。"

#: ../../library/argparse.rst:1067
msgid ""
"Required options are generally considered bad form because users expect "
"*options* to be *optional*, and thus they should be avoided when possible."
msgstr ""
"ユーザーは、通常 *フラグ* の指定は *任意* であると認識しているため、必須にす"
"るのは一般的には悪いやり方で、できる限り避けるべきです。"

#: ../../library/argparse.rst:1072
msgid "help"
msgstr "help"

#: ../../library/argparse.rst:1074
msgid ""
"The ``help`` value is a string containing a brief description of the "
"argument. When a user requests help (usually by using ``-h`` or ``--help`` "
"at the command line), these ``help`` descriptions will be displayed with "
"each argument::"
msgstr ""
"``help`` の値はその引数の簡潔な説明を含む文字列です。ユーザーが (コマンドライ"
"ン上で ``-h`` か ``--help`` を指定するなどして) ヘルプを要求したとき、この "
"``help`` の説明が各引数に表示されます::"

#: ../../library/argparse.rst:1094
msgid ""
"The ``help`` strings can include various format specifiers to avoid "
"repetition of things like the program name or the argument default_.  The "
"available specifiers include the program name, ``%(prog)s`` and most keyword "
"arguments to :meth:`~ArgumentParser.add_argument`, e.g. ``%(default)s``, "
"``%(type)s``, etc.::"
msgstr ""
"``help`` 文字列には、プログラム名や引数の default_ などを繰り返し記述するのを"
"避けるためのフォーマット指定子を含めることができます。利用できる指定子には、"
"プログラム名 ``%(prog)s`` と、 ``%(default)s`` や ``%(type)s`` など :meth:"
"`~ArgumentParser.add_argument` のキーワード引数の多くが含まれます::"

#: ../../library/argparse.rst:1111
msgid ""
":mod:`argparse` supports silencing the help entry for certain options, by "
"setting the ``help`` value to ``argparse.SUPPRESS``::"
msgstr ""
":mod:`argparse` は ``help`` に ``argparse.SUPPRESS`` を設定することで、特定の"
"オプションをヘルプに表示させないことができます::"

#: ../../library/argparse.rst:1124
msgid "metavar"
msgstr "metavar"

#: ../../library/argparse.rst:1126
msgid ""
"When :class:`ArgumentParser` generates help messages, it needs some way to "
"refer to each expected argument.  By default, ArgumentParser objects use the "
"dest_ value as the \"name\" of each object.  By default, for positional "
"argument actions, the dest_ value is used directly, and for optional "
"argument actions, the dest_ value is uppercased.  So, a single positional "
"argument with ``dest='bar'`` will be referred to as ``bar``. A single "
"optional argument ``--foo`` that should be followed by a single command-line "
"argument will be referred to as ``FOO``.  An example::"
msgstr ""
":class:`ArgumentParser` がヘルプメッセージを出力する時、各引数に対してなんら"
"かの 参照方法が必要です。デフォルトでは、 ArgumentParser オブジェクトは各オブ"
"ジェクトの \"名前\" として dest_ を利用します。デフォルトでは、位置引数には "
"dest_ の値をそのまま 利用し、オプション引数については dest_ の値を大文字に変"
"換して利用します。 なので、1つの ``dest='bar'`` である位置引数は ``bar`` とし"
"て参照されます。 1つのオプション引数 ``--foo`` が1つのコマンドライン引数を要"
"求するときは、その引数は ``FOO`` として参照されます。例です::"

#: ../../library/argparse.rst:1150
msgid "An alternative name can be specified with ``metavar``::"
msgstr "代わりの名前を、``metavar`` として指定できます::"

#: ../../library/argparse.rst:1167
msgid ""
"Note that ``metavar`` only changes the *displayed* name - the name of the "
"attribute on the :meth:`~ArgumentParser.parse_args` object is still "
"determined by the dest_ value."
msgstr ""
"``metavar`` は *表示される* 名前だけを変更することに注意してください。:meth:"
"`~ArgumentParser.parse_args` の返すオブジェクトの属性名は dest_ の値のままで"
"す。"

#: ../../library/argparse.rst:1171
msgid ""
"Different values of ``nargs`` may cause the metavar to be used multiple "
"times. Providing a tuple to ``metavar`` specifies a different display for "
"each of the arguments::"
msgstr ""
"``nargs`` を指定した場合、metavar が複数回利用されるかもしれません。"
"``metavar`` にタプルを渡すと、各引数に対して異なる名前を指定できます::"

#: ../../library/argparse.rst:1188
msgid "dest"
msgstr "dest"

#: ../../library/argparse.rst:1190
msgid ""
"Most :class:`ArgumentParser` actions add some value as an attribute of the "
"object returned by :meth:`~ArgumentParser.parse_args`.  The name of this "
"attribute is determined by the ``dest`` keyword argument of :meth:"
"`~ArgumentParser.add_argument`.  For positional argument actions, ``dest`` "
"is normally supplied as the first argument to :meth:`~ArgumentParser."
"add_argument`::"
msgstr ""
"ほとんどの :class:`ArgumentParser` のアクションは :meth:`~ArgumentParser."
"parse_args` が返すオブジェクトに対する属性として値を追加します。この属性の名"
"前は :meth:`~ArgumentParser.add_argument` の ``dest`` キーワード引数によって"
"決定されます。位置引数のアクションについては、 ``dest`` は通常 :meth:"
"`~ArgumentParser.add_argument` の第一引数として渡します::"

#: ../../library/argparse.rst:1202
msgid ""
"For optional argument actions, the value of ``dest`` is normally inferred "
"from the option strings.  :class:`ArgumentParser` generates the value of "
"``dest`` by taking the first long option string and stripping away the "
"initial ``--`` string.  If no long option strings were supplied, ``dest`` "
"will be derived from the first short option string by stripping the initial "
"``-`` character.  Any internal ``-`` characters will be converted to ``_`` "
"characters to make sure the string is a valid attribute name.  The examples "
"below illustrate this behavior::"
msgstr ""
"オプション引数のアクションについては、 ``dest`` の値は通常オプション文字列か"
"ら生成されます。 :class:`ArgumentParser` は最初の長いオプション文字列を選択"
"し、先頭の ``--`` を除去することで ``dest`` の値を生成します。長いオプション"
"文字列が指定されていない場合、最初の短いオプション文字列から先頭の ``-`` 文字"
"を除去することで ``dest`` を生成します。先頭以外のすべての ``-`` 文字は、妥当"
"な属性名になるように ``_`` 文字へ変換されます。次の例はこの動作を示していま"
"す::"

#: ../../library/argparse.rst:1219
msgid "``dest`` allows a custom attribute name to be provided::"
msgstr "``dest`` にカスタムの属性名を与えることも可能です::"

#: ../../library/argparse.rst:1227
msgid "Action classes"
msgstr "Action クラス"

#: ../../library/argparse.rst:1229
msgid ""
"Action classes implement the Action API, a callable which returns a callable "
"which processes arguments from the command-line. Any object which follows "
"this API may be passed as the ``action`` parameter to :meth:`add_argument`."
msgstr ""
"Acrtion クラスは Action API、すなわちコマンドラインからの引数を処理する呼び出"
"し可能オブジェクトを返す呼び出し可能オブジェクトを実装します。この API に従う"
"あらゆるオブジェクトは ``action`` 引数として :meth:`add_argument` に渡すこと"
"が出来ます。"

#: ../../library/argparse.rst:1237
msgid ""
"Action objects are used by an ArgumentParser to represent the information "
"needed to parse a single argument from one or more strings from the command "
"line. The Action class must accept the two positional arguments plus any "
"keyword arguments passed to :meth:`ArgumentParser.add_argument` except for "
"the ``action`` itself."
msgstr ""
"Action オブジェクトは、コマンドラインからの一つ以上の文字列から単一の引数を解"
"析するのに必要とされる情報を表現するために、ArgumentParser によって使われま"
"す。Action クラス 2 つの位置引数と、 ``action`` それ自身を除く :meth:"
"`ArgumentParser.add_argument` に渡される全てのキーワード引数を受け付けなけれ"
"ばなりません。"

#: ../../library/argparse.rst:1242
msgid ""
"Instances of Action (or return value of any callable to the ``action`` "
"parameter) should have attributes \"dest\", \"option_strings\", \"default\", "
"\"type\", \"required\", \"help\", etc. defined. The easiest way to ensure "
"these attributes are defined is to call ``Action.__init__``."
msgstr ""
"Action のインスタンス(あるいは ``action`` パラメータも渡す任意の callable の"
"返却値)は、属性 \"dest\", \"option_strings\", \"default\", \"type\", "
"\"required\", \"help\", などを定義しなければなりません。これらの属性を定義す"
"るのを確実にするために最も簡単な方法は、 ``Action.__init__`` を呼び出すことで"
"す。"

#: ../../library/argparse.rst:1247
msgid ""
"Action instances should be callable, so subclasses must override the "
"``__call__`` method, which should accept four parameters:"
msgstr ""
"Action インスタンスは callable でなければならず、従って、サブクラスは 4つの引"
"数を受け取る ``__call__`` メソッドをオーバライドしなければなりません:"

#: ../../library/argparse.rst:1250
msgid "``parser`` - The ArgumentParser object which contains this action."
msgstr "``parser`` - このアクションを持っている ArgumentParser オブジェクト。"

#: ../../library/argparse.rst:1252
msgid ""
"``namespace`` - The :class:`Namespace` object that will be returned by :meth:"
"`~ArgumentParser.parse_args`.  Most actions add an attribute to this object "
"using :func:`setattr`."
msgstr ""
"``namespace`` - :meth:`~ArgumentParser.parse_args` が返す :class:`Namespace` "
"オブジェクト。ほとんどのアクションはこのオブジェクトに属性を :func:`setattr` "
"を使って追加します。"

#: ../../library/argparse.rst:1256
msgid ""
"``values`` - The associated command-line arguments, with any type "
"conversions applied.  Type conversions are specified with the type_ keyword "
"argument to :meth:`~ArgumentParser.add_argument`."
msgstr ""
"``values`` - 型変換が適用された後の、関連付けられたコマンドライン引数。型変換"
"は :meth:`~ArgumentParser.add_argument` メソッドの type_ キーワード引数で指定"
"されます。"

#: ../../library/argparse.rst:1260
msgid ""
"``option_string`` - The option string that was used to invoke this action. "
"The ``option_string`` argument is optional, and will be absent if the action "
"is associated with a positional argument."
msgstr ""
"``option_string`` - このアクションを実行したオプション文字列。"
"``option_string`` 引数はオプションで、アクションが位置引数に関連付けられた場"
"合は渡されません。"

#: ../../library/argparse.rst:1264
msgid ""
"The ``__call__`` method may perform arbitrary actions, but will typically "
"set attributes on the ``namespace`` based on ``dest`` and ``values``."
msgstr ""
"``__call__`` メソッドでは任意のアクションを行えますが、 典型的にはそれは "
"``dest``, ``values`` に基づく ``namespace`` に属性をセットすることでしょう。"

#: ../../library/argparse.rst:1269
msgid "The parse_args() method"
msgstr "parse_args() メソッド"

#: ../../library/argparse.rst:1273
msgid ""
"Convert argument strings to objects and assign them as attributes of the "
"namespace.  Return the populated namespace."
msgstr ""
"引数の文字列をオブジェクトに変換し、namespace オブジェクトの属性に代入しま"
"す。結果の namespace オブジェクトを返します。"

#: ../../library/argparse.rst:1276
msgid ""
"Previous calls to :meth:`add_argument` determine exactly what objects are "
"created and how they are assigned. See the documentation for :meth:"
"`add_argument` for details."
msgstr ""
"事前の :meth:`add_argument` メソッドの呼び出しが、どのオブジェクトが生成され"
"てどう代入されるかを決定します。詳細は :meth:`add_argument` のドキュメントを"
"参照してください。"

#: ../../library/argparse.rst:1280
msgid ""
"args_ - List of strings to parse.  The default is taken from :data:`sys."
"argv`."
msgstr ""
"args_ - 解析する文字列のリスト。デフォルトでは :data:`sys.argv` から取得され"
"ます。"

#: ../../library/argparse.rst:1283
msgid ""
"namespace_ - An object to take the attributes.  The default is a new empty :"
"class:`Namespace` object."
msgstr ""
"namespace_ - 属性を代入するオブジェクト。デフォルトでは、新しい空の :class:"
"`Namespace` オブジェクトです。"

#: ../../library/argparse.rst:1288
msgid "Option value syntax"
msgstr "オプション値の文法"

#: ../../library/argparse.rst:1290
msgid ""
"The :meth:`~ArgumentParser.parse_args` method supports several ways of "
"specifying the value of an option (if it takes one).  In the simplest case, "
"the option and its value are passed as two separate arguments::"
msgstr ""
":meth:`~ArgumentParser.parse_args` メソッドはオプションの値があればそれを指定"
"する複数の方法をサポートしています。一番シンプルな方法は、オプションとその値"
"は2つの別々の引数として渡されます::"

#: ../../library/argparse.rst:1302
msgid ""
"For long options (options with names longer than a single character), the "
"option and value can also be passed as a single command-line argument, using "
"``=`` to separate them::"
msgstr ""
"長いオプション (1文字よりも長い名前を持ったオプション) では、オプションとその"
"値は ``=`` で区切られた1つのコマンドライン引数として渡すこともできます::"

#: ../../library/argparse.rst:1309
msgid ""
"For short options (options only one character long), the option and its "
"value can be concatenated::"
msgstr ""
"短いオプション (1文字のオプション) では、オプションとその値は連結して渡すこと"
"ができます::"

#: ../../library/argparse.rst:1315
msgid ""
"Several short options can be joined together, using only a single ``-`` "
"prefix, as long as only the last option (or none of them) requires a value::"
msgstr ""
"複数の短いオプションは、最後の1つ (か、0個) のオプションだけが値を要求する場"
"合には、1つの接頭辞 ``-`` だけで連結できます::"

#: ../../library/argparse.rst:1327
msgid "Invalid arguments"
msgstr "不正な引数"

#: ../../library/argparse.rst:1329
msgid ""
"While parsing the command line, :meth:`~ArgumentParser.parse_args` checks "
"for a variety of errors, including ambiguous options, invalid types, invalid "
"options, wrong number of positional arguments, etc.  When it encounters such "
"an error, it exits and prints the error along with a usage message::"
msgstr ""
":meth:`~ArgumentParser.parse_args` は、コマンドラインの解析中に、曖昧なオプ"
"ション、不正な型、不正なオプション、位置引数の数の不一致などのエラーを検証し"
"ます。それらのエラーが発生した場合、エラーメッセージと使用法メッセージを表示"
"して終了します::"

#: ../../library/argparse.rst:1355
msgid "Arguments containing ``-``"
msgstr "``-`` を含む引数"

#: ../../library/argparse.rst:1357
msgid ""
"The :meth:`~ArgumentParser.parse_args` method attempts to give errors "
"whenever the user has clearly made a mistake, but some situations are "
"inherently ambiguous.  For example, the command-line argument ``-1`` could "
"either be an attempt to specify an option or an attempt to provide a "
"positional argument. The :meth:`~ArgumentParser.parse_args` method is "
"cautious here: positional arguments may only begin with ``-`` if they look "
"like negative numbers and there are no options in the parser that look like "
"negative numbers::"
msgstr ""
":meth:`~ArgumentParser.parse_args` メソッドは、ユーザーが明らかなミスをした場"
"合はエラーを表示しますが、いくつか本質的に曖昧な場面があります。例えば、コマ"
"ンドライン引数 ``-1`` は、オプションの指定かもしれませんし位置引数かもしれま"
"せん。:meth:`~ArgumentParser.parse_args` メソッドはこれを次のように扱います: "
"負の数として解釈でき、パーサーに負の数のように解釈できるオプションが存在しな"
"い場合にのみ、``-`` で始まる位置引数になりえます::"

#: ../../library/argparse.rst:1395
msgid ""
"If you have positional arguments that must begin with ``-`` and don't look "
"like negative numbers, you can insert the pseudo-argument ``'--'`` which "
"tells :meth:`~ArgumentParser.parse_args` that everything after that is a "
"positional argument::"
msgstr ""
"``-`` で始まる位置引数があって、それが負の数として解釈できない場合、ダミーの"
"引数 ``'--'`` を挿入して、:meth:`~ArgumentParser.parse_args` にそれ以降のすべ"
"てが位置引数だと教えることができます::"

#: ../../library/argparse.rst:1406
msgid "Argument abbreviations (prefix matching)"
msgstr "引数の短縮形 (先頭文字でのマッチング)"

#: ../../library/argparse.rst:1408
msgid ""
"The :meth:`~ArgumentParser.parse_args` method allows long options to be "
"abbreviated to a prefix, if the abbreviation is unambiguous (the prefix "
"matches a unique option)::"
msgstr ""
":meth:`~ArgumentParser.parse_args` メソッドでは長いオプションを曖昧さがない範"
"囲 (先頭の文字が一意であること) で短縮できます::"

#: ../../library/argparse.rst:1423
msgid ""
"An error is produced for arguments that could produce more than one options."
msgstr "引数が複数のオプションになり得る場合はエラーになります。"

#: ../../library/argparse.rst:1428
msgid "Beyond ``sys.argv``"
msgstr "``sys.argv`` 以外"

#: ../../library/argparse.rst:1430
msgid ""
"Sometimes it may be useful to have an ArgumentParser parse arguments other "
"than those of :data:`sys.argv`.  This can be accomplished by passing a list "
"of strings to :meth:`~ArgumentParser.parse_args`.  This is useful for "
"testing at the interactive prompt::"
msgstr ""
"ArgumentParser が :data:`sys.argv` 以外の引数を解析できると役に立つ場合があり"
"ます。その場合は文字列のリストを :meth:`~ArgumentParser.parse_args` に渡しま"
"す。これはインタラクティブプロンプトからテストするときに便利です::"

#: ../../library/argparse.rst:1450
msgid "The Namespace object"
msgstr "Namespace オブジェクト"

#: ../../library/argparse.rst:1454
msgid ""
"Simple class used by default by :meth:`~ArgumentParser.parse_args` to create "
"an object holding attributes and return it."
msgstr ""
":meth:`~ArgumentParser.parse_args` が属性を格納して返すためのオブジェクトにデ"
"フォルトで使用されるシンプルなクラスです。"

#: ../../library/argparse.rst:1457
msgid ""
"This class is deliberately simple, just an :class:`object` subclass with a "
"readable string representation. If you prefer to have dict-like view of the "
"attributes, you can use the standard Python idiom, :func:`vars`::"
msgstr ""
"デフォルトでは、 :meth:`~ArgumentParser.parse_args` は :class:`Namespace` の"
"新しいオブジェクトに必要な属性を設定して返します。このクラスはシンプルに設計"
"されており、単に読みやすい文字列表現を持った :class:`object` のサブクラスで"
"す。もし属性を辞書のように扱える方が良ければ、標準的な Python のイディオム :"
"func:`vars` を利用できます::"

#: ../../library/argparse.rst:1467
msgid ""
"It may also be useful to have an :class:`ArgumentParser` assign attributes "
"to an already existing object, rather than a new :class:`Namespace` object.  "
"This can be achieved by specifying the ``namespace=`` keyword argument::"
msgstr ""
":class:`ArgumentParser` が、新しい :class:`Namespace` オブジェクトではなく、"
"既存のオブジェクトに属性を設定する方が良い場合があります。これは "
"``namespace=`` キーワード引数を指定することで可能です::"

#: ../../library/argparse.rst:1483
msgid "Other utilities"
msgstr "その他のユーティリティ"

#: ../../library/argparse.rst:1486
msgid "Sub-commands"
msgstr "サブコマンド"

#: ../../library/argparse.rst:1493
msgid ""
"Many programs split up their functionality into a number of sub-commands, "
"for example, the ``svn`` program can invoke sub-commands like ``svn "
"checkout``, ``svn update``, and ``svn commit``.  Splitting up functionality "
"this way can be a particularly good idea when a program performs several "
"different functions which require different kinds of command-line "
"arguments. :class:`ArgumentParser` supports the creation of such sub-"
"commands with the :meth:`add_subparsers` method.  The :meth:`add_subparsers` "
"method is normally called with no arguments and returns a special action "
"object.  This object has a single method, :meth:`~ArgumentParser."
"add_parser`, which takes a command name and any :class:`ArgumentParser` "
"constructor arguments, and returns an :class:`ArgumentParser` object that "
"can be modified as usual."
msgstr ""
"多くのプログラムは、その機能をサブコマンドへと分割します。 例えば ``svn`` プ"
"ログラムは ``svn checkout``, ``svn update``, ``svn commit`` などのサブコマン"
"ドを利用できます。 機能をサブコマンドに分割するのは、プログラムがいくつかの異"
"なった機能を持っていて、 それぞれが異なるコマンドライン引数を必要とする場合に"
"は良いアイデアです。 :class:`ArgumentParser` は :meth:`add_subparsers` メソッ"
"ドによりサブコマンドを サポートしています。 :meth:`add_subparsers` メソッドは"
"通常引数なしに呼び出され、 特殊なアクションオブジェクトを返します。このオブ"
"ジェクトには1つのメソッド :meth:`~ArgumentParser.add_parser` があり、コマンド"
"名と :class:`ArgumentParser` コンストラクターの任意の引数を受け取り、通常の方"
"法で操作できる :class:`ArgumentParser` オブジェクトを返します。"

#: ../../library/argparse.rst:1505
msgid "Description of parameters:"
msgstr "パラメーターの説明:"

#: ../../library/argparse.rst:1507
msgid ""
"title - title for the sub-parser group in help output; by default "
"\"subcommands\" if description is provided, otherwise uses title for "
"positional arguments"
msgstr ""
"title - ヘルプ出力でのサブパーサーグループのタイトル; デフォルトは、"
"description が指定されている場合は \"subcommands\" に、指定されていない場合は"
"位置引数のタイトルになります"

#: ../../library/argparse.rst:1511
msgid ""
"description - description for the sub-parser group in help output, by "
"default ``None``"
msgstr ""
"description - ヘルプ出力に表示されるサブパーサーグループの説明です。デフォル"
"トは ``None`` になります"

#: ../../library/argparse.rst:1514
msgid ""
"prog - usage information that will be displayed with sub-command help, by "
"default the name of the program and any positional arguments before the "
"subparser argument"
msgstr ""
"prog - サブコマンドのヘルプに表示される使用方法の説明です。デフォルトではプロ"
"グラム名と位置引数の後ろに、サブパーサーの引数が続きます"

#: ../../library/argparse.rst:1518
msgid ""
"parser_class - class which will be used to create sub-parser instances, by "
"default the class of the current parser (e.g. ArgumentParser)"
msgstr ""
"parser_class - サブパーサーのインスタンスを作成する時に使用されるクラスです。"
"デフォルトでは現在のパーサーのクラス (例: ArgumentParser) になります"

#: ../../library/argparse.rst:1521
msgid ""
"action_ - the basic type of action to be taken when this argument is "
"encountered at the command line"
msgstr "action_ - コマンドラインにこの引数があった時の基本のアクション。"

#: ../../library/argparse.rst:1524
msgid ""
"dest_ - name of the attribute under which sub-command name will be stored; "
"by default ``None`` and no value is stored"
msgstr ""
"dest_ - サブコマンド名を格納する属性の名前です。デフォルトは ``None`` で値は"
"格納されません"

#: ../../library/argparse.rst:1527
msgid "help_ - help for sub-parser group in help output, by default ``None``"
msgstr ""
"help_ - ヘルプ出力に表示されるサブパーサーグループのヘルプです。デフォルトは "
"``None`` です"

#: ../../library/argparse.rst:1529
msgid ""
"metavar_ - string presenting available sub-commands in help; by default it "
"is ``None`` and presents sub-commands in form {cmd1, cmd2, ..}"
msgstr ""
"metavar_ - 利用可能なサブコマンドをヘルプ内で表示するための文字列です。デフォ"
"ルトは ``None`` で、サブコマンドを {cmd1, cmd2, ..} のような形式で表します"

#: ../../library/argparse.rst:1532
msgid "Some example usage::"
msgstr "いくつかの使用例::"

#: ../../library/argparse.rst:1553
msgid ""
"Note that the object returned by :meth:`parse_args` will only contain "
"attributes for the main parser and the subparser that was selected by the "
"command line (and not any other subparsers).  So in the example above, when "
"the ``a`` command is specified, only the ``foo`` and ``bar`` attributes are "
"present, and when the ``b`` command is specified, only the ``foo`` and "
"``baz`` attributes are present."
msgstr ""
":meth:`parse_args` が返すオブジェクトにはメインパーサーとコマンドラインで選択"
"されたサブパーサーによる属性だけが設定されており、選択されなかったサブコマン"
"ドのパーサーの属性が設定されていないことに注意してください。なので、上の例で"
"は、``a`` コマンドが指定されたときは ``foo``, ``bar`` 属性だけが存在し、"
"``b`` コマンドが指定されたときは ``foo``, ``baz`` 属性だけが存在しています。"

#: ../../library/argparse.rst:1560
msgid ""
"Similarly, when a help message is requested from a subparser, only the help "
"for that particular parser will be printed.  The help message will not "
"include parent parser or sibling parser messages.  (A help message for each "
"subparser command, however, can be given by supplying the ``help=`` argument "
"to :meth:`add_parser` as above.)"
msgstr ""
"同じように、サブパーサーにヘルプメッセージが要求された場合は、そのパーサーに"
"対するヘルプだけが表示されます。ヘルプメッセージには親パーサーや兄弟パーサー"
"のヘルプメッセージを表示しません。 (ただし、各サブパーサーコマンドのヘルプ"
"メッセージは、上の例にもあるように :meth:`add_parser` の ``help=`` 引数によっ"
"て指定できます)"

#: ../../library/argparse.rst:1596
msgid ""
"The :meth:`add_subparsers` method also supports ``title`` and "
"``description`` keyword arguments.  When either is present, the subparser's "
"commands will appear in their own group in the help output.  For example::"
msgstr ""
":meth:`add_subparsers` メソッドは ``title`` と ``description`` キーワード引数"
"もサポートしています。どちらかが存在する場合、サブパーサーのコマンドはヘルプ"
"出力でそれぞれのグループの中に表示されます。例えば::"

#: ../../library/argparse.rst:1618
msgid ""
"One particularly effective way of handling sub-commands is to combine the "
"use of the :meth:`add_subparsers` method with calls to :meth:`set_defaults` "
"so that each subparser knows which Python function it should execute.  For "
"example::"
msgstr ""
"サブコマンドを扱う1つの便利な方法は :meth:`add_subparsers` メソッドと :meth:"
"`set_defaults` を組み合わせて、各サブパーサーにどの Python 関数を実行するかを"
"教えることです。例えば::"

#: ../../library/argparse.rst:1655
msgid ""
"This way, you can let :meth:`parse_args` do the job of calling the "
"appropriate function after argument parsing is complete.  Associating "
"functions with actions like this is typically the easiest way to handle the "
"different actions for each of your subparsers.  However, if it is necessary "
"to check the name of the subparser that was invoked, the ``dest`` keyword "
"argument to the :meth:`add_subparsers` call will work::"
msgstr ""
"こうすると、 :meth:`parse_args` が引数の解析が終わってから適切な関数を呼び出"
"すようになります。このように関数をアクションに関連付けるのは大抵サブパーサー"
"ごとに異なるアクションを扱う最も簡単な方法です。ただし、実行されたサブパー"
"サーの名前を確認する必要がある場合は、 :meth:`add_subparsers` を呼び出すとき"
"に ``dest`` キーワードを指定できます::"

#: ../../library/argparse.rst:1673
msgid "FileType objects"
msgstr "FileType オブジェクト"

#: ../../library/argparse.rst:1677
msgid ""
"The :class:`FileType` factory creates objects that can be passed to the type "
"argument of :meth:`ArgumentParser.add_argument`.  Arguments that have :class:"
"`FileType` objects as their type will open command-line arguments as files "
"with the requested modes and buffer sizes::"
msgstr ""
":class:`FileType` ファクトリは :meth:`ArgumentParser.add_argument` の type 引"
"数に渡すことができるオブジェクトを生成します。 type が :class:`FileType` オブ"
"ジェクトである引数はコマンドライン引数を、指定されたモード、バッファーサイズ"
"でファイルとして開きます::"

#: ../../library/argparse.rst:1687
msgid ""
"FileType objects understand the pseudo-argument ``'-'`` and automatically "
"convert this into ``sys.stdin`` for readable :class:`FileType` objects and "
"``sys.stdout`` for writable :class:`FileType` objects::"
msgstr ""
"FileType オブジェクトは擬似引数 ``'-'`` を識別し、読み込み用の :class:"
"`FileType` であれば ``sys.stdin`` を、書き込み用の :class:`FileType` であれ"
"ば ``sys.stdout`` に変換します::"

#: ../../library/argparse.rst:1698
msgid "Argument groups"
msgstr "引数グループ"

#: ../../library/argparse.rst:1702
msgid ""
"By default, :class:`ArgumentParser` groups command-line arguments into "
"\"positional arguments\" and \"optional arguments\" when displaying help "
"messages. When there is a better conceptual grouping of arguments than this "
"default one, appropriate groups can be created using the :meth:"
"`add_argument_group` method::"
msgstr ""
"デフォルトでは、 :class:`ArgumentParser` はヘルプメッセージを表示するときに、"
"コマンドライン引数を \"位置引数\" と \"オプション引数\" にグループ化します。"
"このデフォルトの動作よりも良い引数のグループ化方法がある場合、 :meth:"
"`add_argument_group` メソッドで適切なグループを作成できます::"

#: ../../library/argparse.rst:1719
msgid ""
"The :meth:`add_argument_group` method returns an argument group object which "
"has an :meth:`~ArgumentParser.add_argument` method just like a regular :"
"class:`ArgumentParser`.  When an argument is added to the group, the parser "
"treats it just like a normal argument, but displays the argument in a "
"separate group for help messages.  The :meth:`add_argument_group` method "
"accepts *title* and *description* arguments which can be used to customize "
"this display::"
msgstr ""
":meth:`add_argument_group` メソッドは、通常の :class:`ArgumentParser` と同じ"
"ような :meth:`~ArgumentParser.add_argument` メソッドを持つ引数グループオブ"
"ジェクトを返します。引数がグループに追加された時、パーサーはその引数を通常の"
"引数のように扱いますが、ヘルプメッセージではその引数を分離されたグループの中"
"に表示します。 :meth:`add_argument_group` メソッドには、この表示をカスタマイ"
"ズするための *title* と *description* 引数があります::"

#: ../../library/argparse.rst:1745
msgid ""
"Note that any arguments not in your user-defined groups will end up back in "
"the usual \"positional arguments\" and \"optional arguments\" sections."
msgstr ""
"ユーザー定義グループにないすべての引数は通常の \"位置引数\" と \"オプション引"
"数\" セクションに表示されます。"

#: ../../library/argparse.rst:1750
msgid "Mutual exclusion"
msgstr "相互排他"

#: ../../library/argparse.rst:1754
msgid ""
"Create a mutually exclusive group. :mod:`argparse` will make sure that only "
"one of the arguments in the mutually exclusive group was present on the "
"command line::"
msgstr ""
"相互排他グループを作ります。:mod:`argparse` は相互排他グループの中でただ1つの"
"引数のみが存在することを確認します::"

#: ../../library/argparse.rst:1770
msgid ""
"The :meth:`add_mutually_exclusive_group` method also accepts a *required* "
"argument, to indicate that at least one of the mutually exclusive arguments "
"is required::"
msgstr ""
":meth:`add_mutually_exclusive_group` メソッドの引数 *required* に True 値を指"
"定すると、その相互排他引数のどれか 1つを選ぶことが要求さます::"

#: ../../library/argparse.rst:1782
msgid ""
"Note that currently mutually exclusive argument groups do not support the "
"*title* and *description* arguments of :meth:`~ArgumentParser."
"add_argument_group`."
msgstr ""
"現在のところ、相互排他引数グループは :meth:`~ArgumentParser."
"add_argument_group` の *title* と *description* 引数をサポートしていません。"

#: ../../library/argparse.rst:1788
msgid "Parser defaults"
msgstr "パーサーのデフォルト値"

#: ../../library/argparse.rst:1792
msgid ""
"Most of the time, the attributes of the object returned by :meth:"
"`parse_args` will be fully determined by inspecting the command-line "
"arguments and the argument actions.  :meth:`set_defaults` allows some "
"additional attributes that are determined without any inspection of the "
"command line to be added::"
msgstr ""
"ほとんどの場合、 :meth:`parse_args` が返すオブジェクトの属性はコマンドライン"
"引数の内容と引数のアクションによってのみ決定されます。 :meth:`set_defaults` "
"を使うと与えられたコマンドライン引数の内容によらず追加の属性を決定することが"
"可能です::"

#: ../../library/argparse.rst:1804
msgid ""
"Note that parser-level defaults always override argument-level defaults::"
msgstr ""
"パーサーレベルのデフォルト値は常に引数レベルのデフォルト値を上書きします::"

#: ../../library/argparse.rst:1812
msgid ""
"Parser-level defaults can be particularly useful when working with multiple "
"parsers.  See the :meth:`~ArgumentParser.add_subparsers` method for an "
"example of this type."
msgstr ""
"パーサーレベルの default は、複数のパーサーを扱うときに特に便利です。このタイ"
"プの例については :meth:`~ArgumentParser.add_subparsers` メソッドを参照してく"
"ださい。"

#: ../../library/argparse.rst:1818
msgid ""
"Get the default value for a namespace attribute, as set by either :meth:"
"`~ArgumentParser.add_argument` or by :meth:`~ArgumentParser.set_defaults`::"
msgstr ""
":meth:`~ArgumentParser.add_argument` か :meth:`~ArgumentParser.set_defaults` "
"によって指定された、 namespace の属性のデフォルト値を取得します::"

#: ../../library/argparse.rst:1829
msgid "Printing help"
msgstr "ヘルプの表示"

#: ../../library/argparse.rst:1831
msgid ""
"In most typical applications, :meth:`~ArgumentParser.parse_args` will take "
"care of formatting and printing any usage or error messages.  However, "
"several formatting methods are available:"
msgstr ""
"ほとんどの典型的なアプリケーションでは、:meth:`~ArgumentParser.parse_args` が"
"使用法やエラーメッセージのフォーマットと表示について面倒を見ます。しかし、い"
"くつかのフォーマットメソッドが利用できます:"

#: ../../library/argparse.rst:1837
msgid ""
"Print a brief description of how the :class:`ArgumentParser` should be "
"invoked on the command line.  If *file* is ``None``, :data:`sys.stdout` is "
"assumed."
msgstr ""
":class:`ArgumentParser` がコマンドラインからどう実行されるべきかの短い説明を"
"表示します。 *file* が ``None`` の時は、 :data:`sys.stdout` に出力されます。"

#: ../../library/argparse.rst:1843
msgid ""
"Print a help message, including the program usage and information about the "
"arguments registered with the :class:`ArgumentParser`.  If *file* is "
"``None``, :data:`sys.stdout` is assumed."
msgstr ""
"プログラムの使用法と :class:`ArgumentParser` に登録された引数についての情報を"
"含むヘルプメッセージを表示します。 *file* が ``None`` の時は、 :data:`sys."
"stdout` に出力されます。"

#: ../../library/argparse.rst:1847
msgid ""
"There are also variants of these methods that simply return a string instead "
"of printing it:"
msgstr ""
"これらのメソッドの、表示する代わりにシンプルに文字列を返すバージョンもありま"
"す:"

#: ../../library/argparse.rst:1852
msgid ""
"Return a string containing a brief description of how the :class:"
"`ArgumentParser` should be invoked on the command line."
msgstr ""
":class:`ArgumentParser` がコマンドラインからどう実行されるべきかの短い説明を"
"格納した文字列を返します。"

#: ../../library/argparse.rst:1857
msgid ""
"Return a string containing a help message, including the program usage and "
"information about the arguments registered with the :class:`ArgumentParser`."
msgstr ""
"プログラムの使用法と :class:`ArgumentParser` に登録された引数についての情報を"
"含むヘルプメッセージを格納した文字列を返します。"

#: ../../library/argparse.rst:1862
msgid "Partial parsing"
msgstr "部分解析"

#: ../../library/argparse.rst:1866
msgid ""
"Sometimes a script may only parse a few of the command-line arguments, "
"passing the remaining arguments on to another script or program. In these "
"cases, the :meth:`~ArgumentParser.parse_known_args` method can be useful.  "
"It works much like :meth:`~ArgumentParser.parse_args` except that it does "
"not produce an error when extra arguments are present.  Instead, it returns "
"a two item tuple containing the populated namespace and the list of "
"remaining argument strings."
msgstr ""
"ときどき、スクリプトがコマンドライン引数のいくつかだけを解析し、残りの引数は"
"別のスクリプトやプログラムに渡すことがあります。こういった場合、 :meth:"
"`~ArgumentParser.parse_known_args` メソッドが便利です。これは :meth:"
"`~ArgumentParser.parse_args` と同じように動作しますが、余分な引数が存在しても"
"エラーを生成しません。代わりに、評価された namespace オブジェクトと、残りの引"
"数文字列のリストからなる2要素タプルを返します。"

#: ../../library/argparse.rst:1882
msgid ""
":ref:`Prefix matching <prefix-matching>` rules apply to :meth:"
"`parse_known_args`. The parser may consume an option even if it's just a "
"prefix of one of its known options, instead of leaving it in the remaining "
"arguments list."
msgstr ""
":ref:`先頭文字でのマッチング <prefix-matching>` ルールは :meth:"
"`parse_known_args` にも適用されます。パーサーはそれが既知のオプションの先頭文"
"字の一つであった場合、それを引数リストに残さず 1 個のオプションの消費とする場"
"合があります。"

#: ../../library/argparse.rst:1889
msgid "Customizing file parsing"
msgstr "ファイル解析のカスタマイズ"

#: ../../library/argparse.rst:1893
msgid ""
"Arguments that are read from a file (see the *fromfile_prefix_chars* keyword "
"argument to the :class:`ArgumentParser` constructor) are read one argument "
"per line. :meth:`convert_arg_line_to_args` can be overridden for fancier "
"reading."
msgstr ""
"ファイルから引数を読み込む場合 (:class:`ArgumentParser` コンストラクターの "
"*fromfile_prefix_chars* キーワード引数を参照)、1行につき1つの引数を読み込みま"
"す。 :meth:`convert_arg_line_to_args` を変更することでこの動作をカスタマイズ"
"できます。"

#: ../../library/argparse.rst:1898
msgid ""
"This method takes a single argument *arg_line* which is a string read from "
"the argument file.  It returns a list of arguments parsed from this string. "
"The method is called once per line read from the argument file, in order."
msgstr ""
"このメソッドは、引数ファイルから読まれた文字列である1つの引数 *arg_line* を受"
"け取ります。そしてその文字列を解析した結果の引数のリストを返します。このメ"
"ソッドはファイルから1行読みこむごとに、順番に呼ばれます。"

#: ../../library/argparse.rst:1902
msgid ""
"A useful override of this method is one that treats each space-separated "
"word as an argument::"
msgstr ""
"このメソッドを上書きする便利な例として、スペースで区切られた単語を 1 つの引数"
"として扱います::"

#: ../../library/argparse.rst:1910
msgid "Exiting methods"
msgstr "終了メソッド"

#: ../../library/argparse.rst:1914
msgid ""
"This method terminates the program, exiting with the specified *status* and, "
"if given, it prints a *message* before that."
msgstr ""
"このメソッドは、*message* が指定されていればそれを表示した後、指定された終了"
"ステータス *status* でプログラムを終了します。"

#: ../../library/argparse.rst:1919
msgid ""
"This method prints a usage message including the *message* to the standard "
"error and terminates the program with a status code of 2."
msgstr ""
"このメソッドは *message* を含む使用法メッセージを標準エラーに表示して、終了ス"
"テータス 2 でプログラムを終了します。"

#: ../../library/argparse.rst:1926
msgid "Upgrading optparse code"
msgstr "optparse からのアップグレード"

#: ../../library/argparse.rst:1928
msgid ""
"Originally, the :mod:`argparse` module had attempted to maintain "
"compatibility with :mod:`optparse`.  However, :mod:`optparse` was difficult "
"to extend transparently, particularly with the changes required to support "
"the new ``nargs=`` specifiers and better usage messages.  When most "
"everything in :mod:`optparse` had either been copy-pasted over or monkey-"
"patched, it no longer seemed practical to try to maintain the backwards "
"compatibility."
msgstr ""
"もともと、:mod:`argparse` モジュールは :mod:`optparse` モジュールとの互換性を"
"保って開発しようと試みられました。しかし、特に新しい ``nargs=`` 指定子とより"
"良い使用法メッセージのために必要な変更のために、:mod:`optparse` を透過的に拡"
"張することは難しかったのです。:mod:`optparse` のほとんどすべてがコピーアンド"
"ペーストされたりモンキーパッチを当てられたりしたとき、もはや後方互換性を保と"
"うとすることは現実的ではありませんでした。"

#: ../../library/argparse.rst:1935
msgid ""
"The :mod:`argparse` module improves on the standard library :mod:`optparse` "
"module in a number of ways including:"
msgstr ""
":mod:`argparse` モジュールは標準ライブラリ :mod:`optparse` モジュールを、以下"
"を含むたくさんの方法で改善しています:"

#: ../../library/argparse.rst:1938
msgid "Handling positional arguments."
msgstr "位置指定引数を扱う"

#: ../../library/argparse.rst:1939
msgid "Supporting sub-commands."
msgstr "サブコマンドのサポート"

#: ../../library/argparse.rst:1940
msgid "Allowing alternative option prefixes like ``+`` and ``/``."
msgstr "``+``, ``/`` のような代替オプションプレフィクスを許容する"

#: ../../library/argparse.rst:1941
msgid "Handling zero-or-more and one-or-more style arguments."
msgstr "zero-or-more スタイル、one-or-more スタイルの引数を扱う"

#: ../../library/argparse.rst:1942
msgid "Producing more informative usage messages."
msgstr "より有益な使用方法メッセージの生成"

#: ../../library/argparse.rst:1943
msgid "Providing a much simpler interface for custom ``type`` and ``action``."
msgstr ""
"カスタム ``type``, カスタム ``action`` のために遥かに簡単なインターフェイスを"
"提供する"

#: ../../library/argparse.rst:1945
msgid "A partial upgrade path from :mod:`optparse` to :mod:`argparse`:"
msgstr ":mod:`optparse` から :mod:`argparse` への現実的なアップグレードパス:"

#: ../../library/argparse.rst:1947
msgid ""
"Replace all :meth:`optparse.OptionParser.add_option` calls with :meth:"
"`ArgumentParser.add_argument` calls."
msgstr ""
"すべての :meth:`optparse.OptionParser.add_option` の呼び出しを、:meth:"
"`ArgumentParser.add_argument` の呼び出しに置き換える。"

#: ../../library/argparse.rst:1950
msgid ""
"Replace ``(options, args) = parser.parse_args()`` with ``args = parser."
"parse_args()`` and add additional :meth:`ArgumentParser.add_argument` calls "
"for the positional arguments. Keep in mind that what was previously called "
"``options``, now in the :mod:`argparse` context is called ``args``."
msgstr ""
"``(options, args) = parser.parse_args()`` を ``args = parser.parse_args()`` "
"に置き換え、位置引数のために必要に応じて :meth:`ArgumentParser.add_argument` "
"の呼び出しを追加する。これまで ``options`` と呼ばれていたものが、:mod:"
"`argparse` では ``args`` と呼ばれていることに留意してください。"

#: ../../library/argparse.rst:1955
msgid ""
"Replace :meth:`optparse.OptionParser.disable_interspersed_args` by setting "
"``nargs`` of a positional argument to `argparse.REMAINDER`_, or use :meth:"
"`~ArgumentParser.parse_known_args` to collect unparsed argument strings in a "
"separate list."
msgstr ""

#: ../../library/argparse.rst:1960
msgid ""
"Replace callback actions and the ``callback_*`` keyword arguments with "
"``type`` or ``action`` arguments."
msgstr ""
"コールバック・アクションと ``callback_*`` キーワード引数を ``type`` や "
"``action`` 引数に置き換える。"

#: ../../library/argparse.rst:1963
msgid ""
"Replace string names for ``type`` keyword arguments with the corresponding "
"type objects (e.g. int, float, complex, etc)."
msgstr ""
"``type`` キーワード引数に渡していた文字列の名前を、それに応じたオブジェクト "
"(例: int, float, complex, ...) に置き換える。"

#: ../../library/argparse.rst:1966
msgid ""
"Replace :class:`optparse.Values` with :class:`Namespace` and :exc:`optparse."
"OptionError` and :exc:`optparse.OptionValueError` with :exc:`ArgumentError`."
msgstr ""
":class:`optparse.Values` を :class:`Namespace` に置き換え、:exc:`optparse."
"OptionError` と :exc:`optparse.OptionValueError` を :exc:`ArgumentError` に置"
"き換える。"

#: ../../library/argparse.rst:1970
msgid ""
"Replace strings with implicit arguments such as ``%default`` or ``%prog`` "
"with the standard Python syntax to use dictionaries to format strings, that "
"is, ``%(default)s`` and ``%(prog)s``."
msgstr ""
"``%default`` や ``%prog`` などの暗黙の引数を含む文字列を、``%(default)s`` や "
"``%(prog)s`` などの、通常の Python で辞書を使う場合のフォーマット文字列に置き"
"換える。"

#: ../../library/argparse.rst:1974
msgid ""
"Replace the OptionParser constructor ``version`` argument with a call to "
"``parser.add_argument('--version', action='version', version='<the "
"version>')``."
msgstr ""
"OptionParser のコンストラクターの ``version`` 引数を、``parser."
"add_argument('--version', action='version', version='<the version>')`` に置き"
"換える"