Merge 3.11 into 3.10

github-actions · github-actions · commit 8844202543af · 2023-10-02T23:51:23.000Z
diff --git a/library/__main__.po b/library/__main__.po
@@ -31,16 +31,20 @@ msgid ""
 "In Python, the special name ``__main__`` is used for two important "
 "constructs:"
 msgstr ""
+"Python では、 ``__main__`` という特別な名前が次の二つの重要な用途で使われま"
+"す:"
 
 #: ../../library/__main__.rst:12
 msgid ""
 "the name of the top-level environment of the program, which can be checked "
 "using the ``__name__ == '__main__'`` expression; and"
 msgstr ""
+"プログラムのトップレベル環境の名前。\n"
+"``__name__ == '__main__'`` という式でチェックすることができる。"
 
 #: ../../library/__main__.rst:14
 msgid "the ``__main__.py`` file in Python packages."
-msgstr ""
+msgstr "Python パッケージにおける ``__main__.py`` ファイル。"
 
 #: ../../library/__main__.rst:16
 msgid ""
@@ -49,6 +53,12 @@ msgid ""
 "detail below.  If you're new to Python modules, see the tutorial section :"
 "ref:`tut-modules` for an introduction."
 msgstr ""
+"どちらも Python のモジュールに関わる機能です。\n"
+"１つ目はユーザーがどうモジュールを使うか、２つ目はモジュールとモジュールがど"
+"うやりとりするかに関係します。\n"
+"詳細は以下で説明します。\n"
+"Python モジュールがどういうものかについては、 :ref:`tut-modules` を参照してく"
+"ださい。"
 
 #: ../../library/__main__.rst:25
 msgid "``__name__ == '__main__'``"
@@ -60,22 +70,30 @@ msgid ""
 "module's name.  Usually, this is the name of the Python file itself without "
 "the ``.py`` extension::"
 msgstr ""
+"Python モジュールやパッケージがインポートされるとき、 ``__name__`` の値はその"
+"モジュールの名前となります。\n"
+"通常、インポートされる Python ファイル自体のファイル名から拡張子``.py`` を除"
+"いたものとなります::"
 
 #: ../../library/__main__.rst:35
 msgid ""
 "If the file is part of a package, ``__name__`` will also include the parent "
 "package's path::"
 msgstr ""
+"インポートされるファイルがパッケージの一部である場合は、 ``__name__`` にはそ"
+"のパッケージのパスも含まれます::"
 
 #: ../../library/__main__.rst:42
 msgid ""
 "However, if the module is executed in the top-level code environment, its "
 "``__name__`` is set to the string ``'__main__'``."
 msgstr ""
+"しかし、モジュールがトップレベルのスクリプト環境で実行される場合は、 "
+"``__name__`` が ``'__main__'`` という文字列になります。"
 
 #: ../../library/__main__.rst:46
 msgid "What is the \"top-level code environment\"?"
-msgstr ""
+msgstr "「トップレベルのスクリプト環境」とは"
 
 #: ../../library/__main__.rst:48
 msgid ""
@@ -88,36 +106,41 @@ msgstr ""
 
 #: ../../library/__main__.rst:53
 msgid "The top-level code environment can be:"
-msgstr ""
+msgstr "以下のものがトップレベルのスクリプト環境となります:"
 
 #: ../../library/__main__.rst:55
 msgid "the scope of an interactive prompt::"
-msgstr ""
+msgstr "インタラクティブプロンプトのスコープ::"
 
 #: ../../library/__main__.rst:60
 msgid "the Python module passed to the Python interpreter as a file argument:"
-msgstr ""
+msgstr "Python インタープリタにファイル引数として渡される Python モジュール:"
 
 #: ../../library/__main__.rst:67
 msgid ""
 "the Python module or package passed to the Python interpreter with the :"
 "option:`-m` argument:"
 msgstr ""
+"Python インタープリタにPython :option:`-m` オプションとして渡される Python モ"
+"ジュールまたはパッケージ:"
 
 #: ../../library/__main__.rst:75
 msgid "Python code read by the Python interpreter from standard input:"
-msgstr ""
+msgstr "標準入力から Python インタープリタが読み込む Python コード:"
 
 #: ../../library/__main__.rst:86
 msgid ""
 "Python code passed to the Python interpreter with the :option:`-c` argument:"
 msgstr ""
