Merge 3.14 into 3.12

github-actions · github-actions · commit 7e4f5b2403b2 · 2026-01-26T23:52:06.000Z
diff --git a/library/doctest.po b/library/doctest.po
@@ -150,6 +150,8 @@ msgid ""
 "$ python example.py\n"
 "$"
 msgstr ""
+"$ python example.py\n"
+"$"
 
 #: ../../library/doctest.rst:96
 msgid ""
@@ -222,6 +224,8 @@ msgid ""
 "The simplest way to start using doctest (but not necessarily the way you'll "
 "continue to do it) is to end each module :mod:`!M` with::"
 msgstr ""
+"doctest を試す簡単な方法 (とはいえ、いつもそうする必要はないのですが) は、各"
+"モジュール :mod:`!M` の最後を、以下のようにして締めくくることです::"
 
 #: ../../library/doctest.rst:152
 msgid ""
@@ -233,6 +237,7 @@ msgstr ""
 #: ../../library/doctest.rst:156
 msgid ":mod:`!doctest` then examines docstrings in module :mod:`!M`."
 msgstr ""
+"こうすると、 :mod:`!doctest` は :mod:`!M` 中の docstring を検査します。"
 
 #: ../../library/doctest.rst:158
 msgid ""
@@ -244,7 +249,7 @@ msgstr ""
 
 #: ../../library/doctest.rst:161
 msgid "python M.py"
-msgstr ""
+msgstr "python M.py"
 
 #: ../../library/doctest.rst:163
 msgid ""
@@ -264,7 +269,7 @@ msgstr "一方、``-v`` スイッチをつけて走らせると::"
 
 #: ../../library/doctest.rst:170
 msgid "python M.py -v"
-msgstr ""
+msgstr "python M.py -v"
 
 #: ../../library/doctest.rst:172
 msgid ""
@@ -317,6 +322,8 @@ msgid ""
 "import doctest\n"
 "doctest.testfile(\"example.txt\")"
 msgstr ""
+"import doctest\n"
+"doctest.testfile(\"example.txt\")"
 
 #: ../../library/doctest.rst:197
 msgid ""
@@ -416,7 +423,7 @@ msgstr ""
 
 #: ../../library/doctest.rst:253
 msgid "Command-line Usage"
-msgstr ""
+msgstr "コマンドラインでの使用"
 
 #: ../../library/doctest.rst:255
 msgid ""
@@ -425,7 +432,7 @@ msgstr ""
 
 #: ../../library/doctest.rst:257
 msgid "python -m doctest [-v] [-o OPTION] [-f] file [file ...]"
-msgstr ""
+msgstr "python -m doctest [-v] [-o OPTION] [-f] file [file ...]"
 
 #: ../../library/doctest.rst:265
 msgid ""
@@ -435,14 +442,18 @@ msgstr ""
 
 #: ../../library/doctest.rst:268
 msgid "python -m doctest -v example.py"
-msgstr ""
+msgstr "python -m doctest -v example.py"
 
 #: ../../library/doctest.rst:270
 msgid ""
 "This will import :file:`example.py` as a standalone module and run :func:"
 "`testmod` on it. Note that this may not work correctly if the file is part "
 "of a package and imports other submodules from that package."
 msgstr ""
+"こうすると :file:`example.py` を単体モジュールとしてインポートして、それに対"
+"して :func:`testmod` を実行します。このファイルがパッケージの一部で他のサブモ"
+"ジュールをそのパッケージからインポートしている場合はうまく動かないことに注意"
+"してください。"
 
 #: ../../library/doctest.rst:274
 msgid ""
@@ -452,7 +463,7 @@ msgstr ""
 
 #: ../../library/doctest.rst:277
 msgid "python -m doctest -v example.txt"
-msgstr ""
+msgstr "python -m doctest -v example.txt"
 
 #: ../../library/doctest.rst:281
 msgid ""
