Merge 3.14 into 3.12

Author: github-actions

library/inspect.po

@@ -1567,17 +1567,20 @@ msgstr ""
 
 #: ../../library/inspect.rst:883
 msgid "The *unquote_annotations* parameter was added."
-msgstr ""
+msgstr "*unquote_annotations* パラメータが追加されました。"
 
 #: ../../library/inspect.rst:888
 msgid ""
 "Return a :class:`Signature` (or its subclass) object for a given callable "
 "*obj*."
 msgstr ""
+"与えられた呼び出し可能オブジェクト *obj* に対する :class:`Signature` (または"
+"そのサブクラスの) オブジェクトを返します。"
 
 #: ../../library/inspect.rst:891
 msgid "This method simplifies subclassing of :class:`Signature`:"
 msgstr ""
+"このメソッドは :class:`Signature` からサブクラスを作る作業を簡素化します:"
 
 #: ../../library/inspect.rst:893
 msgid ""
@@ -1586,21 +1589,31 @@ msgid ""
 "sig = MySignature.from_callable(sum)\n"
 "assert isinstance(sig, MySignature)"
 msgstr ""
+"class MySignature(Signature):\n"
+"    pass\n"
+"sig = MySignature.from_callable(sum)\n"
+"assert isinstance(sig, MySignature)"
 
 #: ../../library/inspect.rst:900
 msgid "Its behavior is otherwise identical to that of :func:`signature`."
-msgstr ""
+msgstr "このメソッドの振る舞いは、上記を除けば :func:`signature` と同じです。"
 
 #: ../../library/inspect.rst:910
 msgid ""
 ":class:`!Parameter` objects are *immutable*. Instead of modifying a :class:`!"
 "Parameter` object, you can use :meth:`Parameter.replace` or :func:`copy."
 "replace` to create a modified copy."
 msgstr ""
+":class:`!Parameter` オブジェクトはイミュータブル (*immutable*) すなわち変更不"
+"可能です。 :class:`!Parameter` オブジェクトを変更する代わりに、 :meth:"
+"`Parameter.replace` や :func:`copy.replace` を使ってオブジェクトの内容を変更"
+"したコピーを作成することができます。"
 
 #: ../../library/inspect.rst:914
 msgid "Parameter objects are now picklable and :term:`hashable`."
 msgstr ""
+"Parameter オブジェクトはピックル化可能 (picklable) かつ ハッシュ化可能 (:"
+"term:`hashable`) になりました。"
 
 #: ../../library/inspect.rst:919
 msgid ""
@@ -1621,12 +1634,16 @@ msgid ""
 "CPython generates implicit parameter names of the form ``.0`` on the code "
 "objects used to implement comprehensions and generator expressions."
 msgstr ""
+"CPython は内包表記やジェネレータ式を実装するためのコードオブジェクトにおい"
+"て、 ``.0`` という形式で暗黙のパラメータ名を生成します。"
 
 #: ../../library/inspect.rst:933
 msgid ""
 "These parameter names are now exposed by this module as names like "
 "``implicit0``."
 msgstr ""
+"このモジュールにより、これら暗黙のパラメータ名は ``implicit0`` のような名前で"
+"公開されるようになりました。"
 
 #: ../../library/inspect.rst:939
 msgid ""
@@ -1650,6 +1667,9 @@ msgid ""
 "values are accessible via :class:`Parameter` (like ``Parameter."
 "KEYWORD_ONLY``), and support comparison and ordering, in the following order:"
 msgstr ""
+"引数の値がどのようにパラメータと紐付けられるかを記述します。指定可能な値は :"
+"class:`Parameter` を介して (``Parameter.KEYWORD_ONLY`` のように) アクセス可能"
+"で、以下に示す順番で比較や順序付けをサポートしています:"
 
 #: ../../library/inspect.rst:956
 msgid "Name"
@@ -1669,6 +1689,8 @@ msgid ""
 "are those which appear before a ``/`` entry (if present) in a Python "
 "function definition."
 msgstr ""
+"値は位置引数として渡されなければなりません。 Python の関数定義において、位置"
+"専用引数は (もし存在すれば) ``/`` エントリの前に現れるものを指します。"
 
 #: ../../library/inspect.rst:963
 msgid "*POSITIONAL_OR_KEYWORD*"
@@ -1721,7 +1743,7 @@ msgstr ""
 
 #: ../../library/inspect.rst:984
 msgid "Example: print all keyword-only arguments without default values:"
-msgstr ""
+msgstr "例: デフォルト値を持たないキーワード専用引数を全て出力します:"
 
 #: ../../library/inspect.rst:986
 msgid ""
