Merge 3.11 into 3.10

github-actions · github-actions · commit 7792af64a039 · 2023-03-13T23:50:48.000Z
diff --git a/howto/logging-cookbook.po b/howto/logging-cookbook.po
@@ -277,18 +277,27 @@ msgid ""
 "filter_maker`` in the filter configuration. You will need to change that if "
 "you define it in a different module."
 msgstr ""
+"この関数は引数として与えられた文字列をログレベルの数値に変換し、ログレコード"
+"内のログレベルが指定されたレベル以下の場合に ``True`` を返す関数を返します。"
+"この例では ``filter_maker`` をコマンドラインから実行するテストスクリプト "
+"``main.py`` で関数が定義されているため、フィルター設定上のモジュール名は "
+"``__main__`` になります。そのためフィルター設定の中では ``__main__."
+"filter_maker`` となります。異なるモジュールで関数を定義した場合、この部分を変"
+"更する必要があります。"
 
 #: ../../howto/logging-cookbook.rst:383
 msgid "With the filter added, we can run ``main.py``, which in full is:"
 msgstr ""
+"フィルターを追加した ``main.py`` の全体像は以下のようになり、これで実行できる"
+"状態になりました:"
 
 #: ../../howto/logging-cookbook.rst:453
 msgid "And after running it like this:"
-msgstr ""
+msgstr "これを以下のように実行します:"
 
 #: ../../howto/logging-cookbook.rst:459
 msgid "We can see the results are as expected:"
-msgstr ""
+msgstr "すると期待通りの結果を得ることができます:"
 
 #: ../../howto/logging-cookbook.rst:485
 msgid "Configuration server example"
@@ -409,6 +418,14 @@ msgid ""
 "application, to use the above approach for logging, so that any blocking "
 "code runs only in the ``QueueListener`` thread."
 msgstr ""
+"上述の議論は特に同期コードにについてのものではなく、むしろ遅いロギングハンド"
+"ラについてでしたが、非同期コードやネットワーク、あるいはファイルハンドラから"
+"のロギングでさえも (イベントループをブロックしてしまう) 問題につながる可能性"
+"があることには注意すべきでしょう。これはいくつかのロギングが  :mod:`asyncio` "
+"内部で行われることが理由です。何らかの非同期コードがアプリケーションの中で使"
+"われている場合、ロギングには上記のアプローチを使っていかなるブロッキングコー"
+"ドも ``QueueListener`` スレッド内だけで実行されるようにしておくことが最も良い"
+"でしょう。"
 
 #: ../../howto/logging-cookbook.rst:615
 msgid ""
@@ -477,7 +494,7 @@ msgstr ""
 
 #: ../../howto/logging-cookbook.rst:766
 msgid "Running a logging socket listener in production"
-msgstr ""
+msgstr "作成中のロギングソケットのリスナーを実行する"
 
 #: ../../howto/logging-cookbook.rst:770
 msgid ""
@@ -486,78 +503,87 @@ msgid ""
 "Gist <socket-listener-gist_>`__ which provides the bare-bones files to run "
 "the above functionality using Supervisor. It consists of the following files:"
 msgstr ""
+"作成中のロギングリスナーを実行するためには、 `Supervisor <http://supervisord."
+"org/>`_ のようなプロセス管理ツールを使う必要があるかもしれません。 `こちらの "
+"Gist <socket-listener-gist_>`__ は Supervisor を使って上記の機能を実行するた"
+"めの必要最低限のファイルを提供しています。以下のファイルが必要になります:"
 
 #: ../../howto/logging-cookbook.rst:777
 msgid "File"
-msgstr ""
+msgstr "ファイル"
 
 #: ../../howto/logging-cookbook.rst:777
 msgid "Purpose"
 msgstr "目的"
 
 #: ../../howto/logging-cookbook.rst:779
 msgid ":file:`prepare.sh`"
-msgstr ""
+msgstr ":file:`prepare.sh`"
 
 #: ../../howto/logging-cookbook.rst:779
 msgid "A Bash script to prepare the environment for testing"
