Merge 3.14 into 3.13

Author: github-actions

library/inspect.po

@@ -1124,6 +1124,12 @@ msgid ""
 "documentation string from the inheritance hierarchy. Return ``None`` if the "
 "documentation string is invalid or missing."
 msgstr ""
+"オブジェクトのドキュメンテーション文字列を、 :func:`cleandoc` で整理した上で"
+"取得します。オブジェクトに対するドキュメンテーション文字列が与えられていない"
+"場合で、かつオブジェクトがクラス、メソッド、プロパティ、デスクリプタのいずれ"
+"かである場合、継承の階層構造からドキュメンテーション文字列を探し出して返しま"
+"す。ドキュメンテーション文字列がないか、または不正な場合は ``None`` を返しま"
+"す。"
 
 #: ../../library/inspect.rst:627
 msgid "Documentation strings are now inherited if not overridden."
@@ -1139,6 +1145,11 @@ msgid ""
 "code is unavailable, return ``None``.  This could happen if the object has "
 "been defined in C or the interactive shell."
 msgstr ""
+"オブジェクトのソースコード直前 (クラス、関数、メソッドの場合) または Python "
+"ソースファイルの先頭 (モジュールの場合) の任意の行数にわたるコメントを、ひと"
+"つの文字列として返します。オブジェクトのソースコードが存在しない場合は "
+"``None`` を返します。オブジェクトが C で定義されている場合や、対話型シェルで"
+"定義したオブジェクトの場合にこのようなことが起こり得ます。"
 
 #: ../../library/inspect.rst:642
 msgid ""
@@ -1155,13 +1166,18 @@ msgid ""
 "Try to guess which module an object was defined in. Return ``None`` if the "
 "module cannot be determined."
 msgstr ""
+"オブジェクトが定義されているモジュールの推定を試みます。モジュールが決められ"
+"ない場合は ``None`` を返します。"
 
 #: ../../library/inspect.rst:655
 msgid ""
 "Return the name of the Python source file in which an object was defined or "
 "``None`` if no way can be identified to get the source.  This will fail with "
 "a :exc:`TypeError` if the object is a built-in module, class, or function."
 msgstr ""
+"オブジェクトが定義されている Python ソースファイルの名前を返します。ソースを"
+"取得する方法がない場合は ``None`` を返します。組み込みのモジュール、クラス、"
+"関数に対しては :exc:`TypeError` で失敗します。"
 
 #: ../../library/inspect.rst:663
 msgid ""
@@ -1173,6 +1189,13 @@ msgid ""
 "code cannot be retrieved. A :exc:`TypeError` is raised if the object is a "
 "built-in module, class, or function."
 msgstr ""
+"オブジェクトを定義しているソースコードの行のリストと、定義の開始行番号を返し"
+"ます。引数にはモジュール、クラス、メソッド、関数、トレースバック、またはコー"
+"ドオブジェクトを渡すことができます。オブジェクトに対応するソースコードが行の"
+"リストとして返されます。また行番号は、元のソースファイル中でコードが見つかっ"
+"た最初の行を示します。ソースコードを探し出すことができなかった場合、 :exc:"
+"`OSError` 例外が送出されます。オブジェクトが組み込みのモジュール、クラス、ま"
+"たは関数である場合は :exc:`TypeError` 例外が送出されます。"
 
 #: ../../library/inspect.rst:672 ../../library/inspect.rst:686
 msgid ""
@@ -1190,6 +1213,12 @@ msgid ""
 "the source code cannot be retrieved. A :exc:`TypeError` is raised if the "
 "object is a built-in module, class, or function."
 msgstr ""
+"オブジェクトを定義しているソースコードのテキストを返します。引数にはモジュー"
+"ル、クラス、メソッド、関数、トレースバック、フレーム、またはコードオブジェク"
+"トを渡すことができます。ソースコードはひとつの文字列として返されます。ソース"
+"コードを探し出すことができなかった場合、 :exc:`OSError` 例外が送出されます。"
+"オブジェクトが組み込みのモジュール、クラス、または関数である場合は :exc:"
+"`TypeError` 例外が送出されます。"
 
 #: ../../library/inspect.rst:693
 msgid ""
@@ -1219,10 +1248,15 @@ msgid ""
 "object and its return annotation. To retrieve a :class:`!Signature` object, "
 "use the :func:`!signature` function."
 msgstr ""
+":class:`Signature` オブジェクトは、呼び出し可能オブジェクトの呼び出しシグネ"
+"チャと戻り値のアノテーションを表現します。 :class:`!Signature` オブジェクトを"
+"取得するには、 :func:`!signature` 関数を使ってください。"
 
 #: ../../library/inspect.rst:716
 msgid "Return a :class:`Signature` object for the given *callable*:"
 msgstr ""
+"*callable* で与えられたオブジェクトに対する :class:`Signature` オブジェクトを"
+"返します:"
 
 #: ../../library/inspect.rst:718
 msgid ""
@@ -1241,6 +1275,20 @@ msgid ""
 ">>> sig.parameters['b'].annotation\n"
 "<class 'int'>"
 msgstr ""
+">>> from inspect import signature\n"
+">>> def foo(a, *, b:int, **kwargs):\n"
+"...     pass\n"
+"\n"
+">>> sig = signature(foo)\n"
+"\n"
+">>> str(sig)\n"
+"'(a, *, b: int, **kwargs)'\n"
+"\n"
+">>> str(sig.parameters['b'])\n"
+"'b: int'\n"
+"\n"
+">>> sig.parameters['b'].annotation\n"
+"<class 'int'>"
 
 #: ../../library/inspect.rst:735
 msgid ""