@@ -1735,14 +1757,23 @@ msgid ""
 "...         print('Parameter:', param)\n"
 "Parameter: c"
 msgstr ""
+">>> def foo(a, b, *, c, d=10):\n"
+"...     pass\n"
+"\n"
+">>> sig = signature(foo)\n"
+">>> for param in sig.parameters.values():\n"
+"...     if (param.kind == param.KEYWORD_ONLY and\n"
+"...                        param.default is param.empty):\n"
+"...         print('Parameter:', param)\n"
+"Parameter: c"
 
 #: ../../library/inspect.rst:1000
 msgid "Describes an enum value of :attr:`Parameter.kind`."
-msgstr ""
+msgstr ":attr:`Parameter.kind` 列挙型の各定数を説明します。"
 
 #: ../../library/inspect.rst:1004
 msgid "Example: print all descriptions of arguments:"
-msgstr ""
+msgstr "例: 全ての引数に対する説明を出力します:"
 
 #: ../../library/inspect.rst:1006
 msgid ""
@@ -1757,6 +1788,16 @@ msgid ""
 "keyword-only\n"
 "keyword-only"
 msgstr ""
+">>> def foo(a, b, *, c, d=10):\n"
+"...     pass\n"
+"\n"
+">>> sig = signature(foo)\n"
+">>> for param in sig.parameters.values():\n"
+"...     print(param.kind.description)\n"
+"positional or keyword\n"
+"positional or keyword\n"
+"keyword-only\n"
+"keyword-only"
 
 #: ../../library/inspect.rst:1021
 msgid ""
@@ -1765,6 +1806,11 @@ msgid ""
 "corresponding argument.  To remove a default value or/and an annotation from "
 "a :class:`!Parameter`, pass :attr:`Parameter.empty`."
 msgstr ""
+"このメソッドの呼び出し元のインスタンスをもとにして、新たな :class:"
+"`Parameter` インスタンスを生成します。 :class:`!Parameter` の属性をオーバーラ"
+"イドするには、対応する引数をこのメソッドに渡してください。 :class:`!"
+"Parameter` からデフォルト値やアノテーションを取り除きたい場合は、 :attr:"
+"`Parameter.empty` を渡してください。"
 
 #: ../../library/inspect.rst:1026
 msgid ""
@@ -1779,51 +1825,78 @@ msgid ""
 ">>> str(param.replace(default=Parameter.empty, annotation='spam'))\n"
 "\"foo: 'spam'\""
 msgstr ""
+">>> from inspect import Parameter\n"
+">>> param = Parameter('foo', Parameter.KEYWORD_ONLY, default=42)\n"
+">>> str(param)\n"
+"'foo=42'\n"
+"\n"
+">>> str(param.replace()) # Will create a shallow copy of 'param'\n"
+"'foo=42'\n"
+"\n"
+">>> str(param.replace(default=Parameter.empty, annotation='spam'))\n"
+"\"foo: 'spam'\""
 
 #: ../../library/inspect.rst:1039
 msgid ""
 ":class:`Parameter` objects are also supported by the generic function :func:"
 "`copy.replace`."
 msgstr ""
+":class:`Parameter` オブジェクトは汎用関数 :func:`copy.replace` でもサポートさ"
+"れています。"
 
 #: ../../library/inspect.rst:1042
 msgid ""
 "In Python 3.3 :class:`Parameter` objects were allowed to have ``name`` set "
 "to ``None`` if their ``kind`` was set to ``POSITIONAL_ONLY``. This is no "
 "longer permitted."
 msgstr ""
+"Python 3.3 では、``kind`` が ``POSITIONAL_ONLY`` の場合に限り、 ``name`` が "
+"``None`` であるような :class:`Parameter` オブジェクトが許されていました。です"
+"が、そのようなオブジェクトはもはや許可されていません。"
 
 #: ../../library/inspect.rst:1049
 msgid ""
 "Result of a :meth:`Signature.bind` or :meth:`Signature.bind_partial` call. "
 "Holds the mapping of arguments to the function's parameters."
 msgstr ""
+":meth:`Signature.bind` または :meth:`Signature.bind_partial` を呼び出して得ら"
+"れる結果です。引数と関数のパラメータとの間のマッピング情報を保持します。"
 
 #: ../../library/inspect.rst:1054
 msgid ""
 "A mutable mapping of parameters' names to arguments' values. Contains only "
 "explicitly bound arguments.  Changes in :attr:`arguments` will reflect in :"
 "attr:`args` and :attr:`kwargs`."
 msgstr ""