@@ -709,6 +720,13 @@ msgid ""
 "names defined earlier in the docstring being run. Examples cannot see names "
 "defined in other docstrings."
 msgstr ""
+"デフォルトでは、 :mod:`doctest` はテストを行うべき docstring を見つけるたび"
+"に :mod:`!M` のグローバル名前空間の *浅いコピー* を使い、テストの実行によって"
+"モジュールの実際のグローバル名前空間を変更しないようにし、かつ :mod:`!M` 内で"
+"行ったテストが痕跡を残して偶発的に別のテストを誤って動作させないようにしてい"
+"ます。したがって、実行例中では :mod:`!M` 内のトップレベルで定義されたすべての"
+"名前と、 docstring が動作する以前に定義された名前を自由に使えます。個々の実行"
+"例は他の docstring 中で定義された名前を参照できません。"
 
 #: ../../library/doctest.rst:447
 msgid ""
@@ -1674,6 +1692,13 @@ msgid ""
 "*exclude_empty* argument to the newer :class:`DocTestFinder` constructor "
 "defaults to true."
 msgstr ""
+"オプション引数 *exclude_empty* はデフォルトでは偽になっています。この値を真に"
+"すると、doctest を持たないオブジェクトを考慮から外します。デフォルトの設定は"
+"依存のバージョンとの互換性を考えたハックであり、:meth:`doctest.master."
+"summarize <DocTestRunner.summarize>` と :func:`testmod` を合わせて利用してい"
+"るようなコードでも、テスト実行例を持たないオブジェクトから出力を得るようにし"
+"ています。新たに追加された :class:`DocTestFinder` のコンストラクタの "
+"*exclude_empty* はデフォルトで真になります。"
 
 #: ../../library/doctest.rst:993
 msgid ""
@@ -1748,6 +1773,12 @@ msgid ""
 "discovery, include a :ref:`load_tests <load_tests-protocol>` function in "
 "your test module::"
 msgstr ""
+"doctest が付けられたモジュールが大きくなるにつれ、全ての doctest を組織的に実"
+"行したくなるでしょう。 :mod:`doctest` モジュールは 2 つの関数を提供してい"
+"て、 :mod:`unittest` のテストスイートを作り、 doctest を含んだテキストファイ"
+"ルを作成するのに使えます。 :mod:`unittest` のテストディスカバリと組み合わせる"
+"には、テストモジュールに :ref:`load_tests <load_tests-protocol>` 関数を書いて"
+"おいてください::"
 
 #: ../../library/doctest.rst:1029
 msgid ""
diff --git a/library/logging.po b/library/logging.po
@@ -702,6 +702,9 @@ msgid ""
 "into account the relevant :attr:`Logger.propagate` attributes), the message "
 "will be sent to the handler set on :data:`lastResort`."
 msgstr ""
+"このロガー (および :attr:`Logger.propagate` 属性を考慮した上で実効的にイベン"
+"トが伝播する祖先のロガー) にハンドラが接続されていない場合、メッセージは :"
+"data:`lastResort` に設定されたハンドラーに送られます。"
 
 #: ../../library/logging.rst:347
 msgid "The *stack_info* parameter was added."
@@ -2323,6 +2326,12 @@ msgid ""
 "and calling :meth:`Logger.debug` (or other level-specific methods) on it, as "
 "described at the beginning of this documentation."
 msgstr ""
+"非常に短いスクリプトや ``logging`` の機能についての簡単なデモに対しては、 "
+"``debug`` やその他のモジュールレベル関数は便利でしょう。しかしながら、ほとん"
+"どのプログラムはロギングの設定を慎重かつ明示的に制御したいはずです。したがっ"
+"て、このドキュメントの最初に書かれているとおり、モジュールレベルのロガーを生"
+"成してそのロガーに対する :meth:`Logger.debug` メソッド (または他のログレベル"
+"固有のメソッド) を呼び出す方を好むでしょう。"
 
 #: ../../library/logging.rst:1213
 msgid ""