+"Python インタープリタに :option:`-c` オプションで渡される Python コード:"
 
 #: ../../library/__main__.rst:97
 msgid ""
 "In each of these situations, the top-level module's ``__name__`` is set to "
 "``'__main__'``."
 msgstr ""
+"上記それぞれの場合で、トップレベルのモジュールの ``__name__`` の値が "
+"``'__main__'`` となります。"
 
 #: ../../library/__main__.rst:100
 msgid ""
@@ -126,16 +149,22 @@ msgid ""
 "idiom for conditionally executing code when the module is not initialized "
 "from an import statement::"
 msgstr ""
+"これにより、 ``__name__`` をチェックすれば各モジュールは自分がトップレベル環"
+"境で実行されているかどうかを知ることができます。\n"
+"このことから、モジュールが import 文で初期化された場合以外の場合でのみコード"
+"を実行するため、次のコードがしばしば用いられます::"
 
 #: ../../library/__main__.rst:111
 msgid ""
 "For a more detailed look at how ``__name__`` is set in all situations, see "
 "the tutorial section :ref:`tut-modules`."
 msgstr ""
+"あらゆる場合に ``__name__`` の値がどうセットされるのかについて、詳しくは"
+"チュートリアルの :ref:`tut-modules` セクションを参照してください。"
 
 #: ../../library/__main__.rst:116 ../../library/__main__.rst:239
 msgid "Idiomatic Usage"
-msgstr ""
+msgstr "通常の使われ方"
 
 #: ../../library/__main__.rst:118
 msgid ""
@@ -144,13 +173,20 @@ msgid ""
 "like this was imported from a different module, for example to unit test it, "
 "the script code would unintentionally execute as well."
 msgstr ""
+"一部のモジュールでは、コマンドライン引数をパースしたり標準入力からデータを取"
+"得したなど、スクリプト用途のみのコードが含まれています。\n"
+"このようなモジュールが、例えばユニットテストのため、別のモジュールからイン"
+"ポートされると、そのスクリプト用コードが意図に反して実行されてしまいます。"
 
 #: ../../library/__main__.rst:123
 msgid ""
 "This is where using the ``if __name__ == '__main__'`` code block comes in "
 "handy. Code within this block won't run unless the module is executed in the "
 "top-level environment."
 msgstr ""
+"``if __name__ == '__main__'`` というコードは、このようなときに役立ちます。\n"
+"このブロックの中にあるコードは、当該のモジュールがトップレベル環境で実行され"
+"ていない限り、実行されません。"
 
 #: ../../library/__main__.rst:127
 msgid ""
@@ -168,6 +204,12 @@ msgid ""
 "the global variable instead of a local name.  A ``main`` function solves "
 "this problem."
 msgstr ""
+"注意すべき点として、もし ``main`` 関数内のコードをカプセル化せず ``if "
+"__name__ == '__main__'`` の下に直接書いた場合、 ``phrase`` 変数はモジュール全"
+"体からグローバルにアクセスできてしまいます。\n"
+"モジュール内の他の関数が意図せずローカル変数ではなくそのグローバル変数を使用"
+"してしまう可能性があるため、ミスにつながります。\n"
+"``main`` 関数を用意することでこの問題は解決できます。"
 
 #: ../../library/__main__.rst:158
 msgid ""
@@ -176,6 +218,11 @@ msgid ""
 "imported, the ``echo`` and ``main`` functions will be defined, but neither "
 "of them will be called, because ``__name__ != '__main__'``."
 msgstr ""
+"``main`` 関数を使うことのもう一つのメリットとして、 ``echo`` 関数が分離し、別"
+"の場所からインポートできるようになることです。\n"
+"``echo.py`` がインポートされるとき、 ``echo`` 関数と ``main`` 関数が定義され"
+"ますが、 ``__name__ != '__main__'`` であるため、どちらの関数も呼び出されませ"
+"ん。"
 
 #: ../../library/__main__.rst:165
 msgid "Packaging Considerations"
diff --git a/reference/compound_stmts.po b/reference/compound_stmts.po
@@ -558,6 +558,9 @@ msgid ""
 "You can also write multi-item context managers in multiple lines if the "
 "items are surrounded by parentheses. For example::"
 msgstr ""
+"括弧で囲むことにより、複数のコンテキストマネージャを複数行に渡って書くことが"
+"できます。\n"
+"例::"
 
 #: ../../reference/compound_stmts.rst:482
 msgid "Support for multiple context expressions."