-msgstr ""
+msgstr "試験用の環境を準備する Bash スクリプト"
 
 #: ../../howto/logging-cookbook.rst:782
 msgid ":file:`supervisor.conf`"
-msgstr ""
+msgstr ":file:`supervisor.conf`"
 
 #: ../../howto/logging-cookbook.rst:782
 msgid ""
 "The Supervisor configuration file, which has entries for the listener and a "
 "multi-process web application"
 msgstr ""
+"リスナーとマルチプロセスの web アプリケーションのための設定を含む Supervisor "
+"の設定ファイル"
 
 #: ../../howto/logging-cookbook.rst:786
 msgid ":file:`ensure_app.sh`"
-msgstr ""
+msgstr ":file:`ensure_app.sh`"
 
 #: ../../howto/logging-cookbook.rst:786
 msgid ""
 "A Bash script to ensure that Supervisor is running with the above "
 "configuration"
 msgstr ""
+"Supervisor が上記の設定で実行されていることを保証するための Bash スクリプト"
 
 #: ../../howto/logging-cookbook.rst:789
 msgid ":file:`log_listener.py`"
-msgstr ""
+msgstr ":file:`log_listener.py`"
 
 #: ../../howto/logging-cookbook.rst:789
 msgid ""
 "The socket listener program which receives log events and records them to a "
 "file"
-msgstr ""
+msgstr "ログイベントを受信してファイルに記録するソケットリスナープログラム"
 
 #: ../../howto/logging-cookbook.rst:792
 msgid ":file:`main.py`"
-msgstr ""
+msgstr ":file:`main.py`"
 
 #: ../../howto/logging-cookbook.rst:792
 msgid ""
 "A simple web application which performs logging via a socket connected to "
 "the listener"
 msgstr ""
+"リスナーに接続されたソケットを通じてロギングを実行する簡単な web アプリケー"
+"ション"
 
 #: ../../howto/logging-cookbook.rst:795
 msgid ":file:`webapp.json`"
-msgstr ""
+msgstr ":file:`webapp.json`"
 
 #: ../../howto/logging-cookbook.rst:795
 msgid "A JSON configuration file for the web application"
-msgstr ""
+msgstr "web アプリケーションのための JSON 設定ファイル"
 
 #: ../../howto/logging-cookbook.rst:797
 msgid ":file:`client.py`"
-msgstr ""
+msgstr ":file:`client.py`"
 
 #: ../../howto/logging-cookbook.rst:797
 msgid "A Python script to exercise the web application"
-msgstr ""
+msgstr "web アプリケーションを起動するための Python スクリプト"
 
 #: ../../howto/logging-cookbook.rst:800
 msgid ""
@@ -567,20 +593,28 @@ msgid ""
 "same log file without conflicting with one another --- they all go through "
 "the socket listener."
 msgstr ""
+"この web アプリケーションは、リクエストを処理する複数のワーカープロセスを起動"
+"する web アプリケーションサーバーである `Gunicorn <https://gunicorn.org/>`_ "
+"を使っています。ここに例として挙げた設定は、複数のワーカーがいかにして互いに"
+"衝突することなく同じログファイルに書き込みを行うことができるかを示しています "
+"--- ワーカーは全てソケットリスナーを通じてログを書き込むのです。"
 
 #: ../../howto/logging-cookbook.rst:805
 msgid "To test these files, do the following in a POSIX environment:"
 msgstr ""
+"これらのファイルを試すためには、 POSIX 環境において以下を行なってください:"
 
 #: ../../howto/logging-cookbook.rst:807
 msgid ""
 "Download `the Gist <socket-listener-gist_>`__ as a ZIP archive using the :"
 "guilabel:`Download ZIP` button."
 msgstr ""
+":guilabel:`Download ZIP` ボタンを押して `Gist <socket-listener-gist_>`__ を "
+"ZIP アーカイブとしてダウンロードしてください。"
 
 #: ../../howto/logging-cookbook.rst:810
 msgid "Unzip the above files from the archive into a scratch directory."