diff --git a/library/unittest.mock.po b/library/unittest.mock.po
@@ -87,6 +87,8 @@ msgid ""
 "There is a backport of :mod:`unittest.mock` for earlier versions of Python, "
 "available as :pypi:`mock` on PyPI."
 msgstr ""
+"以前の Python バージョン向けにバックポートされた :mod:`unittest.mock` があ"
+"り、 :pypi:`mock` on PyPIとして利用可能です。"
 
 #: ../../library/unittest.mock.rst:41
 msgid "Quick Guide"
@@ -109,6 +111,8 @@ msgid ""
 ":attr:`~Mock.side_effect` allows you to perform side effects, including "
 "raising an exception when a mock is called:"
 msgstr ""
+":attr:`~Mock.side_effect` によって、モック呼び出し時の例外発生などの副作用を"
+"実行できます:"
 
 #: ../../library/unittest.mock.rst:92
 msgid ""
@@ -322,6 +326,9 @@ msgid ""
 "__class__` returns the class of the spec object. This allows mocks to pass :"
 "func:`isinstance` tests."
 msgstr ""
+"*spec* が (文字列のリストではなく) オブジェクトの場合、 :attr:`~object."
+"__class__` はスペックオブジェクトのクラスを返します。これによってモックが :"
+"func:`isinstance` テストに通るようになります。"
 
 #: ../../library/unittest.mock.rst:245
 msgid ""
@@ -821,12 +828,18 @@ msgid ""
 "class instead. This allows mock objects to pass :func:`isinstance` tests for "
 "the object they are replacing / masquerading as:"
 msgstr ""
+"通常、オブジェクトの :attr:`!__class__` 属性はその型を返します。 :attr:`!"
+"spec` を設定したオブジェクトの場合、 :attr:`!__class__` は代わりに :attr:"
+"`spec` のクラスを返します。これにより、置き換え / 偽装しているオブジェクトに"
+"対する :func:`isinstance` も通過することができます:"
 
 #: ../../library/unittest.mock.rst:772
 msgid ""
 ":attr:`!__class__` is assignable to, this allows a mock to pass an :func:"
 "`isinstance` check without forcing you to use a spec:"
 msgstr ""
+":attr:`!__class__` は書き換え可能で、 :func:`isinstance` を通るために必ず "
+"spec を使う必要はありません:"
 
 #: ../../library/unittest.mock.rst:782
 msgid ""
@@ -842,6 +855,8 @@ msgid ""
 "Mock objects that use a class or an instance as a :attr:`!spec` or :attr:`!"
 "spec_set` are able to pass :func:`isinstance` tests:"
 msgstr ""
+":attr:`!spec` か :attr:`!spec_set` にクラスかインスタンスを渡した mock は :"
+"func:`isinstance` テストをパスします:"
 
 #: ../../library/unittest.mock.rst:796
 msgid ""
@@ -920,6 +935,9 @@ msgid ""
 "__get__` and :meth:`~object.__set__` methods so you can specify a return "
 "value when it is fetched."
 msgstr ""
+":class:`property` もしくは:term:`デスクリプタ <descriptor>` として使われるた"
+"めのモックです。 :class:`PropertyMock` は、 :meth:`~object.__get__` と :meth:"
+"`~object.__set__` メソッドを提供し、戻り値を指定することができます。"
 
 #: ../../library/unittest.mock.rst:854
 msgid ""
@@ -988,7 +1006,7 @@ msgstr ""
 
 #: ../../library/unittest.mock.rst:898
 msgid "See :meth:`~object.__getattr__` for details."
-msgstr ""
+msgstr "詳細は :meth:`~object.__getattr__` を参照してください。"
 
 #: ../../library/unittest.mock.rst:903
 msgid ""
diff --git a/library/unittest.po b/library/unittest.po
