Merge 3.11 into 3.10

github-actions · github-actions · commit 25cc4983d54a · 2023-03-27T23:51:00.000Z
diff --git a/library/logging.config.po b/library/logging.config.po
@@ -354,6 +354,20 @@ msgid ""
 "``verify`` argument to :func:`listen` to prevent unrecognised configurations "
 "from being applied."
 msgstr ""
+"設定の一部は :func:`eval` を通じて渡されるため、この関数を利用することはユー"
+"ザーをセキュリティ上のリスクにさらす可能性があります。この関数は "
+"``localhost`` のソケットだけにバインドされており、リモートマシンからの接続を"
+"受け付けませんが、それでも :func:`listen` を呼び出したプロセスのアカウントの"
+"もとで信頼できないコードが実行されうるシナリオが存在します。特に、 :func:"
+"`listen` を呼び出したプロセスが複数のユーザーが利用するマシン上で実行されてお"
+"り、ユーザー同士が互いに信頼できない場合、悪意あるユーザーが被害者ユーザーの"
+"プロセス上で本質的に任意のコードを実行するように計画する可能性があります。攻"
+"撃は、単に被害者ユーザーの :func:`listen` ソケットに接続して、被害者ユーザー"
+"のプロセス上で攻撃者が実行したいコードが実行されるような設定を送り込むだけで"
+"す。この攻撃はデフォルトのポートが使われている場合きわめて容易であり、異なる"
+"ポートが使われている場合でもそれほど難しくはありません。このような事象が発生"
+"するリスクを回避するためには、 :func:`listen` の ``verify`` 引数を使って不正"
+"な設定が適用されるのを防ぐようにしてください。"
 
 #: ../../library/logging.config.rst:175
 msgid "The ``verify`` argument was added."
@@ -899,12 +913,18 @@ msgid ""
 "will be set on the user-defined object before it is returned. Thus, with the "
 "following configuration::"
 msgstr ""
+"特殊なキーワード ``'.'`` を指定することもできます。この場合その値には属性名と"
+"その値のマッピングをあらわす辞書を指定します。指定された属性は、もしそれが見"
+"つかった場合、戻り値のユーザー定義オブジェクトに設定されます。したがって、以"
+"下のように設定すると::"
 
 #: ../../library/logging.config.rst:543
 msgid ""
 "the returned formatter will have attribute ``foo`` set to ``'bar'`` and "
 "attribute ``baz`` set to ``'bozz'``."
 msgstr ""
+"戻り値のフォーマッタは属性 ``foo`` と``baz`` をもち、それぞれの値は "
+"``'bar'`` と ``'bozz'`` に設定されます。"
 
 #: ../../library/logging.config.rst:550
 msgid "Access to external objects"
diff --git a/library/logging.handlers.po b/library/logging.handlers.po
@@ -219,6 +219,9 @@ msgid ""
 "Note that if the file was closed due to logging shutdown at exit and the "
 "file mode is 'w', the record will not be emitted (see :issue:`42378`)."
 msgstr ""
+"終了時、ロギングがシャットダウンされたためにファイルがクローズされており、"
+"ファイルのモードが 'w' である場合、 record は出力されません (:issue:`42378` "
+"を参照してください)。"
 
 #: ../../library/logging.handlers.rst:127
 msgid "NullHandler"
@@ -402,6 +405,18 @@ msgid ""
 "`~TimedRotatingFileHandler.getFilesToDelete` method to fit in with the "
 "custom naming scheme.)"
 msgstr ""
+"namer 属性にローテーションの際に使われるファイル名に埋め込むための特定の属性"
+"を保持しようとする場合に注意が必要なことは、注意喚起しておくべきでしょう。た"
+"とえば :class:`RotatingFileHandler` は、ローテーションが期待通りに動作するた"
+"めに、名前に連続した番号を含むようなファイル名のリストを持つことを期待しま"
+"す。また :class:`TimedRotatingFileHandler` は (ハンドラの初期化時に渡された "
+"``backupCount`` にもとづいて) 削除すべき古いファイルを決定しながら、古いログ"
+"ファイルを削除します。この仕組みが動作するためには、ファイル名は名前に含まれ"
+"る日付や時刻でソート可能である必要があり、 namer はそれを尊重しなければなりま"
+"せん (namer がこの規則を尊重したくない場合、そのような namer は :meth:"
+"`~TimedRotatingFileHandler.getFilesToDelete` メソッドが特定の命名規則に適合す"
+"るようにオーバーライドされた :class:`TimedRotatingFileHandler` の派生クラス内"
+"で使う必要があるでしょう)。"
 
 #: ../../library/logging.handlers.rst:255
 msgid ""
@@ -797,6 +812,9 @@ msgid ""
 "These are the absolute paths of the oldest backup log files written by the "
 "handler."
 msgstr ""
+"ロールオーバーの一環として削除されるファイル名のリストを返します。それらの"
+"ファイルは、ハンドラによって書き込まれた最も古いバックアップログファイルの絶"
+"対パスです。"
 
 #: ../../library/logging.handlers.rst:467
 msgid "SocketHandler"