-msgstr ""
+msgstr "アーカイブファイルをスクラッチディレクトリに展開してください。"
 
 #: ../../howto/logging-cookbook.rst:812
 msgid ""
@@ -589,18 +623,27 @@ msgid ""
 "files, and a :file:`venv` subdirectory to contain a virtual environment into "
 "which ``bottle``, ``gunicorn`` and ``supervisor`` are installed."
 msgstr ""
+"準備のために、スクラッチディレクトリにおいて ``bash prepare.sh`` を実行してく"
+"ださい。これにより Supervisor 関連のファイルおよびログファイルのための :file:"
+"`run` サブディレクトリ、および ``bottle``, ``gunicorn`` そして "
+"``supervisor`` がインストールされる仮想環境を含む :file:`venv` サブディレクト"
+"リが生成されます。"
 
 #: ../../howto/logging-cookbook.rst:817
 msgid ""
 "Run ``bash ensure_app.sh`` to ensure that Supervisor is running with the "
 "above configuration."
 msgstr ""
+"``bash ensure_app.sh`` を実行して Supervisor が上記の設定で実行されていること"
+"を確認してください。"
 
 #: ../../howto/logging-cookbook.rst:820
 msgid ""
 "Run ``venv/bin/python client.py`` to exercise the web application, which "
 "will lead to records being written to the log."
 msgstr ""
+"``venv/bin/python client.py`` を実行して web アプリケーションを起動してくださ"
+"い。これによりログにレコードが書き込まれるはずです。"
 
 #: ../../howto/logging-cookbook.rst:823
 msgid ""
@@ -609,18 +652,26 @@ msgid ""
 "won't be in any particular order, since they have been handled concurrently "
 "by different worker processes in a non-deterministic way."
 msgstr ""
+":file:`run` サブディレクトリにあるログファイルを調べてください。最新のログ"
+"は、パターン :file:`app.log*` に一致する名前のファイルにあるはずです。ログは"
+"異なるワーカープロセスによって非決定論的な形で並行に処理されるため、特定の決"
+"まった順番にはなりません。"
 
 #: ../../howto/logging-cookbook.rst:828
 msgid ""
 "You can shut down the listener and the web application by running ``venv/bin/"
 "supervisorctl -c supervisor.conf shutdown``."
 msgstr ""
+"リスナーと web アプリケーションは ``venv/bin/supervisorctl -c supervisor."
+"conf shutdown`` を実行することでシャットダウンできます。"
 
 #: ../../howto/logging-cookbook.rst:831
 msgid ""
 "You may need to tweak the configuration files in the unlikely event that the "
 "configured ports clash with something else in your test environment."
 msgstr ""
+"ありそうもないことですが、テスト環境で設定したポートが別の設定と衝突してし"
+"まった場合、設定ファイルを修正する必要があるかもしれません。"
 
 #: ../../howto/logging-cookbook.rst:837
 msgid "Adding contextual information to your logging output"
@@ -802,7 +853,7 @@ msgstr "実行すると、以下のようになります:"
 
 #: ../../howto/logging-cookbook.rst:996
 msgid "Use of ``contextvars``"
-msgstr ""
+msgstr "``contextvars`` の利用"
 
 #: ../../howto/logging-cookbook.rst:998
 msgid ""
@@ -813,6 +864,12 @@ msgid ""
 "logs can populated with contextual information such as, for example, request "
 "attributes handled by web applications."
 msgstr ""
+"Python 3.7 以降、 :mod:`contextvars` モジュールは :mod:`threading` と :mod:"
+"`asyncio` の両方の処理上のニーズを満たすコンテキストローカルな変数を提供して"
+"います。このタイプの変数はスレッドローカルな変数に適しています。以下の例は、"
+"マルチスレッド環境において、 いかにして web アプリケーションによって処理され"
+"るリクエスト属性のような処理の文脈上の情報とともにログを投入できるかを示しま"
+"す。"
 
 #: ../../howto/logging-cookbook.rst:1004
 msgid ""