@@ -567,7 +570,7 @@ msgstr "複数のコンテキスト式をサポートしました。"
 msgid ""
 "Support for using grouping parentheses to break the statement in multiple "
 "lines."
-msgstr ""
+msgstr "括弧で囲むことで、文を複数行に分割して書けるようになりました。"
 
 #: ../../reference/compound_stmts.rst:491
 msgid ":pep:`343` - The \"with\" statement"
@@ -586,34 +589,44 @@ msgstr ":keyword:`!match` 文"
 #: ../../reference/compound_stmts.rst:511
 msgid "The match statement is used for pattern matching.  Syntax:"
 msgstr ""
+"match 文はパターンマッチングを行う目的で使われます。\n"
+"構文:"
 
 #: ../../reference/compound_stmts.rst:520
 msgid ""
 "This section uses single quotes to denote :ref:`soft keywords <soft-"
 "keywords>`."
 msgstr ""
+"このセクションでは、一重引用符で囲まれているものは :ref:`ソフトキーワード "
+"<soft-keywords>` を表します。"
 
 #: ../../reference/compound_stmts.rst:523
 msgid ""
 "Pattern matching takes a pattern as input (following ``case``) and a subject "
 "value (following ``match``).  The pattern (which may contain subpatterns) is "
 "matched against the subject value.  The outcomes are:"
 msgstr ""
+"パターンマッチングは、パターン (``case`` の後ろ) とマッチング対象の値 "
+"(``match`` の後ろ)を入力とします。\n"
+"パターン (サブパターンを含みうる) は、マッチング対象の値に対して、マッチする"
+"かどうかの判定が行われます。結果として次のことが起こります:"
 
 #: ../../reference/compound_stmts.rst:527
 msgid "A match success or failure (also termed a pattern success or failure)."
-msgstr ""
+msgstr "マッチ成功、もしくはマッチ失敗 (パターン成功・失敗とも呼ばれます)。"
 
 #: ../../reference/compound_stmts.rst:529
 msgid ""
 "Possible binding of matched values to a name.  The prerequisites for this "
 "are further discussed below."
-msgstr ""
+msgstr "マッチした値の名前への束縛。必要な条件は後述します。"
 
 #: ../../reference/compound_stmts.rst:532
 msgid ""
 "The ``match`` and ``case`` keywords are :ref:`soft keywords <soft-keywords>`."
 msgstr ""
+"``match`` と ``case`` キーワードは :ref:`ソフトキーワード <soft-keywords>` で"
+"す。"
 
 #: ../../reference/compound_stmts.rst:536
 #: ../../reference/compound_stmts.rst:1091
@@ -631,14 +644,17 @@ msgstr "概要"
 
 #: ../../reference/compound_stmts.rst:543
 msgid "Here's an overview of the logical flow of a match statement:"
-msgstr ""
+msgstr "match 文の論理的な動作の流れの概要は次の通りです:"
 
 #: ../../reference/compound_stmts.rst:546
 msgid ""
 "The subject expression ``subject_expr`` is evaluated and a resulting subject "
 "value obtained. If the subject expression contains a comma, a tuple is "
 "constructed using :ref:`the standard rules <typesseq-tuple>`."
 msgstr ""
+"サブジェクト式 ``subject_expr`` が評価され、サブジェクト値が得られます。\n"
+"サブジェクト式がコンマを含む場合、 :ref:`通常のルール <typesseq-tuple>` に"
+"従ってタプルが作成されます。"
 
 #: ../../reference/compound_stmts.rst:550
 msgid ""
@@ -649,6 +665,14 @@ msgid ""
 "specified below.  **Name bindings made during a successful pattern match "
 "outlive the executed block and can be used after the match statement**."
 msgstr ""
+"``case_block`` 内の各パターンに対して、サブジェクト値がマッチするかどうかを"
+"チェックします。\n"
+"マッチ成功・失敗の具体的なルールは後述します。\n"
+"マッチングのチェックにより、パターン内の名前の一部あるいはすべてに値が束縛さ"
+"れます。\n"
+"具体的な束縛ルールはパターンの種類によって異なるため、後述します。 **成功した"
+"マッチで束縛された名前は、そのブロックの実行後も存続し、 match 文の後も使用す"
+"ることができます**。"
 
 #: ../../reference/compound_stmts.rst:559
 msgid ""