@@ -983,6 +1001,13 @@ msgid ""
 "you, you can do a lookup yourself and initialize this handler using the "
 "looked-up IP address rather than the hostname."
 msgstr ""
+"UDP はストリーミングプロトコルではないため、このハンドラのインスタンスと "
+"*host* に指定したホストとの間に持続的なコネクションはありません。この理由か"
+"ら、ネットワークソケットを使う場合、イベントがログされるごとに DNS のルック"
+"アップを行わなければならないかもしれず、それによりシステムにある程度の待ち時"
+"間をもたらす可能性があります。この待ち時間が問題になる場合、自身でルックアッ"
+"プを行い、ホスト名の代わりにルックアップの結果得られた IP アドレスを使ってハ"
+"ンドラを初期化することができます。"
 
 #: ../../library/logging.handlers.rst:582
 msgid ""
@@ -1086,10 +1111,13 @@ msgid ""
 "daemon - it no longer listens on a domain socket. Therefore, you cannot "
 "expect :class:`SysLogHandler` to work on this system."
 msgstr ""
+"macOS 12.x (Monterey) において、 Apple 社は syslog デーモンの振る舞いを変更し"
+"ました - デーモンはドメインソケットをの待ち受けを行いません。したがって、この"
+"システム上では :class:`SysLogHandler` が動作することは期待できません。"
 
 #: ../../library/logging.handlers.rst:643
 msgid "See :gh:`91070` for more information."
-msgstr ""
+msgstr "より詳細な情報は :gh:`91070` を参照して下さい。"
 
 #: ../../library/logging.handlers.rst:645
 msgid "*socktype* was added."
@@ -1855,6 +1883,9 @@ msgid ""
 "If you are using :mod:`multiprocessing`, you should avoid using :class:"
 "`~queue.SimpleQueue` and instead use :class:`multiprocessing.Queue`."
 msgstr ""
+":mod:`multiprocessing` を使っている場合、 :class:`~queue.SimpleQueue` を使う"
+"ことは避けてください。代わりに :class:`multiprocessing.Queue` を使ってくださ"
+"い。"
 
 #: ../../library/logging.handlers.rst:1039
 msgid ""
@@ -1889,6 +1920,13 @@ msgid ""
 "by calling the handler's :meth:`format` method), and sets the :attr:`args`, :"
 "attr:`exc_info` and :attr:`exc_text` attributes to ``None``."
 msgstr ""
+"基底の実装はレコードがメッセージや引数と、またもし存在すれば、発生した例外お"
+"よびスタック情報と統合されるようにフォーマットします。またこの実装では非 "
+"pickle 化不可能な要素をレコードから削除します。特に、この実装はレコードの :"
+"attr:`msg` と :attr:`message` 属性を (ハンドラの :meth:`format` メソッドを呼"
+"び出すことによって得られる) 統合されたメッセージで上書きし、同時に :attr:"
+"`args`, :attr:`exc_info`, :attr:`exc_text` の3つの属性値をすべて ``None`` に"
+"設定します。"
 
 #: ../../library/logging.handlers.rst:1059
 msgid ""
@@ -1915,6 +1953,19 @@ msgid ""
 "that you may have to consider not only your own code but also code in any "
 "libraries that you use.)"
 msgstr ""
+"基底の実装は、レコードを pickle 化可能にしつつ、さらなるフォーマット処理を防"
+"ぐために、メッセージを引数でフォーマットしてフォーマットされたメッセージを "
+"``message`` と ``msg`` 属性に設定し、同時に ``args`` と ``exc_text`` 属性を "
+"``None`` に設定します。このことは、 :class:`QueueListener` 側のハンドラが必要"
+"なフォーマット処理を行う、たとえば例外のフォーマット処理を行う、ための必要な"
+"情報が得られないかもしれないことを意味します。そのため、 ``QueueHandler`` の"
+"派生クラスにおいてこのメソッドを、たとえば ``exc_text`` 属性が ``None`` に設"
+"定されないように、オーバーライドしたいと考えるかもしれません。この場合、 "
+"``message`` / ``msg`` / ``args`` といった属性の変更はレコードが pickle 化可能"
+"であることを保証することと関係しており、元の ``args`` の値が pickle 化可能か"
+"どうかによって、これらの属性の変更が避けられないかもしれないということに注意"
+"してください (この点については、自分のコードだけでなく依存するライブラリの"
+"コードも考慮しなければならないことにも注意してください)"
 
 #: ../../library/logging.handlers.rst:1079
 msgid ""
diff --git a/reference/lexical_analysis.po b/reference/lexical_analysis.po
@@ -560,7 +560,7 @@ msgid ""
 "statement, but this distinction is done at the parser level, not when "
 "tokenizing."
 msgstr ""
-"特定のコンテキストのも元でだけ予約される識別子があります。\n"
+"特定のコンテキストの元でだけ予約される識別子があります。\n"
 "それらは *ソフトキーワード* として知られています。\n"
 "識別子 ``match``, ``case``, ``_`` は、パターンマッチング文に関係するコンテキ"
 "ストの元でキーワードとして構文に沿って働きますが、このキーワードになるかなら"
