@@ -72,14 +72,17 @@ msgstr ""
7272
7373#: ../../library/logging.rst:33
7474msgid "The simplest example:"
75- msgstr ""
75+ msgstr "もっとも単純な例: "
7676
7777#: ../../library/logging.rst:41
7878msgid ""
7979"The module provides a lot of functionality and flexibility. If you are "
8080"unfamiliar with logging, the best way to get to grips with it is to view the "
8181"tutorials (**see the links above and on the right**)."
8282msgstr ""
83+ "このモジュールは、多くの機能性と柔軟性を提供します。ロギングに慣れていないな"
84+ "ら、使い方を理解する最良の方法はチュートリアルを読むことです (**右上のリンク"
85+ "を参照してください**)。"
8386
8487#: ../../library/logging.rst:45
8588msgid ""
@@ -185,6 +188,14 @@ msgid ""
185188"false, then that is the last logger whose handlers are offered the event to "
186189"handle, and propagation stops at that point."
187190msgstr ""
191+ "具体的な例で説明します: ``A.B.C`` という名前のロガーの propagate 属性が真と評"
192+ "価された場合、 ``logging.getLogger('A.B.C').error(...)`` のようなメソッドの呼"
193+ "び出しを通じて ``A.B.C`` に記録された全てのイベントは、 [ログレベルとフィルタ"
194+ "の設定を満たした場合に限り] 最初に ``A.B.C`` に接続されたハンドラに渡され、そ"
195+ "の後 ``A.B``, ``A`` という名前のロガー、そしてルートロガーという順番で各ロ"
196+ "ガーに接続されたハンドラに渡されます。この連鎖構造において ``A.B.C``, ``A."
197+ "B``, ``A`` のいずれかの ``propagate`` 属性が偽に設定された場合、そのロガーが"
198+ "イベントを処理する最後のロガーとなり、その時点でイベントの伝播は止まります。"
188199
189200#: ../../library/logging.rst:100
190201msgid "The constructor sets this attribute to ``True``."
@@ -434,6 +445,9 @@ msgid ""
434445"used by the logging system. (See the section on :ref:`logrecord-attributes` "
435446"for more information on which keys are used by the logging system.)"
436447msgstr ""
448+ "*extra* に渡される辞書のキーはロギングシステムで使われているものと衝突しては"
449+ "いけません。 (ロギングシステムが使うキーの詳細については :ref:`logrecord-"
450+ "attributes` の節を参照してください。)"
437451
438452#: ../../library/logging.rst:239
439453msgid ""
@@ -476,6 +490,9 @@ msgid ""
476490"into account the relevant :attr:`Logger.propagate` attributes), the message "
477491"will be sent to the handler set on :attr:`lastResort`."
478492msgstr ""
493+ "このロガー (および :attr:`Logger.propagate` 属性を考慮した上で実効的にイベン"
494+ "トが伝播する祖先のロガー) にハンドラが接続されていない場合、メッセージは :"
495+ "attr:`lastResort` に設定されたハンドラーに送られます。"
479496
480497#: ../../library/logging.rst:257 ../../library/logging.rst:1125
481498msgid "The *stack_info* parameter was added."
@@ -884,12 +901,19 @@ msgid ""
884901"logging API which might do locking, because that might result in a deadlock. "
885902"Specifically:"
886903msgstr ""
904+ "このメソッドはハンドラレベルのロックを取得した後で呼び出されます。また、ロッ"
905+ "クはこのメソッドがリターンした後で解放されます。このメソッドをオーバーライド"
906+ "する場合、ロックを取得する可能性のある logging API の他の関数やメソッドの呼び"
907+ "出しに注意してください。そのような実装はデッドロックを引き起こす可能性があり"
908+ "ます。特に以下の点に注意してください:"
887909
888910#: ../../library/logging.rst:531
889911msgid ""
890912"Logging configuration APIs acquire the module-level lock, and then "
891913"individual handler-level locks as those handlers are configured."
892914msgstr ""
915+ "ロギングを構成するための API はモジュールレベルのロックを取得し、その後ハンド"
916+ "ラを構成する際に個々のハンドラに対してハンドラレベルのロックを取得します。"
893917
894918#: ../../library/logging.rst:534
895919msgid ""
@@ -900,6 +924,13 @@ msgid ""
900924"the module-level lock *after* the handler-level lock (because in this "
901925"method, the handler-level lock has already been acquired)."
902926msgstr ""
927+ "多くのロギング API はモジュールレベルのロックを取得します。そのような API が"
928+ "このメソッドから呼ばれた場合、他のスレッドからロギングを構成するための API 呼"
929+ "び出しが行われたときにデッドロックに陥る可能性があります。これは他のスレッド"
930+ "がハンドラレベルのロックを取得する *前に* モジュールレベルのロックを取得しよ"
931+ "うとする一方で、 (このメソッドはハンドラレベルのロックが既に取得された状態で"
932+ "呼び出されているため) このメソッドを呼び出したスレッドはハンドラレベルのロッ"
933+ "クを取得した *後で* モジュールレベルのロックを取得しようとするためです。 "
903934
904935#: ../../library/logging.rst:541
905936msgid ""
@@ -1151,6 +1182,11 @@ msgid ""
11511182"specified, the default formatter (which just outputs the event message) is "
11521183"used as the line formatter."
11531184msgstr ""
1185+ "複数のレコードをまとめてフォーマットしたい場合のクラス定義に適した基底クラス"
1186+ "です。各行 (単一のレコードに相当します) をフォーマットするために使う :class:"
1187+ "`Formatter` インスタンスを渡すことができます。特に指定がない場合はデフォルト"
1188+ "のフォーマッタ (イベントのメッセージだけを出力するフォーマッタ) が使われま"
1189+ "す。"
11541190
11551191#: ../../library/logging.rst:681
11561192msgid ""
@@ -1159,13 +1195,20 @@ msgid ""
11591195"specific behaviour, e.g. to show the count of records, a title or a "
11601196"separator line."
11611197msgstr ""
1198+ "*複数のレコード* のリストに対するヘッダを返します。基底クラスの実装は単に空の"
1199+ "文字列を返すだけです。レコード数やタイトルを表示したり、あるいはセパレータ行"
1200+ "したいなど、ヘッダに対して特別な振る舞いが必要な場合はこのメソッドをオーバー"
1201+ "ライドする必要があります。"
11621202
11631203#: ../../library/logging.rst:688
11641204msgid ""
11651205"Return a footer for a list of *records*. The base implementation just "
11661206"returns the empty string. You will need to override this method if you want "
11671207"specific behaviour, e.g. to show the count of records or a separator line."
11681208msgstr ""
1209+ "*複数のレコード* のリストに対するフッタを返します。基底クラスの実装は単に空の"
1210+ "文字列を返すだけです。レコード数やセパレータ行の表示など、フッタに対して特別"
1211+ "な振る舞いが必要な場合はこのメソッドをオーバーライドする必要があります。"
11691212
11701213#: ../../library/logging.rst:695
11711214msgid ""
@@ -1174,6 +1217,10 @@ msgid ""
11741217"concatenation of the header, each record formatted with the line formatter, "
11751218"and the footer."
11761219msgstr ""
1220+ "*複数のレコード* のリストに対するフォーマット済みテキストを返します。基底クラ"
1221+ "スの実装は、レコードがなければ空の文字列を返し、レコードがある場合はヘッダ、"
1222+ "単一のレコードをフォーマットするためのラインフォーマッタで各レコードをフォー"
1223+ "マットした文字列、そしてフッタを全て連結したものを返します。"
11771224
11781225#: ../../library/logging.rst:703
11791226msgid "Filter Objects"
@@ -1303,6 +1350,8 @@ msgid ""
13031350"The primary information is passed in *msg* and *args*, which are combined "
13041351"using ``msg % args`` to create the :attr:`!message` attribute of the record."
13051352msgstr ""
1353+ "もっとも重要な情報は *msg* と *args* に渡され、 ``msg % args`` で結合されてレ"
1354+ "コードの :attr:`!message` 属性を生成します。"
13061355
13071356#: ../../library/logging.rst:0
13081357msgid "Parameters"
@@ -1315,6 +1364,9 @@ msgid ""
13151364"have this value, even though it may be emitted by a handler attached to a "
13161365"different (ancestor) logger."
13171366msgstr ""
1367+ "この :class:`!LogRecord` であらわされるイベントを記録したロガーの名前です。 :"
1368+ "class:`!LogRecord` が持つロガーの名前は、たとえ異なる (祖先の) ロガーに接続さ"
1369+ "れたハンドラから出力されたとしても、常に同じ値を持つことに注意してください。"
13181370
13191371#: ../../library/logging.rst:783
13201372msgid ""
@@ -1323,11 +1375,17 @@ msgid ""
13231375"attributes of the LogRecord: :attr:`!levelno` for the numeric value and :"
13241376"attr:`!levelname` for the corresponding level name."
13251377msgstr ""
1378+ "記録されたイベントの :ref:`数値であらわしたロギングレベル <levels>` (``10`` "
1379+ "が ``DEBUG``, ``20`` が ``INFO`` など) です。このパラメータは LogRecord の *2"
1380+ "つの* 属性に変換されることに注意してください: 数値は :attr:`!levelno` に、ま"
1381+ "た対応するログレベルの名前は :attr:`!levelname` に保持されます。"
13261382
13271383#: ../../library/logging.rst:790
13281384msgid ""
13291385"The full string path of the source file where the logging call was made."
13301386msgstr ""
1387+ "ロギングの呼び出しが行われたソースファイルへの完全なパス名をあらわす文字列で"
1388+ "す。"
13311389
13321390#: ../../library/logging.rst:794
13331391msgid "The line number in the source file where the logging call was made."
@@ -1338,6 +1396,8 @@ msgid ""
13381396"The event description message, which can be a %-format string with "
13391397"placeholders for variable data."
13401398msgstr ""
1399+ "イベントを記述するメッセージです。変数データのプレースホルダを伴う %-f 形式の"
1400+ "書式文字列のこともあります。"
13411401
13421402#: ../../library/logging.rst:802
13431403msgid ""
@@ -1350,6 +1410,8 @@ msgid ""
13501410"An exception tuple with the current exception information, as returned by :"
13511411"func:`sys.exc_info`, or ``None`` if no exception information is available."
13521412msgstr ""
1413+ ":func:`sys.exc_info` によって返される現在の例外情報を含む例外タプルです。例外"
1414+ "情報がない場合は ``None`` です。"
13531415
13541416#: ../../library/logging.rst:811
13551417msgid ""
@@ -2013,6 +2075,9 @@ msgid ""
20132075"func:`critical`) will call :func:`basicConfig` if the root logger doesn't "
20142076"have any handler attached."
20152077msgstr ""
2078+ "ルートロガーにハンドラが接続されていない場合、この関数 (および :func:"
2079+ "`info`, :func:`warning`, :func:`error` そして :func:`critical`) は :func:"
2080+ "`basicConfig` を呼び出します。"
20162081
20172082#: ../../library/logging.rst:1130
20182083msgid ""
@@ -2658,6 +2723,8 @@ msgid ""
26582723"`Original Python logging package <https://old.red-dove.com/python_logging."
26592724"html>`_"
26602725msgstr ""
2726+ "`Python の最初のロギングパッケージ <https://old.red-dove.com/python_logging."
2727+ "html>`_"
26612728
26622729#: ../../library/logging.rst:1443
26632730msgid ""