diff --git a/library/logging.po b/library/logging.po index 1f9b094f1a..008d633cb5 100644 --- a/library/logging.po +++ b/library/logging.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-12-01 00:17+0000\n" +"POT-Creation-Date: 2025-12-26 00:15+0000\n" "PO-Revision-Date: 2024-03-28 22:40+0800\n" "Last-Translator: RockLeon \n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" @@ -1317,11 +1317,11 @@ msgstr "" msgid "Attribute name" msgstr "屬性名稱" -#: ../../library/logging.rst:995 ../../library/logging.rst:1370 +#: ../../library/logging.rst:995 ../../library/logging.rst:1375 msgid "Format" msgstr "格式" -#: ../../library/logging.rst:995 ../../library/logging.rst:1370 +#: ../../library/logging.rst:995 ../../library/logging.rst:1375 msgid "Description" msgstr "描述" @@ -1330,7 +1330,8 @@ msgid "args" msgstr "args" #: ../../library/logging.rst:997 ../../library/logging.rst:1011 -#: ../../library/logging.rst:1039 ../../library/logging.rst:1057 +#: ../../library/logging.rst:1014 ../../library/logging.rst:1044 +#: ../../library/logging.rst:1062 msgid "You shouldn't need to format this yourself." msgstr "你不應該需要自己格式化它。" @@ -1381,250 +1382,260 @@ msgid "" msgstr "" #: ../../library/logging.rst:1014 +msgid "exc_text" +msgstr "" + +#: ../../library/logging.rst:1014 +msgid "" +"Exception information formatted as a string. This is set when :meth:" +"`Formatter.format` is invoked, or ``None`` if no exception has occurred." +msgstr "" + +#: ../../library/logging.rst:1019 msgid "filename" msgstr "filename" -#: ../../library/logging.rst:1014 +#: ../../library/logging.rst:1019 msgid "``%(filename)s``" msgstr "``%(filename)s``" -#: ../../library/logging.rst:1014 +#: ../../library/logging.rst:1019 msgid "Filename portion of ``pathname``." msgstr "``pathname`` 的檔案名稱部分。" -#: ../../library/logging.rst:1016 +#: ../../library/logging.rst:1021 msgid "funcName" msgstr "funcName" -#: ../../library/logging.rst:1016 +#: ../../library/logging.rst:1021 msgid "``%(funcName)s``" msgstr "``%(funcName)s``" -#: ../../library/logging.rst:1016 +#: ../../library/logging.rst:1021 msgid "Name of function containing the logging call." msgstr "" -#: ../../library/logging.rst:1018 +#: ../../library/logging.rst:1023 msgid "levelname" msgstr "levelname" -#: ../../library/logging.rst:1018 +#: ../../library/logging.rst:1023 msgid "``%(levelname)s``" msgstr "``%(levelname)s``" -#: ../../library/logging.rst:1018 +#: ../../library/logging.rst:1023 msgid "" "Text logging level for the message (``'DEBUG'``, ``'INFO'``, ``'WARNING'``, " "``'ERROR'``, ``'CRITICAL'``)." msgstr "" -#: ../../library/logging.rst:1022 +#: ../../library/logging.rst:1027 msgid "levelno" msgstr "levelno" -#: ../../library/logging.rst:1022 +#: ../../library/logging.rst:1027 msgid "``%(levelno)s``" msgstr "``%(levelno)s``" -#: ../../library/logging.rst:1022 +#: ../../library/logging.rst:1027 msgid "" "Numeric logging level for the message (:const:`DEBUG`, :const:`INFO`, :const:" "`WARNING`, :const:`ERROR`, :const:`CRITICAL`)." msgstr "" -#: ../../library/logging.rst:1027 +#: ../../library/logging.rst:1032 msgid "lineno" msgstr "lineno" -#: ../../library/logging.rst:1027 +#: ../../library/logging.rst:1032 msgid "``%(lineno)d``" msgstr "``%(lineno)d``" -#: ../../library/logging.rst:1027 +#: ../../library/logging.rst:1032 msgid "Source line number where the logging call was issued (if available)." msgstr "" -#: ../../library/logging.rst:1030 +#: ../../library/logging.rst:1035 msgid "message" msgstr "message" -#: ../../library/logging.rst:1030 +#: ../../library/logging.rst:1035 msgid "``%(message)s``" msgstr "``%(message)s``" -#: ../../library/logging.rst:1030 +#: ../../library/logging.rst:1035 msgid "" "The logged message, computed as ``msg % args``. This is set when :meth:" "`Formatter.format` is invoked." msgstr "" -#: ../../library/logging.rst:1034 +#: ../../library/logging.rst:1039 msgid "module" msgstr "模組" -#: ../../library/logging.rst:1034 +#: ../../library/logging.rst:1039 msgid "``%(module)s``" msgstr "``%(module)s``" -#: ../../library/logging.rst:1034 +#: ../../library/logging.rst:1039 msgid "Module (name portion of ``filename``)." msgstr "模組（``filename`` 的名稱部分）。" -#: ../../library/logging.rst:1036 +#: ../../library/logging.rst:1041 msgid "msecs" msgstr "msecs" -#: ../../library/logging.rst:1036 +#: ../../library/logging.rst:1041 msgid "``%(msecs)d``" msgstr "``%(msecs)d``" -#: ../../library/logging.rst:1036 +#: ../../library/logging.rst:1041 msgid "" "Millisecond portion of the time when the :class:`LogRecord` was created." msgstr "" -#: ../../library/logging.rst:0 ../../library/logging.rst:1039 +#: ../../library/logging.rst:0 ../../library/logging.rst:1044 msgid "msg" msgstr "msg" -#: ../../library/logging.rst:1039 +#: ../../library/logging.rst:1044 msgid "" "The format string passed in the original logging call. Merged with ``args`` " "to produce ``message``, or an arbitrary object (see :ref:`arbitrary-object-" "messages`)." msgstr "" -#: ../../library/logging.rst:0 ../../library/logging.rst:1044 +#: ../../library/logging.rst:0 ../../library/logging.rst:1049 msgid "name" msgstr "name" -#: ../../library/logging.rst:1044 +#: ../../library/logging.rst:1049 msgid "``%(name)s``" msgstr "``%(name)s``" -#: ../../library/logging.rst:1044 +#: ../../library/logging.rst:1049 msgid "Name of the logger used to log the call." msgstr "" -#: ../../library/logging.rst:1046 +#: ../../library/logging.rst:1051 msgid "pathname" msgstr "pathname" -#: ../../library/logging.rst:1046 +#: ../../library/logging.rst:1051 msgid "``%(pathname)s``" msgstr "``%(pathname)s``" -#: ../../library/logging.rst:1046 +#: ../../library/logging.rst:1051 msgid "" "Full pathname of the source file where the logging call was issued (if " "available)." msgstr "" -#: ../../library/logging.rst:1049 +#: ../../library/logging.rst:1054 msgid "process" msgstr "process" -#: ../../library/logging.rst:1049 +#: ../../library/logging.rst:1054 msgid "``%(process)d``" msgstr "``%(process)d``" -#: ../../library/logging.rst:1049 +#: ../../library/logging.rst:1054 msgid "Process ID (if available)." msgstr "行程 ID（如果可用）。" -#: ../../library/logging.rst:1051 +#: ../../library/logging.rst:1056 msgid "processName" msgstr "processName" -#: ../../library/logging.rst:1051 +#: ../../library/logging.rst:1056 msgid "``%(processName)s``" msgstr "``%(processName)s``" -#: ../../library/logging.rst:1051 +#: ../../library/logging.rst:1056 msgid "Process name (if available)." msgstr "行程名稱（如果可用）。" -#: ../../library/logging.rst:1053 +#: ../../library/logging.rst:1058 msgid "relativeCreated" msgstr "relativeCreated" -#: ../../library/logging.rst:1053 +#: ../../library/logging.rst:1058 msgid "``%(relativeCreated)d``" msgstr "``%(relativeCreated)d``" -#: ../../library/logging.rst:1053 +#: ../../library/logging.rst:1058 msgid "" "Time in milliseconds when the LogRecord was created, relative to the time " "the logging module was loaded." msgstr "" -#: ../../library/logging.rst:1057 +#: ../../library/logging.rst:1062 msgid "stack_info" msgstr "stack_info" -#: ../../library/logging.rst:1057 +#: ../../library/logging.rst:1062 msgid "" "Stack frame information (where available) from the bottom of the stack in " "the current thread, up to and including the stack frame of the logging call " "which resulted in the creation of this record." msgstr "" -#: ../../library/logging.rst:1063 +#: ../../library/logging.rst:1068 msgid "thread" msgstr "thread" -#: ../../library/logging.rst:1063 +#: ../../library/logging.rst:1068 msgid "``%(thread)d``" msgstr "``%(thread)d``" -#: ../../library/logging.rst:1063 +#: ../../library/logging.rst:1068 msgid "Thread ID (if available)." msgstr "執行緒 ID（如果可用）。" -#: ../../library/logging.rst:1065 +#: ../../library/logging.rst:1070 msgid "threadName" msgstr "threadName" -#: ../../library/logging.rst:1065 +#: ../../library/logging.rst:1070 msgid "``%(threadName)s``" msgstr "``%(threadName)s``" -#: ../../library/logging.rst:1065 +#: ../../library/logging.rst:1070 msgid "Thread name (if available)." msgstr "" -#: ../../library/logging.rst:1067 +#: ../../library/logging.rst:1072 msgid "taskName" msgstr "taskName" -#: ../../library/logging.rst:1067 +#: ../../library/logging.rst:1072 msgid "``%(taskName)s``" msgstr "``%(taskName)s``" -#: ../../library/logging.rst:1067 +#: ../../library/logging.rst:1072 msgid ":class:`asyncio.Task` name (if available)." msgstr "" -#: ../../library/logging.rst:1070 +#: ../../library/logging.rst:1075 msgid "*processName* was added." msgstr "新增 *processName*。" -#: ../../library/logging.rst:1073 +#: ../../library/logging.rst:1078 msgid "*taskName* was added." msgstr "新增 *taskName*。" -#: ../../library/logging.rst:1079 +#: ../../library/logging.rst:1084 msgid "LoggerAdapter Objects" msgstr "LoggerAdapter 物件" -#: ../../library/logging.rst:1081 +#: ../../library/logging.rst:1086 msgid "" ":class:`LoggerAdapter` instances are used to conveniently pass contextual " "information into logging calls. For a usage example, see the section on :ref:" "`adding contextual information to your logging output `." msgstr "" -#: ../../library/logging.rst:1087 +#: ../../library/logging.rst:1092 msgid "" "Returns an instance of :class:`LoggerAdapter` initialized with an " "underlying :class:`Logger` instance, an optional dict-like object (*extra*), " @@ -1635,7 +1646,7 @@ msgid "" "`LoggerAdapter` instance" msgstr "" -#: ../../library/logging.rst:1097 +#: ../../library/logging.rst:1102 msgid "" "Modifies the message and/or keyword arguments passed to a logging call in " "order to insert contextual information. This implementation takes the object " @@ -1644,15 +1655,15 @@ msgid "" "(possibly modified) versions of the arguments passed in." msgstr "" -#: ../../library/logging.rst:1105 +#: ../../library/logging.rst:1110 msgid "Delegates to the underlying :attr:`!manager` on *logger*." msgstr "" -#: ../../library/logging.rst:1109 +#: ../../library/logging.rst:1114 msgid "Delegates to the underlying :meth:`!_log` method on *logger*." msgstr "" -#: ../../library/logging.rst:1111 +#: ../../library/logging.rst:1116 msgid "" "In addition to the above, :class:`LoggerAdapter` supports the following " "methods of :class:`Logger`: :meth:`~Logger.debug`, :meth:`~Logger.info`, :" @@ -1664,32 +1675,32 @@ msgid "" "interchangeably." msgstr "" -#: ../../library/logging.rst:1122 +#: ../../library/logging.rst:1127 msgid "" "The :meth:`~Logger.isEnabledFor`, :meth:`~Logger.getEffectiveLevel`, :meth:" "`~Logger.setLevel` and :meth:`~Logger.hasHandlers` methods were added to :" "class:`LoggerAdapter`. These methods delegate to the underlying logger." msgstr "" -#: ../../library/logging.rst:1128 +#: ../../library/logging.rst:1133 msgid "" "Attribute :attr:`!manager` and method :meth:`!_log` were added, which " "delegate to the underlying logger and allow adapters to be nested." msgstr "" -#: ../../library/logging.rst:1133 +#: ../../library/logging.rst:1138 msgid "The *extra* argument is now optional." msgstr "*extra* 引數現在是可選的。" -#: ../../library/logging.rst:1137 +#: ../../library/logging.rst:1142 msgid "The *merge_extra* parameter was added." msgstr "新增 *merge_extra* 參數。" -#: ../../library/logging.rst:1141 +#: ../../library/logging.rst:1146 msgid "Thread Safety" msgstr "執行緒安全" -#: ../../library/logging.rst:1143 +#: ../../library/logging.rst:1148 msgid "" "The logging module is intended to be thread-safe without any special work " "needing to be done by its clients. It achieves this through using threading " @@ -1698,7 +1709,7 @@ msgid "" "O." msgstr "" -#: ../../library/logging.rst:1148 +#: ../../library/logging.rst:1153 msgid "" "If you are implementing asynchronous signal handlers using the :mod:`signal` " "module, you may not be able to use logging from within such handlers. This " @@ -1706,17 +1717,17 @@ msgid "" "always re-entrant, and so cannot be invoked from such signal handlers." msgstr "" -#: ../../library/logging.rst:1155 +#: ../../library/logging.rst:1160 msgid "Module-Level Functions" msgstr "模組層級函式" -#: ../../library/logging.rst:1157 +#: ../../library/logging.rst:1162 msgid "" "In addition to the classes described above, there are a number of module-" "level functions." msgstr "" -#: ../../library/logging.rst:1163 +#: ../../library/logging.rst:1168 msgid "" "Return a logger with the specified name or, if name is ``None``, return the " "root logger of the hierarchy. If specified, the name is typically a dot-" @@ -1726,14 +1737,14 @@ msgid "" "for not doing that, as mentioned in :ref:`logger`." msgstr "" -#: ../../library/logging.rst:1170 +#: ../../library/logging.rst:1175 msgid "" "All calls to this function with a given name return the same logger " "instance. This means that logger instances never need to be passed between " "different parts of an application." msgstr "" -#: ../../library/logging.rst:1177 +#: ../../library/logging.rst:1182 msgid "" "Return either the standard :class:`Logger` class, or the last class passed " "to :func:`setLoggerClass`. This function may be called from within a new " @@ -1742,7 +1753,7 @@ msgid "" "example::" msgstr "" -#: ../../library/logging.rst:1182 +#: ../../library/logging.rst:1187 msgid "" "class MyLogger(logging.getLoggerClass()):\n" " # ... override behaviour here" @@ -1750,37 +1761,37 @@ msgstr "" "class MyLogger(logging.getLoggerClass()):\n" " # ... 在這裡覆蓋其行為" -#: ../../library/logging.rst:1188 +#: ../../library/logging.rst:1193 msgid "Return a callable which is used to create a :class:`LogRecord`." msgstr "" -#: ../../library/logging.rst:1190 +#: ../../library/logging.rst:1195 msgid "" "This function has been provided, along with :func:`setLogRecordFactory`, to " "allow developers more control over how the :class:`LogRecord` representing a " "logging event is constructed." msgstr "" -#: ../../library/logging.rst:1195 +#: ../../library/logging.rst:1200 msgid "" "See :func:`setLogRecordFactory` for more information about the how the " "factory is called." msgstr "" -#: ../../library/logging.rst:1200 +#: ../../library/logging.rst:1205 msgid "" "This is a convenience function that calls :meth:`Logger.debug`, on the root " "logger. The handling of the arguments is in every way identical to what is " "described in that method." msgstr "" -#: ../../library/logging.rst:1204 +#: ../../library/logging.rst:1209 msgid "" "The only difference is that if the root logger has no handlers, then :func:" "`basicConfig` is called, prior to calling ``debug`` on the root logger." msgstr "" -#: ../../library/logging.rst:1207 +#: ../../library/logging.rst:1212 msgid "" "For very short scripts or quick demonstrations of ``logging`` facilities, " "``debug`` and the other module-level functions may be convenient. However, " @@ -1790,38 +1801,38 @@ msgid "" "described at the beginning of this documentation." msgstr "" -#: ../../library/logging.rst:1217 +#: ../../library/logging.rst:1222 msgid "" "Logs a message with level :const:`INFO` on the root logger. The arguments " "and behavior are otherwise the same as for :func:`debug`." msgstr "" -#: ../../library/logging.rst:1223 +#: ../../library/logging.rst:1228 msgid "" "Logs a message with level :const:`WARNING` on the root logger. The arguments " "and behavior are otherwise the same as for :func:`debug`." msgstr "" -#: ../../library/logging.rst:1226 +#: ../../library/logging.rst:1231 msgid "" "There is an obsolete function ``warn`` which is functionally identical to " "``warning``. As ``warn`` is deprecated, please do not use it - use " "``warning`` instead." msgstr "" -#: ../../library/logging.rst:1233 +#: ../../library/logging.rst:1238 msgid "" "Logs a message with level :const:`ERROR` on the root logger. The arguments " "and behavior are otherwise the same as for :func:`debug`." msgstr "" -#: ../../library/logging.rst:1239 +#: ../../library/logging.rst:1244 msgid "" "Logs a message with level :const:`CRITICAL` on the root logger. The " "arguments and behavior are otherwise the same as for :func:`debug`." msgstr "" -#: ../../library/logging.rst:1245 +#: ../../library/logging.rst:1250 msgid "" "Logs a message with level :const:`ERROR` on the root logger. The arguments " "and behavior are otherwise the same as for :func:`debug`. Exception info is " @@ -1829,13 +1840,13 @@ msgid "" "exception handler." msgstr "" -#: ../../library/logging.rst:1251 +#: ../../library/logging.rst:1256 msgid "" "Logs a message with level *level* on the root logger. The arguments and " "behavior are otherwise the same as for :func:`debug`." msgstr "" -#: ../../library/logging.rst:1256 +#: ../../library/logging.rst:1261 msgid "" "Provides an overriding level *level* for all loggers which takes precedence " "over the logger's own level. When the need arises to temporarily throttle " @@ -1849,7 +1860,7 @@ msgid "" "individual loggers." msgstr "" -#: ../../library/logging.rst:1267 +#: ../../library/logging.rst:1272 msgid "" "Note that if you have defined any custom logging level higher than " "``CRITICAL`` (this is not recommended), you won't be able to rely on the " @@ -1857,13 +1868,13 @@ msgid "" "a suitable value." msgstr "" -#: ../../library/logging.rst:1272 +#: ../../library/logging.rst:1277 msgid "" "The *level* parameter was defaulted to level ``CRITICAL``. See :issue:" "`28524` for more information about this change." msgstr "" -#: ../../library/logging.rst:1278 +#: ../../library/logging.rst:1283 msgid "" "Associates level *level* with text *levelName* in an internal dictionary, " "which is used to map numeric levels to a textual representation, for example " @@ -1873,24 +1884,24 @@ msgid "" "and they should increase in increasing order of severity." msgstr "" -#: ../../library/logging.rst:1285 +#: ../../library/logging.rst:1290 msgid "" "If you are thinking of defining your own levels, please see the section on :" "ref:`custom-levels`." msgstr "" -#: ../../library/logging.rst:1290 +#: ../../library/logging.rst:1295 msgid "" "Returns a mapping from level names to their corresponding logging levels. " "For example, the string \"CRITICAL\" maps to :const:`CRITICAL`. The returned " "mapping is copied from an internal mapping on each call to this function." msgstr "" -#: ../../library/logging.rst:1298 +#: ../../library/logging.rst:1303 msgid "Returns the textual or numeric representation of logging level *level*." msgstr "" -#: ../../library/logging.rst:1300 +#: ../../library/logging.rst:1305 msgid "" "If *level* is one of the predefined levels :const:`CRITICAL`, :const:" "`ERROR`, :const:`WARNING`, :const:`INFO` or :const:`DEBUG` then you get the " @@ -1900,20 +1911,20 @@ msgid "" "the corresponding string representation is returned." msgstr "" -#: ../../library/logging.rst:1307 +#: ../../library/logging.rst:1312 msgid "" "The *level* parameter also accepts a string representation of the level such " "as 'INFO'. In such cases, this functions returns the corresponding numeric " "value of the level." msgstr "" -#: ../../library/logging.rst:1311 +#: ../../library/logging.rst:1316 msgid "" "If no matching numeric or string value is passed in, the string 'Level %s' % " "level is returned." msgstr "" -#: ../../library/logging.rst:1314 +#: ../../library/logging.rst:1319 msgid "" "Levels are internally integers (as they need to be compared in the logging " "logic). This function is used to convert between an integer level and the " @@ -1922,7 +1933,7 @@ msgid "" "vice versa." msgstr "" -#: ../../library/logging.rst:1320 +#: ../../library/logging.rst:1325 msgid "" "In Python versions earlier than 3.4, this function could also be passed a " "text level, and would return the corresponding numeric value of the level. " @@ -1930,17 +1941,17 @@ msgid "" "Python 3.4, but reinstated in 3.4.2 due to retain backward compatibility." msgstr "" -#: ../../library/logging.rst:1328 +#: ../../library/logging.rst:1333 msgid "" "Returns a handler with the specified *name*, or ``None`` if there is no " "handler with that name." msgstr "" -#: ../../library/logging.rst:1335 +#: ../../library/logging.rst:1340 msgid "Returns an immutable set of all known handler names." msgstr "" -#: ../../library/logging.rst:1341 +#: ../../library/logging.rst:1346 msgid "" "Creates and returns a new :class:`LogRecord` instance whose attributes are " "defined by *attrdict*. This function is useful for taking a pickled :class:" @@ -1948,7 +1959,7 @@ msgid "" "as a :class:`LogRecord` instance at the receiving end." msgstr "" -#: ../../library/logging.rst:1349 +#: ../../library/logging.rst:1354 msgid "" "Does basic configuration for the logging system by creating a :class:" "`StreamHandler` with a default :class:`Formatter` and adding it to the root " @@ -1957,13 +1968,13 @@ msgid "" "no handlers are defined for the root logger." msgstr "" -#: ../../library/logging.rst:1355 +#: ../../library/logging.rst:1360 msgid "" "This function does nothing if the root logger already has handlers " "configured, unless the keyword argument *force* is set to ``True``." msgstr "" -#: ../../library/logging.rst:1358 +#: ../../library/logging.rst:1363 msgid "" "This function should be called from the main thread before other threads are " "started. In versions of Python prior to 2.7.1 and 3.2, if this function is " @@ -1972,54 +1983,54 @@ msgid "" "unexpected results such as messages being duplicated in the log." msgstr "" -#: ../../library/logging.rst:1365 +#: ../../library/logging.rst:1370 msgid "The following keyword arguments are supported." msgstr "支援以下的關鍵字引數。" -#: ../../library/logging.rst:1372 +#: ../../library/logging.rst:1377 msgid "*filename*" msgstr "*filename*" -#: ../../library/logging.rst:1372 +#: ../../library/logging.rst:1377 msgid "" "Specifies that a :class:`FileHandler` be created, using the specified " "filename, rather than a :class:`StreamHandler`." msgstr "" -#: ../../library/logging.rst:1376 +#: ../../library/logging.rst:1381 msgid "*filemode*" msgstr "*filemode*" -#: ../../library/logging.rst:1376 +#: ../../library/logging.rst:1381 msgid "" "If *filename* is specified, open the file in this :ref:`mode `. " "Defaults to ``'a'``." msgstr "" -#: ../../library/logging.rst:1380 +#: ../../library/logging.rst:1385 msgid "*format*" msgstr "*format*" -#: ../../library/logging.rst:1380 +#: ../../library/logging.rst:1385 msgid "" "Use the specified format string for the handler. Defaults to attributes " "``levelname``, ``name`` and ``message`` separated by colons." msgstr "" -#: ../../library/logging.rst:1385 +#: ../../library/logging.rst:1390 msgid "*datefmt*" msgstr "*datefmt*" -#: ../../library/logging.rst:1385 +#: ../../library/logging.rst:1390 msgid "" "Use the specified date/time format, as accepted by :func:`time.strftime`." msgstr "" -#: ../../library/logging.rst:1388 +#: ../../library/logging.rst:1393 msgid "*style*" msgstr "*style*" -#: ../../library/logging.rst:1388 +#: ../../library/logging.rst:1393 msgid "" "If *format* is specified, use this style for the format string. One of " "``'%'``, ``'{'`` or ``'$'`` for :ref:`printf-style `." msgstr "" -#: ../../library/logging.rst:1399 +#: ../../library/logging.rst:1404 msgid "*stream*" msgstr "*stream*" -#: ../../library/logging.rst:1399 +#: ../../library/logging.rst:1404 msgid "" "Use the specified stream to initialize the :class:`StreamHandler`. Note that " "this argument is incompatible with *filename* - if both are present, a " "``ValueError`` is raised." msgstr "" -#: ../../library/logging.rst:1405 +#: ../../library/logging.rst:1410 msgid "*handlers*" msgstr "*handlers*" -#: ../../library/logging.rst:1405 +#: ../../library/logging.rst:1410 msgid "" "If specified, this should be an iterable of already created handlers to add " "to the root logger. Any handlers which don't already have a formatter set " @@ -2059,33 +2070,33 @@ msgid "" "present, a ``ValueError`` is raised." msgstr "" -#: ../../library/logging.rst:1414 +#: ../../library/logging.rst:1419 msgid "*force*" msgstr "*force*" -#: ../../library/logging.rst:1414 +#: ../../library/logging.rst:1419 msgid "" "If this keyword argument is specified as true, any existing handlers " "attached to the root logger are removed and closed, before carrying out the " "configuration as specified by the other arguments." msgstr "" -#: ../../library/logging.rst:1420 +#: ../../library/logging.rst:1425 msgid "*encoding*" msgstr "*encoding*" -#: ../../library/logging.rst:1420 +#: ../../library/logging.rst:1425 msgid "" "If this keyword argument is specified along with *filename*, its value is " "used when the :class:`FileHandler` is created, and thus used when opening " "the output file." msgstr "" -#: ../../library/logging.rst:1425 +#: ../../library/logging.rst:1430 msgid "*errors*" msgstr "*errors*" -#: ../../library/logging.rst:1425 +#: ../../library/logging.rst:1430 msgid "" "If this keyword argument is specified along with *filename*, its value is " "used when the :class:`FileHandler` is created, and thus used when opening " @@ -2094,39 +2105,39 @@ msgid "" "`open`, which means that it will be treated the same as passing 'errors'." msgstr "" -#: ../../library/logging.rst:1436 +#: ../../library/logging.rst:1441 msgid "The *style* argument was added." msgstr "新增 *style* 引數。" -#: ../../library/logging.rst:1439 +#: ../../library/logging.rst:1444 msgid "" "The *handlers* argument was added. Additional checks were added to catch " "situations where incompatible arguments are specified (e.g. *handlers* " "together with *stream* or *filename*, or *stream* together with *filename*)." msgstr "" -#: ../../library/logging.rst:1445 +#: ../../library/logging.rst:1450 msgid "The *force* argument was added." msgstr "新增 *force* 引數。" -#: ../../library/logging.rst:1448 +#: ../../library/logging.rst:1453 msgid "The *encoding* and *errors* arguments were added." msgstr "新增 *encoding* 與 *errors* 引數。" -#: ../../library/logging.rst:1453 +#: ../../library/logging.rst:1458 msgid "" "Informs the logging system to perform an orderly shutdown by flushing and " "closing all handlers. This should be called at application exit and no " "further use of the logging system should be made after this call." msgstr "" -#: ../../library/logging.rst:1457 +#: ../../library/logging.rst:1462 msgid "" "When the logging module is imported, it registers this function as an exit " "handler (see :mod:`atexit`), so normally there's no need to do that manually." msgstr "" -#: ../../library/logging.rst:1464 +#: ../../library/logging.rst:1469 msgid "" "Tells the logging system to use the class *klass* when instantiating a " "logger. The class should define :meth:`!__init__` such that only a name " @@ -2138,32 +2149,32 @@ msgid "" "loggers." msgstr "" -#: ../../library/logging.rst:1475 +#: ../../library/logging.rst:1480 msgid "Set a callable which is used to create a :class:`LogRecord`." msgstr "" -#: ../../library/logging.rst:1477 +#: ../../library/logging.rst:1482 msgid "The factory callable to be used to instantiate a log record." msgstr "" -#: ../../library/logging.rst:1479 +#: ../../library/logging.rst:1484 msgid "" "This function has been provided, along with :func:`getLogRecordFactory`, to " "allow developers more control over how the :class:`LogRecord` representing a " "logging event is constructed." msgstr "" -#: ../../library/logging.rst:1484 +#: ../../library/logging.rst:1489 msgid "The factory has the following signature:" msgstr "" -#: ../../library/logging.rst:1486 +#: ../../library/logging.rst:1491 msgid "" "``factory(name, level, fn, lno, msg, args, exc_info, func=None, sinfo=None, " "**kwargs)``" msgstr "" -#: ../../library/logging.rst:1488 +#: ../../library/logging.rst:1493 msgid "The logger name." msgstr "" @@ -2171,7 +2182,7 @@ msgstr "" msgid "level" msgstr "" -#: ../../library/logging.rst:1489 +#: ../../library/logging.rst:1494 msgid "The logging level (numeric)." msgstr "" @@ -2179,7 +2190,7 @@ msgstr "" msgid "fn" msgstr "fn" -#: ../../library/logging.rst:1490 +#: ../../library/logging.rst:1495 msgid "The full pathname of the file where the logging call was made." msgstr "" @@ -2187,19 +2198,19 @@ msgstr "" msgid "lno" msgstr "lno" -#: ../../library/logging.rst:1491 +#: ../../library/logging.rst:1496 msgid "The line number in the file where the logging call was made." msgstr "" -#: ../../library/logging.rst:1492 +#: ../../library/logging.rst:1497 msgid "The logging message." msgstr "" -#: ../../library/logging.rst:1493 +#: ../../library/logging.rst:1498 msgid "The arguments for the logging message." msgstr "" -#: ../../library/logging.rst:1494 +#: ../../library/logging.rst:1499 msgid "An exception tuple, or ``None``." msgstr "" @@ -2207,7 +2218,7 @@ msgstr "" msgid "func" msgstr "func" -#: ../../library/logging.rst:1495 +#: ../../library/logging.rst:1500 msgid "The name of the function or method which invoked the logging call." msgstr "" @@ -2215,7 +2226,7 @@ msgstr "" msgid "sinfo" msgstr "sinfo" -#: ../../library/logging.rst:1497 +#: ../../library/logging.rst:1502 msgid "" "A stack traceback such as is provided by :func:`traceback.print_stack`, " "showing the call hierarchy." @@ -2225,15 +2236,15 @@ msgstr "" msgid "kwargs" msgstr "kwargs" -#: ../../library/logging.rst:1499 +#: ../../library/logging.rst:1504 msgid "Additional keyword arguments." msgstr "額外的關鍵字引數。" -#: ../../library/logging.rst:1503 +#: ../../library/logging.rst:1508 msgid "Module-Level Attributes" msgstr "模組層級屬性" -#: ../../library/logging.rst:1507 +#: ../../library/logging.rst:1512 msgid "" "A \"handler of last resort\" is available through this attribute. This is a :" "class:`StreamHandler` writing to ``sys.stderr`` with a level of ``WARNING``, " @@ -2244,15 +2255,15 @@ msgid "" "reason, ``lastResort`` can be set to ``None``." msgstr "" -#: ../../library/logging.rst:1519 +#: ../../library/logging.rst:1524 msgid "Used to see if exceptions during handling should be propagated." msgstr "" -#: ../../library/logging.rst:1521 +#: ../../library/logging.rst:1526 msgid "Default: ``True``." msgstr "" -#: ../../library/logging.rst:1523 +#: ../../library/logging.rst:1528 msgid "" "If :data:`raiseExceptions` is ``False``, exceptions get silently ignored. " "This is what is mostly wanted for a logging system - most users will not " @@ -2260,22 +2271,22 @@ msgid "" "application errors." msgstr "" -#: ../../library/logging.rst:1530 +#: ../../library/logging.rst:1535 msgid "Integration with the warnings module" msgstr "" -#: ../../library/logging.rst:1532 +#: ../../library/logging.rst:1537 msgid "" "The :func:`captureWarnings` function can be used to integrate :mod:`logging` " "with the :mod:`warnings` module." msgstr "" -#: ../../library/logging.rst:1537 +#: ../../library/logging.rst:1542 msgid "" "This function is used to turn the capture of warnings by logging on and off." msgstr "" -#: ../../library/logging.rst:1540 +#: ../../library/logging.rst:1545 msgid "" "If *capture* is ``True``, warnings issued by the :mod:`warnings` module will " "be redirected to the logging system. Specifically, a warning will be " @@ -2284,46 +2295,46 @@ msgid "" "`WARNING`." msgstr "" -#: ../../library/logging.rst:1545 +#: ../../library/logging.rst:1550 msgid "" "If *capture* is ``False``, the redirection of warnings to the logging system " "will stop, and warnings will be redirected to their original destinations (i." "e. those in effect before ``captureWarnings(True)`` was called)." msgstr "" -#: ../../library/logging.rst:1552 +#: ../../library/logging.rst:1557 msgid "Module :mod:`logging.config`" msgstr ":mod:`logging.config` 模組" -#: ../../library/logging.rst:1553 +#: ../../library/logging.rst:1558 msgid "Configuration API for the logging module." msgstr "" -#: ../../library/logging.rst:1555 +#: ../../library/logging.rst:1560 msgid "Module :mod:`logging.handlers`" msgstr ":mod:`logging.handlers` 模組" -#: ../../library/logging.rst:1556 +#: ../../library/logging.rst:1561 msgid "Useful handlers included with the logging module." msgstr "" -#: ../../library/logging.rst:1558 +#: ../../library/logging.rst:1563 msgid ":pep:`282` - A Logging System" msgstr "" -#: ../../library/logging.rst:1559 +#: ../../library/logging.rst:1564 msgid "" "The proposal which described this feature for inclusion in the Python " "standard library." msgstr "" -#: ../../library/logging.rst:1562 +#: ../../library/logging.rst:1567 msgid "" "`Original Python logging package `_" msgstr "" -#: ../../library/logging.rst:1563 +#: ../../library/logging.rst:1568 msgid "" "This is the original source for the :mod:`logging` package. The version of " "the package available from this site is suitable for use with Python 1.5.2, "