diff --git a/howto/logging.po b/howto/logging.po index 6f1876d9..e5e3c5f8 100644 --- a/howto/logging.po +++ b/howto/logging.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2018-04-29 00:24+0200\n" +"POT-Creation-Date: 2018-05-05 20:27+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -374,9 +374,9 @@ msgstr "" #: ../Doc/howto/logging.rst:299 msgid "" -"The default format for date/time display (shown above) is ISO8601. If you " -"need more control over the formatting of the date/time, provide a *datefmt* " -"argument to ``basicConfig``, as in this example::" +"The default format for date/time display (shown above) is like ISO8601 or " +"RFC 3339. If you need more control over the formatting of the date/time, " +"provide a *datefmt* argument to ``basicConfig``, as in this example::" msgstr "" #: ../Doc/howto/logging.rst:307 diff --git a/library/logging.config.po b/library/logging.config.po index eb3026cc..c7e07368 100644 --- a/library/logging.config.po +++ b/library/logging.config.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2018-04-29 00:24+0200\n" +"POT-Creation-Date: 2018-05-05 20:27+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -821,11 +821,11 @@ msgstr "" msgid "" "The ``format`` entry is the overall format string, and the ``datefmt`` entry " "is the :func:`strftime`\\ -compatible date/time format string. If empty, " -"the package substitutes ISO8601 format date/times, which is almost " +"the package substitutes ISO8601-style format date/times, which is almost " "equivalent to specifying the date format string ``'%Y-%m-%d %H:%M:%S'``. " -"The ISO8601 format also specifies milliseconds, which are appended to the " -"result of using the above format string, with a comma separator. An example " -"time in ISO8601 format is ``2003-01-23 00:29:50,411``." +"This format also specifies milliseconds, which are appended to the result of " +"using the above format string, with a comma separator. An example time in " +"this format is ``2003-01-23 00:29:50,411``." msgstr "" #: ../Doc/library/logging.config.rst:792 diff --git a/library/logging.po b/library/logging.po index df66fee2..02a2a954 100644 --- a/library/logging.po +++ b/library/logging.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2018-04-29 00:24+0200\n" +"POT-Creation-Date: 2018-05-05 20:27+0200\n" "PO-Revision-Date: 2017-08-10 14:05+0200\n" "Last-Translator: Julien Palard \n" "Language-Team: \n" @@ -248,7 +248,7 @@ msgid "" "information." msgstr "" -#: ../Doc/library/logging.rst:171 ../Doc/library/logging.rst:935 +#: ../Doc/library/logging.rst:171 ../Doc/library/logging.rst:936 msgid "" "The second optional keyword argument is *stack_info*, which defaults to " "``False``. If true, stack information is added to the logging message, " @@ -260,14 +260,14 @@ msgid "" "handlers." msgstr "" -#: ../Doc/library/logging.rst:180 ../Doc/library/logging.rst:944 +#: ../Doc/library/logging.rst:180 ../Doc/library/logging.rst:945 msgid "" "You can specify *stack_info* independently of *exc_info*, e.g. to just show " "how you got to a certain point in your code, even when no exceptions were " "raised. The stack frames are printed following a header line which says:" msgstr "" -#: ../Doc/library/logging.rst:188 ../Doc/library/logging.rst:952 +#: ../Doc/library/logging.rst:188 ../Doc/library/logging.rst:953 msgid "" "This mimics the ``Traceback (most recent call last):`` which is used when " "displaying exception frames." @@ -286,14 +286,14 @@ msgstr "" msgid "would print something like" msgstr "" -#: ../Doc/library/logging.rst:209 ../Doc/library/logging.rst:972 +#: ../Doc/library/logging.rst:209 ../Doc/library/logging.rst:973 msgid "" "The keys in the dictionary passed in *extra* should not clash with the keys " "used by the logging system. (See the :class:`Formatter` documentation for " "more information on which keys are used by the logging system.)" msgstr "" -#: ../Doc/library/logging.rst:213 ../Doc/library/logging.rst:976 +#: ../Doc/library/logging.rst:213 ../Doc/library/logging.rst:977 msgid "" "If you choose to use these attributes in logged messages, you need to " "exercise some care. In the above example, for instance, the :class:" @@ -304,7 +304,7 @@ msgid "" "dictionary with these keys." msgstr "" -#: ../Doc/library/logging.rst:220 ../Doc/library/logging.rst:983 +#: ../Doc/library/logging.rst:220 ../Doc/library/logging.rst:984 msgid "" "While this might be annoying, this feature is intended for use in " "specialized circumstances, such as multi-threaded servers where the same " @@ -315,7 +315,7 @@ msgid "" "particular :class:`Handler`\\ s." msgstr "" -#: ../Doc/library/logging.rst:227 ../Doc/library/logging.rst:990 +#: ../Doc/library/logging.rst:227 ../Doc/library/logging.rst:991 msgid "The *stack_info* parameter was added." msgstr "" @@ -652,11 +652,12 @@ msgid "" "Returns a new instance of the :class:`Formatter` class. The instance is " "initialized with a format string for the message as a whole, as well as a " "format string for the date/time portion of a message. If no *fmt* is " -"specified, ``'%(message)s'`` is used. If no *datefmt* is specified, the " -"ISO8601 date format is used." +"specified, ``'%(message)s'`` is used. If no *datefmt* is specified, an " +"ISO8601-like (or RFC3339-like) date format is used. See the :meth:" +"`formatTime` documentation for more details." msgstr "" -#: ../Doc/library/logging.rst:521 +#: ../Doc/library/logging.rst:522 msgid "" "The *style* parameter can be one of '%', '{' or '$' and determines how the " "format string will be merged with its data: using one of %-formatting, :meth:" @@ -664,11 +665,11 @@ msgid "" "more information on using {- and $-formatting for log messages." msgstr "" -#: ../Doc/library/logging.rst:526 +#: ../Doc/library/logging.rst:527 msgid "The *style* parameter was added." msgstr "" -#: ../Doc/library/logging.rst:532 +#: ../Doc/library/logging.rst:533 msgid "" "The record's attribute dictionary is used as the operand to a string " "formatting operation. Returns the resulting string. Before formatting the " @@ -686,23 +687,23 @@ msgid "" "cached value but recalculates it afresh." msgstr "" -#: ../Doc/library/logging.rst:548 +#: ../Doc/library/logging.rst:549 msgid "" "If stack information is available, it's appended after the exception " "information, using :meth:`formatStack` to transform it if necessary." msgstr "" -#: ../Doc/library/logging.rst:554 +#: ../Doc/library/logging.rst:555 msgid "" "This method should be called from :meth:`format` by a formatter which wants " "to make use of a formatted time. This method can be overridden in formatters " "to provide for any specific requirement, but the basic behavior is as " "follows: if *datefmt* (a string) is specified, it is used with :func:`time." -"strftime` to format the creation time of the record. Otherwise, the ISO8601 " -"format is used. The resulting string is returned." +"strftime` to format the creation time of the record. Otherwise, an ISO8601-" +"like (or RDC 3339-like) format is used. The resulting string is returned." msgstr "" -#: ../Doc/library/logging.rst:562 +#: ../Doc/library/logging.rst:563 msgid "" "This function uses a user-configurable function to convert the creation time " "to a tuple. By default, :func:`time.localtime` is used; to change this for a " @@ -712,13 +713,13 @@ msgid "" "be shown in GMT, set the ``converter`` attribute in the ``Formatter`` class." msgstr "" -#: ../Doc/library/logging.rst:570 +#: ../Doc/library/logging.rst:571 msgid "" -"Previously, the default ISO 8601 format was hard-coded as in this example: " -"``2010-09-06 22:38:15,292`` where the part before the comma is handled by a " -"strptime format string (``'%Y-%m-%d %H:%M:%S'``), and the part after the " -"comma is a millisecond value. Because strptime does not have a format " -"placeholder for milliseconds, the millisecond value is appended using " +"Previously, the default ISO8601-like format was hard-coded as in this " +"example: ``2010-09-06 22:38:15,292`` where the part before the comma is " +"handled by a strptime format string (``'%Y-%m-%d %H:%M:%S'``), and the part " +"after the comma is a millisecond value. Because strptime does not have a " +"format placeholder for milliseconds, the millisecond value is appended using " "another format string, ``'%s,%03d'`` --- and both of these format strings " "have been hardcoded into this method. With the change, these strings are " "defined as class-level attributes which can be overridden at the instance " @@ -727,7 +728,7 @@ msgid "" "the millisecond value)." msgstr "" -#: ../Doc/library/logging.rst:585 +#: ../Doc/library/logging.rst:586 msgid "" "Formats the specified exception information (a standard exception tuple as " "returned by :func:`sys.exc_info`) as a string. This default implementation " @@ -735,18 +736,18 @@ msgid "" "returned." msgstr "" -#: ../Doc/library/logging.rst:592 +#: ../Doc/library/logging.rst:593 msgid "" "Formats the specified stack information (a string as returned by :func:" "`traceback.print_stack`, but with the last newline removed) as a string. " "This default implementation just returns the input value." msgstr "" -#: ../Doc/library/logging.rst:599 +#: ../Doc/library/logging.rst:600 msgid "Filter Objects" msgstr "" -#: ../Doc/library/logging.rst:601 +#: ../Doc/library/logging.rst:602 msgid "" "``Filters`` can be used by ``Handlers`` and ``Loggers`` for more " "sophisticated filtering than is provided by levels. The base filter class " @@ -756,7 +757,7 @@ msgid "" "If initialized with the empty string, all events are passed." msgstr "" -#: ../Doc/library/logging.rst:611 +#: ../Doc/library/logging.rst:612 msgid "" "Returns an instance of the :class:`Filter` class. If *name* is specified, it " "names a logger which, together with its children, will have its events " @@ -764,13 +765,13 @@ msgid "" "event." msgstr "" -#: ../Doc/library/logging.rst:618 +#: ../Doc/library/logging.rst:619 msgid "" "Is the specified record to be logged? Returns zero for no, nonzero for yes. " "If deemed appropriate, the record may be modified in-place by this method." msgstr "" -#: ../Doc/library/logging.rst:622 +#: ../Doc/library/logging.rst:623 msgid "" "Note that filters attached to handlers are consulted before an event is " "emitted by the handler, whereas filters attached to loggers are consulted " @@ -780,13 +781,13 @@ msgid "" "setting, unless the filter has also been applied to those descendant loggers." msgstr "" -#: ../Doc/library/logging.rst:629 +#: ../Doc/library/logging.rst:630 msgid "" "You don't actually need to subclass ``Filter``: you can pass any instance " "which has a ``filter`` method with the same semantics." msgstr "" -#: ../Doc/library/logging.rst:632 +#: ../Doc/library/logging.rst:633 msgid "" "You don't need to create specialized ``Filter`` classes, or use other " "classes with a ``filter`` method: you can use a function (or other callable) " @@ -797,7 +798,7 @@ msgid "" "value should conform to that returned by :meth:`~Filter.filter`." msgstr "" -#: ../Doc/library/logging.rst:642 +#: ../Doc/library/logging.rst:643 msgid "" "Although filters are used primarily to filter records based on more " "sophisticated criteria than levels, they get to see every record which is " @@ -809,11 +810,11 @@ msgid "" "information into logs (see :ref:`filters-contextual`)." msgstr "" -#: ../Doc/library/logging.rst:654 +#: ../Doc/library/logging.rst:655 msgid "LogRecord Objects" msgstr "" -#: ../Doc/library/logging.rst:656 +#: ../Doc/library/logging.rst:657 msgid "" ":class:`LogRecord` instances are created automatically by the :class:" "`Logger` every time something is logged, and can be created manually via :" @@ -821,11 +822,11 @@ msgid "" "wire)." msgstr "" -#: ../Doc/library/logging.rst:664 +#: ../Doc/library/logging.rst:665 msgid "Contains all the information pertinent to the event being logged." msgstr "" -#: ../Doc/library/logging.rst:666 +#: ../Doc/library/logging.rst:667 msgid "" "The primary information is passed in :attr:`msg` and :attr:`args`, which are " "combined using ``msg % args`` to create the :attr:`message` field of the " @@ -836,58 +837,58 @@ msgstr "" msgid "Parameters" msgstr "" -#: ../Doc/library/logging.rst:670 +#: ../Doc/library/logging.rst:671 msgid "" "The name of the logger used to log the event represented by this LogRecord. " "Note that this name will always have this value, even though it may be " "emitted by a handler attached to a different (ancestor) logger." msgstr "" -#: ../Doc/library/logging.rst:674 +#: ../Doc/library/logging.rst:675 msgid "" "The numeric level of the logging event (one of DEBUG, INFO etc.) Note that " "this is converted to *two* attributes of the LogRecord: ``levelno`` for the " "numeric value and ``levelname`` for the corresponding level name." msgstr "" -#: ../Doc/library/logging.rst:678 +#: ../Doc/library/logging.rst:679 msgid "The full pathname of the source file where the logging call was made." msgstr "" -#: ../Doc/library/logging.rst:680 +#: ../Doc/library/logging.rst:681 msgid "The line number in the source file where the logging call was made." msgstr "" -#: ../Doc/library/logging.rst:682 +#: ../Doc/library/logging.rst:683 msgid "" "The event description message, possibly a format string with placeholders " "for variable data." msgstr "" -#: ../Doc/library/logging.rst:684 +#: ../Doc/library/logging.rst:685 msgid "" "Variable data to merge into the *msg* argument to obtain the event " "description." msgstr "" -#: ../Doc/library/logging.rst:686 +#: ../Doc/library/logging.rst:687 msgid "" "An exception tuple with the current exception information, or ``None`` if no " "exception information is available." msgstr "" -#: ../Doc/library/logging.rst:688 +#: ../Doc/library/logging.rst:689 msgid "" "The name of the function or method from which the logging call was invoked." msgstr "" -#: ../Doc/library/logging.rst:690 +#: ../Doc/library/logging.rst:691 msgid "" "A text string representing stack information from the base of the stack in " "the current thread, up to the logging call." msgstr "" -#: ../Doc/library/logging.rst:695 +#: ../Doc/library/logging.rst:696 msgid "" "Returns the message for this :class:`LogRecord` instance after merging any " "user-supplied arguments with the message. If the user-supplied message " @@ -896,7 +897,7 @@ msgid "" "whose ``__str__`` method can return the actual format string to be used." msgstr "" -#: ../Doc/library/logging.rst:702 +#: ../Doc/library/logging.rst:703 msgid "" "The creation of a ``LogRecord`` has been made more configurable by providing " "a factory which is used to create the record. The factory can be set using :" @@ -904,24 +905,24 @@ msgid "" "factory's signature)." msgstr "" -#: ../Doc/library/logging.rst:708 +#: ../Doc/library/logging.rst:709 msgid "" "This functionality can be used to inject your own values into a LogRecord at " "creation time. You can use the following pattern::" msgstr "" -#: ../Doc/library/logging.rst:720 +#: ../Doc/library/logging.rst:721 msgid "" "With this pattern, multiple factories could be chained, and as long as they " "don't overwrite each other's attributes or unintentionally overwrite the " "standard attributes listed above, there should be no surprises." msgstr "" -#: ../Doc/library/logging.rst:729 +#: ../Doc/library/logging.rst:730 msgid "LogRecord attributes" msgstr "" -#: ../Doc/library/logging.rst:731 +#: ../Doc/library/logging.rst:732 msgid "" "The LogRecord has a number of attributes, most of which are derived from the " "parameters to the constructor. (Note that the names do not always correspond " @@ -932,7 +933,7 @@ msgid "" "style format string." msgstr "" -#: ../Doc/library/logging.rst:739 +#: ../Doc/library/logging.rst:740 msgid "" "If you are using {}-formatting (:func:`str.format`), you can use ``{attrname}" "`` as the placeholder in the format string. If you are using $-formatting (:" @@ -940,7 +941,7 @@ msgid "" "course, replace ``attrname`` with the actual attribute name you want to use." msgstr "" -#: ../Doc/library/logging.rst:745 +#: ../Doc/library/logging.rst:746 msgid "" "In the case of {}-formatting, you can specify formatting flags by placing " "them after the attribute name, separated from it with a colon. For example: " @@ -949,308 +950,308 @@ msgid "" "on the options available to you." msgstr "" -#: ../Doc/library/logging.rst:752 +#: ../Doc/library/logging.rst:753 msgid "Attribute name" msgstr "" -#: ../Doc/library/logging.rst:752 ../Doc/library/logging.rst:1128 +#: ../Doc/library/logging.rst:753 ../Doc/library/logging.rst:1129 msgid "Format" msgstr "Format" -#: ../Doc/library/logging.rst:752 ../Doc/library/logging.rst:1128 +#: ../Doc/library/logging.rst:753 ../Doc/library/logging.rst:1129 msgid "Description" msgstr "Description" -#: ../Doc/library/logging.rst:754 ../Doc/library/logging.rst:0 +#: ../Doc/library/logging.rst:755 ../Doc/library/logging.rst:0 msgid "args" msgstr "" -#: ../Doc/library/logging.rst:754 ../Doc/library/logging.rst:768 -#: ../Doc/library/logging.rst:796 ../Doc/library/logging.rst:814 +#: ../Doc/library/logging.rst:755 ../Doc/library/logging.rst:769 +#: ../Doc/library/logging.rst:797 ../Doc/library/logging.rst:815 msgid "You shouldn't need to format this yourself." msgstr "" -#: ../Doc/library/logging.rst:754 +#: ../Doc/library/logging.rst:755 msgid "" "The tuple of arguments merged into ``msg`` to produce ``message``, or a dict " "whose values are used for the merge (when there is only one argument, and it " "is a dictionary)." msgstr "" -#: ../Doc/library/logging.rst:759 +#: ../Doc/library/logging.rst:760 msgid "asctime" msgstr "" -#: ../Doc/library/logging.rst:759 +#: ../Doc/library/logging.rst:760 msgid "``%(asctime)s``" msgstr "``%(asctime)s``" -#: ../Doc/library/logging.rst:759 +#: ../Doc/library/logging.rst:760 msgid "" "Human-readable time when the :class:`LogRecord` was created. By default " "this is of the form '2003-07-08 16:49:45,896' (the numbers after the comma " "are millisecond portion of the time)." msgstr "" -#: ../Doc/library/logging.rst:765 +#: ../Doc/library/logging.rst:766 msgid "created" msgstr "created" -#: ../Doc/library/logging.rst:765 +#: ../Doc/library/logging.rst:766 msgid "``%(created)f``" msgstr "``%(created)f``" -#: ../Doc/library/logging.rst:765 +#: ../Doc/library/logging.rst:766 msgid "" "Time when the :class:`LogRecord` was created (as returned by :func:`time." "time`)." msgstr "" -#: ../Doc/library/logging.rst:768 ../Doc/library/logging.rst:0 +#: ../Doc/library/logging.rst:769 ../Doc/library/logging.rst:0 msgid "exc_info" msgstr "exc_info" -#: ../Doc/library/logging.rst:768 +#: ../Doc/library/logging.rst:769 msgid "" "Exception tuple (à la ``sys.exc_info``) or, if no exception has occurred, " "``None``." msgstr "" -#: ../Doc/library/logging.rst:771 +#: ../Doc/library/logging.rst:772 msgid "filename" msgstr "filename" -#: ../Doc/library/logging.rst:771 +#: ../Doc/library/logging.rst:772 msgid "``%(filename)s``" msgstr "``%(filename)s``" -#: ../Doc/library/logging.rst:771 +#: ../Doc/library/logging.rst:772 msgid "Filename portion of ``pathname``." msgstr "" -#: ../Doc/library/logging.rst:773 +#: ../Doc/library/logging.rst:774 msgid "funcName" msgstr "funcName" -#: ../Doc/library/logging.rst:773 +#: ../Doc/library/logging.rst:774 msgid "``%(funcName)s``" msgstr "``%(funcName)s``" -#: ../Doc/library/logging.rst:773 +#: ../Doc/library/logging.rst:774 msgid "Name of function containing the logging call." msgstr "" -#: ../Doc/library/logging.rst:775 +#: ../Doc/library/logging.rst:776 msgid "levelname" msgstr "levelname" -#: ../Doc/library/logging.rst:775 +#: ../Doc/library/logging.rst:776 msgid "``%(levelname)s``" msgstr "``%(levelname)s``" -#: ../Doc/library/logging.rst:775 +#: ../Doc/library/logging.rst:776 msgid "" "Text logging level for the message (``'DEBUG'``, ``'INFO'``, ``'WARNING'``, " "``'ERROR'``, ``'CRITICAL'``)." msgstr "" -#: ../Doc/library/logging.rst:779 +#: ../Doc/library/logging.rst:780 msgid "levelno" msgstr "" -#: ../Doc/library/logging.rst:779 +#: ../Doc/library/logging.rst:780 msgid "``%(levelno)s``" msgstr "``%(levelno)s``" -#: ../Doc/library/logging.rst:779 +#: ../Doc/library/logging.rst:780 msgid "" "Numeric logging level for the message (:const:`DEBUG`, :const:`INFO`, :const:" "`WARNING`, :const:`ERROR`, :const:`CRITICAL`)." msgstr "" -#: ../Doc/library/logging.rst:784 +#: ../Doc/library/logging.rst:785 msgid "lineno" msgstr "lineno" -#: ../Doc/library/logging.rst:784 +#: ../Doc/library/logging.rst:785 msgid "``%(lineno)d``" msgstr "``%(lineno)d``" -#: ../Doc/library/logging.rst:784 +#: ../Doc/library/logging.rst:785 msgid "Source line number where the logging call was issued (if available)." msgstr "" -#: ../Doc/library/logging.rst:787 +#: ../Doc/library/logging.rst:788 msgid "message" msgstr "message" -#: ../Doc/library/logging.rst:787 +#: ../Doc/library/logging.rst:788 msgid "``%(message)s``" msgstr "``%(message)s``" -#: ../Doc/library/logging.rst:787 +#: ../Doc/library/logging.rst:788 msgid "" "The logged message, computed as ``msg % args``. This is set when :meth:" "`Formatter.format` is invoked." msgstr "" -#: ../Doc/library/logging.rst:791 +#: ../Doc/library/logging.rst:792 msgid "module" msgstr "module" -#: ../Doc/library/logging.rst:791 +#: ../Doc/library/logging.rst:792 msgid "``%(module)s``" msgstr "``%(module)s``" -#: ../Doc/library/logging.rst:791 +#: ../Doc/library/logging.rst:792 msgid "Module (name portion of ``filename``)." msgstr "" -#: ../Doc/library/logging.rst:793 +#: ../Doc/library/logging.rst:794 msgid "msecs" msgstr "msecs" -#: ../Doc/library/logging.rst:793 +#: ../Doc/library/logging.rst:794 msgid "``%(msecs)d``" msgstr "``%(msecs)d``" -#: ../Doc/library/logging.rst:793 +#: ../Doc/library/logging.rst:794 msgid "" "Millisecond portion of the time when the :class:`LogRecord` was created." msgstr "" -#: ../Doc/library/logging.rst:796 ../Doc/library/logging.rst:0 +#: ../Doc/library/logging.rst:797 ../Doc/library/logging.rst:0 msgid "msg" msgstr "" -#: ../Doc/library/logging.rst:796 +#: ../Doc/library/logging.rst:797 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 "" -#: ../Doc/library/logging.rst:801 ../Doc/library/logging.rst:0 +#: ../Doc/library/logging.rst:802 ../Doc/library/logging.rst:0 msgid "name" msgstr "" -#: ../Doc/library/logging.rst:801 +#: ../Doc/library/logging.rst:802 msgid "``%(name)s``" msgstr "``%(name)s``" -#: ../Doc/library/logging.rst:801 +#: ../Doc/library/logging.rst:802 msgid "Name of the logger used to log the call." msgstr "" -#: ../Doc/library/logging.rst:803 +#: ../Doc/library/logging.rst:804 msgid "pathname" msgstr "pathname" -#: ../Doc/library/logging.rst:803 +#: ../Doc/library/logging.rst:804 msgid "``%(pathname)s``" msgstr "``%(pathname)s``" -#: ../Doc/library/logging.rst:803 +#: ../Doc/library/logging.rst:804 msgid "" "Full pathname of the source file where the logging call was issued (if " "available)." msgstr "" -#: ../Doc/library/logging.rst:806 +#: ../Doc/library/logging.rst:807 msgid "process" msgstr "process" -#: ../Doc/library/logging.rst:806 +#: ../Doc/library/logging.rst:807 msgid "``%(process)d``" msgstr "``%(process)d``" -#: ../Doc/library/logging.rst:806 +#: ../Doc/library/logging.rst:807 msgid "Process ID (if available)." msgstr "" -#: ../Doc/library/logging.rst:808 +#: ../Doc/library/logging.rst:809 msgid "processName" msgstr "processName" -#: ../Doc/library/logging.rst:808 +#: ../Doc/library/logging.rst:809 msgid "``%(processName)s``" msgstr "``%(processName)s``" -#: ../Doc/library/logging.rst:808 +#: ../Doc/library/logging.rst:809 msgid "Process name (if available)." msgstr "" -#: ../Doc/library/logging.rst:810 +#: ../Doc/library/logging.rst:811 msgid "relativeCreated" msgstr "relativeCreated" -#: ../Doc/library/logging.rst:810 +#: ../Doc/library/logging.rst:811 msgid "``%(relativeCreated)d``" msgstr "``%(relativeCreated)d``" -#: ../Doc/library/logging.rst:810 +#: ../Doc/library/logging.rst:811 msgid "" "Time in milliseconds when the LogRecord was created, relative to the time " "the logging module was loaded." msgstr "" -#: ../Doc/library/logging.rst:814 +#: ../Doc/library/logging.rst:815 msgid "stack_info" msgstr "" -#: ../Doc/library/logging.rst:814 +#: ../Doc/library/logging.rst:815 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 "" -#: ../Doc/library/logging.rst:820 +#: ../Doc/library/logging.rst:821 msgid "thread" msgstr "" -#: ../Doc/library/logging.rst:820 +#: ../Doc/library/logging.rst:821 msgid "``%(thread)d``" msgstr "``%(thread)d``" -#: ../Doc/library/logging.rst:820 +#: ../Doc/library/logging.rst:821 msgid "Thread ID (if available)." msgstr "" -#: ../Doc/library/logging.rst:822 +#: ../Doc/library/logging.rst:823 msgid "threadName" msgstr "" -#: ../Doc/library/logging.rst:822 +#: ../Doc/library/logging.rst:823 msgid "``%(threadName)s``" msgstr "``%(threadName)s``" -#: ../Doc/library/logging.rst:822 +#: ../Doc/library/logging.rst:823 msgid "Thread name (if available)." msgstr "" -#: ../Doc/library/logging.rst:825 +#: ../Doc/library/logging.rst:826 msgid "*processName* was added." msgstr "" -#: ../Doc/library/logging.rst:832 +#: ../Doc/library/logging.rst:833 msgid "LoggerAdapter Objects" msgstr "" -#: ../Doc/library/logging.rst:834 +#: ../Doc/library/logging.rst:835 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 "" -#: ../Doc/library/logging.rst:840 +#: ../Doc/library/logging.rst:841 msgid "" "Returns an instance of :class:`LoggerAdapter` initialized with an " "underlying :class:`Logger` instance and a dict-like object." msgstr "" -#: ../Doc/library/logging.rst:845 +#: ../Doc/library/logging.rst:846 msgid "" "Modifies the message and/or keyword arguments passed to a logging call in " "order to insert contextual information. This implementation takes the object " @@ -1259,7 +1260,7 @@ msgid "" "(possibly modified) versions of the arguments passed in." msgstr "" -#: ../Doc/library/logging.rst:851 +#: ../Doc/library/logging.rst:852 msgid "" "In addition to the above, :class:`LoggerAdapter` supports the following " "methods of :class:`Logger`: :meth:`~Logger.debug`, :meth:`~Logger.info`, :" @@ -1271,18 +1272,18 @@ msgid "" "interchangeably." msgstr "" -#: ../Doc/library/logging.rst:860 +#: ../Doc/library/logging.rst:861 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 "" -#: ../Doc/library/logging.rst:867 +#: ../Doc/library/logging.rst:868 msgid "Thread Safety" msgstr "" -#: ../Doc/library/logging.rst:869 +#: ../Doc/library/logging.rst:870 msgid "" "The logging module is intended to be thread-safe without any special work " "needing to be done by its clients. It achieves this though using threading " @@ -1291,7 +1292,7 @@ msgid "" "O." msgstr "" -#: ../Doc/library/logging.rst:874 +#: ../Doc/library/logging.rst:875 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 " @@ -1299,17 +1300,17 @@ msgid "" "always re-entrant, and so cannot be invoked from such signal handlers." msgstr "" -#: ../Doc/library/logging.rst:881 +#: ../Doc/library/logging.rst:882 msgid "Module-Level Functions" msgstr "" -#: ../Doc/library/logging.rst:883 +#: ../Doc/library/logging.rst:884 msgid "" "In addition to the classes described above, there are a number of module- " "level functions." msgstr "" -#: ../Doc/library/logging.rst:889 +#: ../Doc/library/logging.rst:890 msgid "" "Return a logger with the specified name or, if name is ``None``, return a " "logger which is the root logger of the hierarchy. If specified, the name is " @@ -1318,14 +1319,14 @@ msgid "" "logging." msgstr "" -#: ../Doc/library/logging.rst:894 +#: ../Doc/library/logging.rst:895 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 "" -#: ../Doc/library/logging.rst:901 +#: ../Doc/library/logging.rst:902 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 " @@ -1334,24 +1335,24 @@ msgid "" "example::" msgstr "" -#: ../Doc/library/logging.rst:912 +#: ../Doc/library/logging.rst:913 msgid "Return a callable which is used to create a :class:`LogRecord`." msgstr "" -#: ../Doc/library/logging.rst:914 +#: ../Doc/library/logging.rst:915 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 "" -#: ../Doc/library/logging.rst:919 +#: ../Doc/library/logging.rst:920 msgid "" "See :func:`setLogRecordFactory` for more information about the how the " "factory is called." msgstr "" -#: ../Doc/library/logging.rst:924 +#: ../Doc/library/logging.rst:925 msgid "" "Logs a message with level :const:`DEBUG` on the root logger. The *msg* is " "the message format string, and the *args* are the arguments which are merged " @@ -1360,7 +1361,7 @@ msgid "" "argument.)" msgstr "" -#: ../Doc/library/logging.rst:929 +#: ../Doc/library/logging.rst:930 msgid "" "There are three keyword arguments in *kwargs* which are inspected: " "*exc_info* which, if it does not evaluate as false, causes exception " @@ -1369,7 +1370,7 @@ msgid "" "otherwise, :func:`sys.exc_info` is called to get the exception information." msgstr "" -#: ../Doc/library/logging.rst:955 +#: ../Doc/library/logging.rst:956 msgid "" "The third optional keyword argument is *extra* which can be used to pass a " "dictionary which is used to populate the __dict__ of the LogRecord created " @@ -1378,55 +1379,55 @@ msgid "" "logged messages. For example::" msgstr "" -#: ../Doc/library/logging.rst:966 +#: ../Doc/library/logging.rst:967 msgid "would print something like:" msgstr "" -#: ../Doc/library/logging.rst:995 +#: ../Doc/library/logging.rst:996 msgid "" "Logs a message with level :const:`INFO` on the root logger. The arguments " "are interpreted as for :func:`debug`." msgstr "" -#: ../Doc/library/logging.rst:1001 +#: ../Doc/library/logging.rst:1002 msgid "" "Logs a message with level :const:`WARNING` on the root logger. The arguments " "are interpreted as for :func:`debug`." msgstr "" -#: ../Doc/library/logging.rst:1004 +#: ../Doc/library/logging.rst:1005 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 "" -#: ../Doc/library/logging.rst:1011 +#: ../Doc/library/logging.rst:1012 msgid "" "Logs a message with level :const:`ERROR` on the root logger. The arguments " "are interpreted as for :func:`debug`." msgstr "" -#: ../Doc/library/logging.rst:1017 +#: ../Doc/library/logging.rst:1018 msgid "" "Logs a message with level :const:`CRITICAL` on the root logger. The " "arguments are interpreted as for :func:`debug`." msgstr "" -#: ../Doc/library/logging.rst:1023 +#: ../Doc/library/logging.rst:1024 msgid "" "Logs a message with level :const:`ERROR` on the root logger. The arguments " "are interpreted as for :func:`debug`. Exception info is added to the logging " "message. This function should only be called from an exception handler." msgstr "" -#: ../Doc/library/logging.rst:1029 +#: ../Doc/library/logging.rst:1030 msgid "" "Logs a message with level *level* on the root logger. The other arguments " "are interpreted as for :func:`debug`." msgstr "" -#: ../Doc/library/logging.rst:1032 +#: ../Doc/library/logging.rst:1033 msgid "" "The above module-level convenience functions, which delegate to the root " "logger, call :func:`basicConfig` to ensure that at least one handler is " @@ -1439,7 +1440,7 @@ msgid "" "messages for the same event." msgstr "" -#: ../Doc/library/logging.rst:1044 +#: ../Doc/library/logging.rst:1045 msgid "" "Provides an overriding level *lvl* for all loggers which takes precedence " "over the logger's own level. When the need arises to temporarily throttle " @@ -1453,7 +1454,7 @@ msgid "" "individual loggers." msgstr "" -#: ../Doc/library/logging.rst:1055 +#: ../Doc/library/logging.rst:1056 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 " @@ -1461,13 +1462,13 @@ msgid "" "suitable value." msgstr "" -#: ../Doc/library/logging.rst:1060 +#: ../Doc/library/logging.rst:1061 msgid "" "The *lvl* parameter was defaulted to level ``CRITICAL``. See Issue #28524 " "for more information about this change." msgstr "" -#: ../Doc/library/logging.rst:1066 +#: ../Doc/library/logging.rst:1067 msgid "" "Associates level *lvl* with text *levelName* in an internal dictionary, " "which is used to map numeric levels to a textual representation, for example " @@ -1477,13 +1478,13 @@ msgid "" "and they should increase in increasing order of severity." msgstr "" -#: ../Doc/library/logging.rst:1073 +#: ../Doc/library/logging.rst:1074 msgid "" "If you are thinking of defining your own levels, please see the section on :" "ref:`custom-levels`." msgstr "" -#: ../Doc/library/logging.rst:1078 +#: ../Doc/library/logging.rst:1079 msgid "" "Returns the textual representation of logging level *lvl*. If the level is " "one of the predefined levels :const:`CRITICAL`, :const:`ERROR`, :const:" @@ -1495,7 +1496,7 @@ msgid "" "returned." msgstr "" -#: ../Doc/library/logging.rst:1086 +#: ../Doc/library/logging.rst:1087 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 " @@ -1503,7 +1504,7 @@ msgid "" "%(levelname)s`` format specifier (see :ref:`logrecord-attributes`)." msgstr "" -#: ../Doc/library/logging.rst:1091 +#: ../Doc/library/logging.rst:1092 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. " @@ -1511,7 +1512,7 @@ msgid "" "Python 3.4, but reinstated in 3.4.2 due to retain backward compatibility." msgstr "" -#: ../Doc/library/logging.rst:1099 +#: ../Doc/library/logging.rst:1100 msgid "" "Creates and returns a new :class:`LogRecord` instance whose attributes are " "defined by *attrdict*. This function is useful for taking a pickled :class:" @@ -1519,7 +1520,7 @@ msgid "" "as a :class:`LogRecord` instance at the receiving end." msgstr "" -#: ../Doc/library/logging.rst:1107 +#: ../Doc/library/logging.rst:1108 msgid "" "Does basic configuration for the logging system by creating a :class:" "`StreamHandler` with a default :class:`Formatter` and adding it to the root " @@ -1528,13 +1529,13 @@ msgid "" "no handlers are defined for the root logger." msgstr "" -#: ../Doc/library/logging.rst:1113 +#: ../Doc/library/logging.rst:1114 msgid "" "This function does nothing if the root logger already has handlers " "configured for it." msgstr "" -#: ../Doc/library/logging.rst:1116 +#: ../Doc/library/logging.rst:1117 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 " @@ -1543,81 +1544,81 @@ msgid "" "unexpected results such as messages being duplicated in the log." msgstr "" -#: ../Doc/library/logging.rst:1123 +#: ../Doc/library/logging.rst:1124 msgid "The following keyword arguments are supported." msgstr "" -#: ../Doc/library/logging.rst:1130 +#: ../Doc/library/logging.rst:1131 msgid "``filename``" msgstr "``filename``" -#: ../Doc/library/logging.rst:1130 +#: ../Doc/library/logging.rst:1131 msgid "" "Specifies that a FileHandler be created, using the specified filename, " "rather than a StreamHandler." msgstr "" -#: ../Doc/library/logging.rst:1134 +#: ../Doc/library/logging.rst:1135 msgid "``filemode``" msgstr "``filemode``" -#: ../Doc/library/logging.rst:1134 +#: ../Doc/library/logging.rst:1135 msgid "" "Specifies the mode to open the file, if filename is specified (if filemode " "is unspecified, it defaults to 'a')." msgstr "" -#: ../Doc/library/logging.rst:1138 +#: ../Doc/library/logging.rst:1139 msgid "``format``" msgstr "``format``" -#: ../Doc/library/logging.rst:1138 +#: ../Doc/library/logging.rst:1139 msgid "Use the specified format string for the handler." msgstr "" -#: ../Doc/library/logging.rst:1141 +#: ../Doc/library/logging.rst:1142 msgid "``datefmt``" msgstr "``datefmt``" -#: ../Doc/library/logging.rst:1141 +#: ../Doc/library/logging.rst:1142 msgid "Use the specified date/time format." msgstr "" -#: ../Doc/library/logging.rst:1143 +#: ../Doc/library/logging.rst:1144 msgid "``style``" msgstr "``style``" -#: ../Doc/library/logging.rst:1143 +#: ../Doc/library/logging.rst:1144 msgid "" "If ``format`` is specified, use this style for the format string. One of " "'%', '{' or '$' for %-formatting, :meth:`str.format` or :class:`string." "Template` respectively, and defaulting to '%' if not specified." msgstr "" -#: ../Doc/library/logging.rst:1149 +#: ../Doc/library/logging.rst:1150 msgid "``level``" msgstr "``level``" -#: ../Doc/library/logging.rst:1149 +#: ../Doc/library/logging.rst:1150 msgid "Set the root logger level to the specified level." msgstr "" -#: ../Doc/library/logging.rst:1152 +#: ../Doc/library/logging.rst:1153 msgid "``stream``" msgstr "``stream``" -#: ../Doc/library/logging.rst:1152 +#: ../Doc/library/logging.rst:1153 msgid "" "Use the specified stream to initialize the StreamHandler. Note that this " "argument is incompatible with 'filename' - if both are present, a " "``ValueError`` is raised." msgstr "" -#: ../Doc/library/logging.rst:1157 +#: ../Doc/library/logging.rst:1158 msgid "``handlers``" msgstr "``handlers``" -#: ../Doc/library/logging.rst:1157 +#: ../Doc/library/logging.rst:1158 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 " @@ -1626,11 +1627,11 @@ msgid "" "present, a ``ValueError`` is raised." msgstr "" -#: ../Doc/library/logging.rst:1167 +#: ../Doc/library/logging.rst:1168 msgid "The ``style`` argument was added." msgstr "" -#: ../Doc/library/logging.rst:1170 +#: ../Doc/library/logging.rst:1171 msgid "" "The ``handlers`` argument was added. Additional checks were added to catch " "situations where incompatible arguments are specified (e.g. ``handlers`` " @@ -1638,14 +1639,14 @@ msgid "" "``filename``)." msgstr "" -#: ../Doc/library/logging.rst:1179 +#: ../Doc/library/logging.rst:1180 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 "" -#: ../Doc/library/logging.rst:1186 +#: ../Doc/library/logging.rst:1187 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 " @@ -1654,26 +1655,26 @@ msgid "" "instantiated by applications which need to use custom logger behavior." msgstr "" -#: ../Doc/library/logging.rst:1195 +#: ../Doc/library/logging.rst:1196 msgid "Set a callable which is used to create a :class:`LogRecord`." msgstr "" -#: ../Doc/library/logging.rst:1197 +#: ../Doc/library/logging.rst:1198 msgid "The factory callable to be used to instantiate a log record." msgstr "" -#: ../Doc/library/logging.rst:1199 +#: ../Doc/library/logging.rst:1200 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 "" -#: ../Doc/library/logging.rst:1204 +#: ../Doc/library/logging.rst:1205 msgid "The factory has the following signature:" msgstr "" -#: ../Doc/library/logging.rst:1206 +#: ../Doc/library/logging.rst:1207 msgid "" "``factory(name, level, fn, lno, msg, args, exc_info, func=None, sinfo=None, " "**kwargs)``" @@ -1681,7 +1682,7 @@ msgstr "" "``factory(name, level, fn, lno, msg, args, exc_info, func=None, sinfo=None, " "**kwargs)``" -#: ../Doc/library/logging.rst:1208 +#: ../Doc/library/logging.rst:1209 msgid "The logger name." msgstr "" @@ -1689,7 +1690,7 @@ msgstr "" msgid "level" msgstr "level" -#: ../Doc/library/logging.rst:1209 +#: ../Doc/library/logging.rst:1210 msgid "The logging level (numeric)." msgstr "" @@ -1697,7 +1698,7 @@ msgstr "" msgid "fn" msgstr "fn" -#: ../Doc/library/logging.rst:1210 +#: ../Doc/library/logging.rst:1211 msgid "The full pathname of the file where the logging call was made." msgstr "" @@ -1705,19 +1706,19 @@ msgstr "" msgid "lno" msgstr "lno" -#: ../Doc/library/logging.rst:1211 +#: ../Doc/library/logging.rst:1212 msgid "The line number in the file where the logging call was made." msgstr "" -#: ../Doc/library/logging.rst:1212 +#: ../Doc/library/logging.rst:1213 msgid "The logging message." msgstr "" -#: ../Doc/library/logging.rst:1213 +#: ../Doc/library/logging.rst:1214 msgid "The arguments for the logging message." msgstr "" -#: ../Doc/library/logging.rst:1214 +#: ../Doc/library/logging.rst:1215 msgid "An exception tuple, or ``None``." msgstr "" @@ -1725,7 +1726,7 @@ msgstr "" msgid "func" msgstr "func" -#: ../Doc/library/logging.rst:1215 +#: ../Doc/library/logging.rst:1216 msgid "The name of the function or method which invoked the logging call." msgstr "" @@ -1733,7 +1734,7 @@ msgstr "" msgid "sinfo" msgstr "sinfo" -#: ../Doc/library/logging.rst:1217 +#: ../Doc/library/logging.rst:1218 msgid "" "A stack traceback such as is provided by :func:`traceback.print_stack`, " "showing the call hierarchy." @@ -1743,15 +1744,15 @@ msgstr "" msgid "kwargs" msgstr "" -#: ../Doc/library/logging.rst:1219 +#: ../Doc/library/logging.rst:1220 msgid "Additional keyword arguments." msgstr "" -#: ../Doc/library/logging.rst:1223 +#: ../Doc/library/logging.rst:1224 msgid "Module-Level Attributes" msgstr "" -#: ../Doc/library/logging.rst:1227 +#: ../Doc/library/logging.rst:1228 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``, " @@ -1762,22 +1763,22 @@ msgid "" "reason, ``lastResort`` can be set to ``None``." msgstr "" -#: ../Doc/library/logging.rst:1238 +#: ../Doc/library/logging.rst:1239 msgid "Integration with the warnings module" msgstr "" -#: ../Doc/library/logging.rst:1240 +#: ../Doc/library/logging.rst:1241 msgid "" "The :func:`captureWarnings` function can be used to integrate :mod:`logging` " "with the :mod:`warnings` module." msgstr "" -#: ../Doc/library/logging.rst:1245 +#: ../Doc/library/logging.rst:1246 msgid "" "This function is used to turn the capture of warnings by logging on and off." msgstr "" -#: ../Doc/library/logging.rst:1248 +#: ../Doc/library/logging.rst:1249 msgid "" "If *capture* is ``True``, warnings issued by the :mod:`warnings` module will " "be redirected to the logging system. Specifically, a warning will be " @@ -1786,46 +1787,46 @@ msgid "" "`WARNING`." msgstr "" -#: ../Doc/library/logging.rst:1253 +#: ../Doc/library/logging.rst:1254 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 "" -#: ../Doc/library/logging.rst:1261 +#: ../Doc/library/logging.rst:1262 msgid "Module :mod:`logging.config`" msgstr "" -#: ../Doc/library/logging.rst:1261 +#: ../Doc/library/logging.rst:1262 msgid "Configuration API for the logging module." msgstr "" -#: ../Doc/library/logging.rst:1264 +#: ../Doc/library/logging.rst:1265 msgid "Module :mod:`logging.handlers`" msgstr "" -#: ../Doc/library/logging.rst:1264 +#: ../Doc/library/logging.rst:1265 msgid "Useful handlers included with the logging module." msgstr "" -#: ../Doc/library/logging.rst:1268 +#: ../Doc/library/logging.rst:1269 msgid ":pep:`282` - A Logging System" msgstr "" -#: ../Doc/library/logging.rst:1267 +#: ../Doc/library/logging.rst:1268 msgid "" "The proposal which described this feature for inclusion in the Python " "standard library." msgstr "" -#: ../Doc/library/logging.rst:1273 +#: ../Doc/library/logging.rst:1274 msgid "" "`Original Python logging package `_" msgstr "" -#: ../Doc/library/logging.rst:1271 +#: ../Doc/library/logging.rst:1272 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, "