+"パラメータの名前と引数の値との間のミュータブルなマッピングです。明示的に紐付"
+"けされた引数だけを含みます。 :attr:`arguments` に対する変更は :attr:`args` "
+"と :attr:`kwargs` に反映されます。"
 
 #: ../../library/inspect.rst:1058
 msgid ""
 "Should be used in conjunction with :attr:`Signature.parameters` for any "
 "argument processing purposes."
 msgstr ""
+"いかなる引数処理の目的でも、 :attr:`Signature.parameters` とあわせて使うよう"
+"にしてください。"
 
 #: ../../library/inspect.rst:1063
 msgid ""
 "Arguments for which :meth:`Signature.bind` or :meth:`Signature.bind_partial` "
 "relied on a default value are skipped. However, if needed, use :meth:"
 "`BoundArguments.apply_defaults` to add them."
 msgstr ""
+":meth:`Signature.bind` または :meth:`Signature.bind_partial` でデフォルト値を"
+"あてにするとされた引数は、スキップされます。それらをマッピングに加えたい場合"
+"は、必要に応じて :meth:`BoundArguments.apply_defaults` を使ってください。"
 
 #: ../../library/inspect.rst:1068
 msgid ""
 ":attr:`arguments` is now of type :class:`dict`. Formerly, it was of type :"
 "class:`collections.OrderedDict`."
 msgstr ""
+":attr:`arguments` の型が :class:`dict` になりました。以前は :class:"
+"`collections.OrderedDict` 型でした。"
 
 #: ../../library/inspect.rst:1074
 msgid ""
@@ -1838,6 +1911,9 @@ msgid ""
 "`arguments` attribute.  Arguments that can be passed positionally are "
 "included in :attr:`args` instead."
 msgstr ""
+"キーワード引数の値の辞書です。 :attr:`arguments` 属性から動的に計算されます。"
+"位置引数として渡すことができる引数は、 :attr:`args` に含まれることに注意して"
+"ください。"
 
 #: ../../library/inspect.rst:1085
 msgid "A reference to the parent :class:`Signature` object."
@@ -1850,12 +1926,13 @@ msgstr "存在しない引数のデフォルト値を設定します。"
 #: ../../library/inspect.rst:1091
 msgid ""
 "For variable-positional arguments (``*args``) the default is an empty tuple."
-msgstr ""
+msgstr "可変長位置引数 (``*args``) に対するデフォルト値は、空のタプルです。"
 
 #: ../../library/inspect.rst:1094
 msgid ""
 "For variable-keyword arguments (``**kwargs``) the default is an empty dict."
 msgstr ""
+"可変長キーワード引数 (``**kwargs``) に対するデフォルト値は、空の辞書です。"
 
 #: ../../library/inspect.rst:1097
 msgid ""
@@ -1865,12 +1942,19 @@ msgid ""
 ">>> ba.arguments\n"
 "{'a': 'spam', 'b': 'ham', 'args': ()}"
 msgstr ""
+">>> def foo(a, b='ham', *args): pass\n"
+">>> ba = inspect.signature(foo).bind('spam')\n"
+">>> ba.apply_defaults()\n"
+">>> ba.arguments\n"
+"{'a': 'spam', 'b': 'ham', 'args': ()}"
 
 #: ../../library/inspect.rst:1107
 msgid ""
 "The :attr:`args` and :attr:`kwargs` properties can be used to invoke "
 "functions:"
 msgstr ""
+":attr:`args` と :attr:`kwargs` の2つのプロパティは、関数の呼び出しに使うこと"
+"ができます:"
 
 #: ../../library/inspect.rst:1110
 msgid ""
@@ -1881,14 +1965,20 @@ msgid ""
 "ba = sig.bind(10, b=20)\n"
 "test(*ba.args, **ba.kwargs)"
 msgstr ""
+"def test(a, *, b):\n"
+"    ...\n"
+"\n"
+"sig = signature(test)\n"
+"ba = sig.bind(10, b=20)\n"
+"test(*ba.args, **ba.kwargs)"
 
 #: ../../library/inspect.rst:1122
 msgid ":pep:`362` - Function Signature Object."
 msgstr ":pep:`362`: - 関数シグニチャオブジェクト"
 
 #: ../../library/inspect.rst:1123
 msgid "The detailed specification, implementation details and examples."
-msgstr ""
+msgstr "仕様の詳細、実装の詳細および使用例を示しています。"
 
 #: ../../library/inspect.rst:1129
 msgid "Classes and functions"
@@ -1915,6 +2005,8 @@ msgid ""
 "Get the names and default values of a Python function's parameters.  A :term:"
 "`named tuple` is returned:"
 msgstr ""
+"Python 関数のパラメータの名前とデフォルト値を取得します。 :term:`named "
+"tuple` を返します:"
 
 #: ../../library/inspect.rst:1147
 msgid ""