# Copyright (C) 2001-2018, Python Software Foundation
# For licence information, see README file.
#
msgid ""
msgstr ""
"Project-Id-Version: Python 3.6\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2018-10-12 18:59+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
"Language: fr\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#: ../Doc/library/logging.handlers.rst:2
msgid ":mod:`logging.handlers` --- Logging handlers"
msgstr ""

#: ../Doc/library/logging.handlers.rst:10
msgid "**Source code:** :source:`Lib/logging/handlers.py`"
msgstr ""

#: ../Doc/library/logging.handlers.rst:14
msgid ""
"This page contains only reference information. For tutorials, please see"
msgstr ""

#: ../Doc/library/logging.handlers.rst:17
msgid ":ref:`Basic Tutorial <logging-basic-tutorial>`"
msgstr ""

#: ../Doc/library/logging.handlers.rst:18
msgid ":ref:`Advanced Tutorial <logging-advanced-tutorial>`"
msgstr ""

#: ../Doc/library/logging.handlers.rst:19
msgid ":ref:`Logging Cookbook <logging-cookbook>`"
msgstr ""

#: ../Doc/library/logging.handlers.rst:25
msgid ""
"The following useful handlers are provided in the package. Note that three "
"of the handlers (:class:`StreamHandler`, :class:`FileHandler` and :class:"
"`NullHandler`) are actually defined in the :mod:`logging` module itself, but "
"have been documented here along with the other handlers."
msgstr ""

#: ../Doc/library/logging.handlers.rst:33
msgid "StreamHandler"
msgstr ""

#: ../Doc/library/logging.handlers.rst:35
msgid ""
"The :class:`StreamHandler` class, located in the core :mod:`logging` "
"package, sends logging output to streams such as *sys.stdout*, *sys.stderr* "
"or any file-like object (or, more precisely, any object which supports :meth:"
"`write` and :meth:`flush` methods)."
msgstr ""

#: ../Doc/library/logging.handlers.rst:43
msgid ""
"Returns a new instance of the :class:`StreamHandler` class. If *stream* is "
"specified, the instance will use it for logging output; otherwise, *sys."
"stderr* will be used."
msgstr ""

#: ../Doc/library/logging.handlers.rst:50
msgid ""
"If a formatter is specified, it is used to format the record. The record is "
"then written to the stream with a terminator. If exception information is "
"present, it is formatted using :func:`traceback.print_exception` and "
"appended to the stream."
msgstr ""

#: ../Doc/library/logging.handlers.rst:58
msgid ""
"Flushes the stream by calling its :meth:`flush` method. Note that the :meth:"
"`close` method is inherited from :class:`~logging.Handler` and so does no "
"output, so an explicit :meth:`flush` call may be needed at times."
msgstr ""

#: ../Doc/library/logging.handlers.rst:64
msgid ""
"Sets the instance's stream to the specified value, if it is different. The "
"old stream is flushed before the new stream is set."
msgstr ""

#: ../Doc/library/logging.handlers.rst:0
msgid "Parameters"
msgstr ""

#: ../Doc/library/logging.handlers.rst:67
msgid "The stream that the handler should use."
msgstr ""

#: ../Doc/library/logging.handlers.rst:0
msgid "Returns"
msgstr ""

#: ../Doc/library/logging.handlers.rst:69
msgid "the old stream, if the stream was changed, or *None* if it wasn't."
msgstr ""

#: ../Doc/library/logging.handlers.rst:74
msgid ""
"The ``StreamHandler`` class now has a ``terminator`` attribute, default "
"value ``'\\n'``, which is used as the terminator when writing a formatted "
"record to a stream. If you don't want this newline termination, you can set "
"the handler instance's ``terminator`` attribute to the empty string. In "
"earlier versions, the terminator was hardcoded as ``'\\n'``."
msgstr ""

#: ../Doc/library/logging.handlers.rst:85
msgid "FileHandler"
msgstr ""

#: ../Doc/library/logging.handlers.rst:87
msgid ""
"The :class:`FileHandler` class, located in the core :mod:`logging` package, "
"sends logging output to a disk file.  It inherits the output functionality "
"from :class:`StreamHandler`."
msgstr ""

#: ../Doc/library/logging.handlers.rst:94
msgid ""
"Returns a new instance of the :class:`FileHandler` class. The specified file "
"is opened and used as the stream for logging. If *mode* is not specified, :"
"const:`'a'` is used.  If *encoding* is not ``None``, it is used to open the "
"file with that encoding.  If *delay* is true, then file opening is deferred "
"until the first call to :meth:`emit`. By default, the file grows "
"indefinitely."
msgstr ""

#: ../Doc/library/logging.handlers.rst:100
#: ../Doc/library/logging.handlers.rst:179
#: ../Doc/library/logging.handlers.rst:310
#: ../Doc/library/logging.handlers.rst:410
msgid ""
"As well as string values, :class:`~pathlib.Path` objects are also accepted "
"for the *filename* argument."
msgstr ""

#: ../Doc/library/logging.handlers.rst:106
msgid "Closes the file."
msgstr ""

#: ../Doc/library/logging.handlers.rst:111
msgid "Outputs the record to the file."
msgstr ""

#: ../Doc/library/logging.handlers.rst:117
msgid "NullHandler"
msgstr ""

#: ../Doc/library/logging.handlers.rst:121
msgid ""
"The :class:`NullHandler` class, located in the core :mod:`logging` package, "
"does not do any formatting or output. It is essentially a 'no-op' handler "
"for use by library developers."
msgstr ""

#: ../Doc/library/logging.handlers.rst:127
msgid "Returns a new instance of the :class:`NullHandler` class."
msgstr ""

#: ../Doc/library/logging.handlers.rst:131
#: ../Doc/library/logging.handlers.rst:135
msgid "This method does nothing."
msgstr ""

#: ../Doc/library/logging.handlers.rst:139
msgid ""
"This method returns ``None`` for the lock, since there is no underlying I/O "
"to which access needs to be serialized."
msgstr ""

#: ../Doc/library/logging.handlers.rst:143
msgid ""
"See :ref:`library-config` for more information on how to use :class:"
"`NullHandler`."
msgstr ""

#: ../Doc/library/logging.handlers.rst:149
msgid "WatchedFileHandler"
msgstr ""

#: ../Doc/library/logging.handlers.rst:153
msgid ""
"The :class:`WatchedFileHandler` class, located in the :mod:`logging."
"handlers` module, is a :class:`FileHandler` which watches the file it is "
"logging to. If the file changes, it is closed and reopened using the file "
"name."
msgstr ""

#: ../Doc/library/logging.handlers.rst:157
msgid ""
"A file change can happen because of usage of programs such as *newsyslog* "
"and *logrotate* which perform log file rotation. This handler, intended for "
"use under Unix/Linux, watches the file to see if it has changed since the "
"last emit. (A file is deemed to have changed if its device or inode have "
"changed.) If the file has changed, the old file stream is closed, and the "
"file opened to get a new stream."
msgstr ""

#: ../Doc/library/logging.handlers.rst:164
msgid ""
"This handler is not appropriate for use under Windows, because under Windows "
"open log files cannot be moved or renamed - logging opens the files with "
"exclusive locks - and so there is no need for such a handler. Furthermore, "
"*ST_INO* is not supported under Windows; :func:`~os.stat` always returns "
"zero for this value."
msgstr ""

#: ../Doc/library/logging.handlers.rst:173
msgid ""
"Returns a new instance of the :class:`WatchedFileHandler` class. The "
"specified file is opened and used as the stream for logging. If *mode* is "
"not specified, :const:`'a'` is used.  If *encoding* is not ``None``, it is "
"used to open the file with that encoding.  If *delay* is true, then file "
"opening is deferred until the first call to :meth:`emit`.  By default, the "
"file grows indefinitely."
msgstr ""

#: ../Doc/library/logging.handlers.rst:185
msgid ""
"Checks to see if the file has changed.  If it has, the existing stream is "
"flushed and closed and the file opened again, typically as a precursor to "
"outputting the record to the file."
msgstr ""

#: ../Doc/library/logging.handlers.rst:194
msgid ""
"Outputs the record to the file, but first calls :meth:`reopenIfNeeded` to "
"reopen the file if it has changed."
msgstr ""

#: ../Doc/library/logging.handlers.rst:200
msgid "BaseRotatingHandler"
msgstr ""

#: ../Doc/library/logging.handlers.rst:202
msgid ""
"The :class:`BaseRotatingHandler` class, located in the :mod:`logging."
"handlers` module, is the base class for the rotating file handlers, :class:"
"`RotatingFileHandler` and :class:`TimedRotatingFileHandler`. You should not "
"need to instantiate this class, but it has attributes and methods you may "
"need to override."
msgstr ""

#: ../Doc/library/logging.handlers.rst:210
msgid "The parameters are as for :class:`FileHandler`. The attributes are:"
msgstr ""

#: ../Doc/library/logging.handlers.rst:214
msgid ""
"If this attribute is set to a callable, the :meth:`rotation_filename` method "
"delegates to this callable. The parameters passed to the callable are those "
"passed to :meth:`rotation_filename`."
msgstr ""

#: ../Doc/library/logging.handlers.rst:218
msgid ""
"The namer function is called quite a few times during rollover, so it should "
"be as simple and as fast as possible. It should also return the same output "
"every time for a given input, otherwise the rollover behaviour may not work "
"as expected."
msgstr ""

#: ../Doc/library/logging.handlers.rst:228
msgid ""
"If this attribute is set to a callable, the :meth:`rotate` method delegates "
"to this callable.  The parameters passed to the callable are those passed "
"to :meth:`rotate`."
msgstr ""

#: ../Doc/library/logging.handlers.rst:236
msgid "Modify the filename of a log file when rotating."
msgstr ""

#: ../Doc/library/logging.handlers.rst:238
msgid "This is provided so that a custom filename can be provided."
msgstr ""

#: ../Doc/library/logging.handlers.rst:240
msgid ""
"The default implementation calls the 'namer' attribute of the handler, if "
"it's callable, passing the default name to it. If the attribute isn't "
"callable (the default is ``None``), the name is returned unchanged."
msgstr ""

#: ../Doc/library/logging.handlers.rst:244
msgid "The default name for the log file."
msgstr ""

#: ../Doc/library/logging.handlers.rst:251
msgid "When rotating, rotate the current log."
msgstr ""

#: ../Doc/library/logging.handlers.rst:253
msgid ""
"The default implementation calls the 'rotator' attribute of the handler, if "
"it's callable, passing the source and dest arguments to it. If the attribute "
"isn't callable (the default is ``None``), the source is simply renamed to "
"the destination."
msgstr ""

#: ../Doc/library/logging.handlers.rst:258
msgid ""
"The source filename. This is normally the base filename, e.g. 'test.log'."
msgstr ""

#: ../Doc/library/logging.handlers.rst:260
msgid ""
"The destination filename. This is normally what the source is rotated to, e."
"g. 'test.log.1'."
msgstr ""

#: ../Doc/library/logging.handlers.rst:265
msgid ""
"The reason the attributes exist is to save you having to subclass - you can "
"use the same callables for instances of :class:`RotatingFileHandler` and :"
"class:`TimedRotatingFileHandler`. If either the namer or rotator callable "
"raises an exception, this will be handled in the same way as any other "
"exception during an :meth:`emit` call, i.e. via the :meth:`handleError` "
"method of the handler."
msgstr ""

#: ../Doc/library/logging.handlers.rst:272
msgid ""
"If you need to make more significant changes to rotation processing, you can "
"override the methods."
msgstr ""

#: ../Doc/library/logging.handlers.rst:275
msgid "For an example, see :ref:`cookbook-rotator-namer`."
msgstr ""

#: ../Doc/library/logging.handlers.rst:281
msgid "RotatingFileHandler"
msgstr ""

#: ../Doc/library/logging.handlers.rst:283
msgid ""
"The :class:`RotatingFileHandler` class, located in the :mod:`logging."
"handlers` module, supports rotation of disk log files."
msgstr ""

#: ../Doc/library/logging.handlers.rst:289
msgid ""
"Returns a new instance of the :class:`RotatingFileHandler` class. The "
"specified file is opened and used as the stream for logging. If *mode* is "
"not specified, ``'a'`` is used.  If *encoding* is not ``None``, it is used "
"to open the file with that encoding.  If *delay* is true, then file opening "
"is deferred until the first call to :meth:`emit`.  By default, the file "
"grows indefinitely."
msgstr ""

#: ../Doc/library/logging.handlers.rst:295
msgid ""
"You can use the *maxBytes* and *backupCount* values to allow the file to :"
"dfn:`rollover` at a predetermined size. When the size is about to be "
"exceeded, the file is closed and a new file is silently opened for output. "
"Rollover occurs whenever the current log file is nearly *maxBytes* in "
"length; but if either of *maxBytes* or *backupCount* is zero, rollover never "
"occurs, so you generally want to set *backupCount* to at least 1, and have a "
"non-zero *maxBytes*. When *backupCount* is non-zero, the system will save "
"old log files by appending the extensions '.1', '.2' etc., to the filename. "
"For example, with a *backupCount* of 5 and a base file name of :file:`app."
"log`, you would get :file:`app.log`, :file:`app.log.1`, :file:`app.log.2`, "
"up to :file:`app.log.5`. The file being written to is always :file:`app."
"log`.  When this file is filled, it is closed and renamed to :file:`app."
"log.1`, and if files :file:`app.log.1`, :file:`app.log.2`, etc. exist, then "
"they are renamed to :file:`app.log.2`, :file:`app.log.3` etc. respectively."
msgstr ""

#: ../Doc/library/logging.handlers.rst:316
#: ../Doc/library/logging.handlers.rst:416
msgid "Does a rollover, as described above."
msgstr ""

#: ../Doc/library/logging.handlers.rst:321
msgid ""
"Outputs the record to the file, catering for rollover as described "
"previously."
msgstr ""

#: ../Doc/library/logging.handlers.rst:327
msgid "TimedRotatingFileHandler"
msgstr ""

#: ../Doc/library/logging.handlers.rst:329
msgid ""
"The :class:`TimedRotatingFileHandler` class, located in the :mod:`logging."
"handlers` module, supports rotation of disk log files at certain timed "
"intervals."
msgstr ""

#: ../Doc/library/logging.handlers.rst:336
msgid ""
"Returns a new instance of the :class:`TimedRotatingFileHandler` class. The "
"specified file is opened and used as the stream for logging. On rotating it "
"also sets the filename suffix. Rotating happens based on the product of "
"*when* and *interval*."
msgstr ""

#: ../Doc/library/logging.handlers.rst:341
msgid ""
"You can use the *when* to specify the type of *interval*. The list of "
"possible values is below.  Note that they are not case sensitive."
msgstr ""

#: ../Doc/library/logging.handlers.rst:345
msgid "Value"
msgstr "Valeur"

#: ../Doc/library/logging.handlers.rst:345
msgid "Type of interval"
msgstr ""

#: ../Doc/library/logging.handlers.rst:345
msgid "If/how *atTime* is used"
msgstr ""

#: ../Doc/library/logging.handlers.rst:347
msgid "``'S'``"
msgstr "``'S'``"

#: ../Doc/library/logging.handlers.rst:347
msgid "Seconds"
msgstr ""

#: ../Doc/library/logging.handlers.rst:347
#: ../Doc/library/logging.handlers.rst:349
#: ../Doc/library/logging.handlers.rst:351
#: ../Doc/library/logging.handlers.rst:353
msgid "Ignored"
msgstr "Ignoré"

#: ../Doc/library/logging.handlers.rst:349
msgid "``'M'``"
msgstr "``'M'``"

#: ../Doc/library/logging.handlers.rst:349
msgid "Minutes"
msgstr ""

#: ../Doc/library/logging.handlers.rst:351
msgid "``'H'``"
msgstr "``'H'``"

#: ../Doc/library/logging.handlers.rst:351
msgid "Hours"
msgstr ""

#: ../Doc/library/logging.handlers.rst:353
msgid "``'D'``"
msgstr "``'D'``"

#: ../Doc/library/logging.handlers.rst:353
msgid "Days"
msgstr ""

#: ../Doc/library/logging.handlers.rst:355
msgid "``'W0'-'W6'``"
msgstr "``'W0'-'W6'``"

#: ../Doc/library/logging.handlers.rst:355
msgid "Weekday (0=Monday)"
msgstr ""

#: ../Doc/library/logging.handlers.rst:355
#: ../Doc/library/logging.handlers.rst:358
msgid "Used to compute initial rollover time"
msgstr ""

#: ../Doc/library/logging.handlers.rst:358
msgid "``'midnight'``"
msgstr "``'midnight'``"

#: ../Doc/library/logging.handlers.rst:358
msgid "Roll over at midnight, if *atTime* not specified, else at time *atTime*"
msgstr ""

#: ../Doc/library/logging.handlers.rst:363
msgid ""
"When using weekday-based rotation, specify 'W0' for Monday, 'W1' for "
"Tuesday, and so on up to 'W6' for Sunday. In this case, the value passed for "
"*interval* isn't used."
msgstr ""

#: ../Doc/library/logging.handlers.rst:367
msgid ""
"The system will save old log files by appending extensions to the filename. "
"The extensions are date-and-time based, using the strftime format ``%Y-%m-%d_"
"%H-%M-%S`` or a leading portion thereof, depending on the rollover interval."
msgstr ""

#: ../Doc/library/logging.handlers.rst:372
msgid ""
"When computing the next rollover time for the first time (when the handler "
"is created), the last modification time of an existing log file, or else the "
"current time, is used to compute when the next rotation will occur."
msgstr ""

#: ../Doc/library/logging.handlers.rst:376
msgid ""
"If the *utc* argument is true, times in UTC will be used; otherwise local "
"time is used."
msgstr ""

#: ../Doc/library/logging.handlers.rst:379
msgid ""
"If *backupCount* is nonzero, at most *backupCount* files will be kept, and "
"if more would be created when rollover occurs, the oldest one is deleted. "
"The deletion logic uses the interval to determine which files to delete, so "
"changing the interval may leave old files lying around."
msgstr ""

#: ../Doc/library/logging.handlers.rst:384
msgid ""
"If *delay* is true, then file opening is deferred until the first call to :"
"meth:`emit`."
msgstr ""

#: ../Doc/library/logging.handlers.rst:387
msgid ""
"If *atTime* is not ``None``, it must be a ``datetime.time`` instance which "
"specifies the time of day when rollover occurs, for the cases where rollover "
"is set to happen \"at midnight\" or \"on a particular weekday\". Note that "
"in these cases, the *atTime* value is effectively used to compute the "
"*initial* rollover, and subsequent rollovers would be calculated via the "
"normal interval calculation."
msgstr ""

#: ../Doc/library/logging.handlers.rst:394
msgid ""
"Calculation of the initial rollover time is done when the handler is "
"initialised. Calculation of subsequent rollover times is done only when "
"rollover occurs, and rollover occurs only when emitting output. If this is "
"not kept in mind, it might lead to some confusion. For example, if an "
"interval of \"every minute\" is set, that does not mean you will always see "
"log files with times (in the filename) separated by a minute; if, during "
"application execution, logging output is generated more frequently than once "
"a minute, *then* you can expect to see log files with times separated by a "
"minute. If, on the other hand, logging messages are only output once every "
"five minutes (say), then there will be gaps in the file times corresponding "
"to the minutes where no output (and hence no rollover) occurred."
msgstr ""

#: ../Doc/library/logging.handlers.rst:407
msgid "*atTime* parameter was added."
msgstr ""

#: ../Doc/library/logging.handlers.rst:420
msgid ""
"Outputs the record to the file, catering for rollover as described above."
msgstr ""

#: ../Doc/library/logging.handlers.rst:426
msgid "SocketHandler"
msgstr ""

#: ../Doc/library/logging.handlers.rst:428
msgid ""
"The :class:`SocketHandler` class, located in the :mod:`logging.handlers` "
"module, sends logging output to a network socket. The base class uses a TCP "
"socket."
msgstr ""

#: ../Doc/library/logging.handlers.rst:434
msgid ""
"Returns a new instance of the :class:`SocketHandler` class intended to "
"communicate with a remote machine whose address is given by *host* and "
"*port*."
msgstr ""

#: ../Doc/library/logging.handlers.rst:437
msgid ""
"If ``port`` is specified as ``None``, a Unix domain socket is created using "
"the value in ``host`` - otherwise, a TCP socket is created."
msgstr ""

#: ../Doc/library/logging.handlers.rst:443
msgid "Closes the socket."
msgstr ""

#: ../Doc/library/logging.handlers.rst:448
msgid ""
"Pickles the record's attribute dictionary and writes it to the socket in "
"binary format. If there is an error with the socket, silently drops the "
"packet. If the connection was previously lost, re-establishes the "
"connection. To unpickle the record at the receiving end into a :class:"
"`~logging.LogRecord`, use the :func:`~logging.makeLogRecord` function."
msgstr ""

#: ../Doc/library/logging.handlers.rst:458
msgid ""
"Handles an error which has occurred during :meth:`emit`. The most likely "
"cause is a lost connection. Closes the socket so that we can retry on the "
"next event."
msgstr ""

#: ../Doc/library/logging.handlers.rst:465
msgid ""
"This is a factory method which allows subclasses to define the precise type "
"of socket they want. The default implementation creates a TCP socket (:const:"
"`socket.SOCK_STREAM`)."
msgstr ""

#: ../Doc/library/logging.handlers.rst:472
msgid ""
"Pickles the record's attribute dictionary in binary format with a length "
"prefix, and returns it ready for transmission across the socket."
msgstr ""

#: ../Doc/library/logging.handlers.rst:475
msgid ""
"Note that pickles aren't completely secure. If you are concerned about "
"security, you may want to override this method to implement a more secure "
"mechanism. For example, you can sign pickles using HMAC and then verify them "
"on the receiving end, or alternatively you can disable unpickling of global "
"objects on the receiving end."
msgstr ""

#: ../Doc/library/logging.handlers.rst:484
msgid ""
"Send a pickled string *packet* to the socket. This function allows for "
"partial sends which can happen when the network is busy."
msgstr ""

#: ../Doc/library/logging.handlers.rst:490
msgid ""
"Tries to create a socket; on failure, uses an exponential back-off "
"algorithm.  On initial failure, the handler will drop the message it was "
"trying to send.  When subsequent messages are handled by the same instance, "
"it will not try connecting until some time has passed.  The default "
"parameters are such that the initial delay is one second, and if after that "
"delay the connection still can't be made, the handler will double the delay "
"each time up to a maximum of 30 seconds."
msgstr ""

#: ../Doc/library/logging.handlers.rst:498
msgid "This behaviour is controlled by the following handler attributes:"
msgstr ""

#: ../Doc/library/logging.handlers.rst:500
msgid "``retryStart`` (initial delay, defaulting to 1.0 seconds)."
msgstr ""

#: ../Doc/library/logging.handlers.rst:501
msgid "``retryFactor`` (multiplier, defaulting to 2.0)."
msgstr ""

#: ../Doc/library/logging.handlers.rst:502
msgid "``retryMax`` (maximum delay, defaulting to 30.0 seconds)."
msgstr ""

#: ../Doc/library/logging.handlers.rst:504
msgid ""
"This means that if the remote listener starts up *after* the handler has "
"been used, you could lose messages (since the handler won't even attempt a "
"connection until the delay has elapsed, but just silently drop messages "
"during the delay period)."
msgstr ""

#: ../Doc/library/logging.handlers.rst:513
msgid "DatagramHandler"
msgstr ""

#: ../Doc/library/logging.handlers.rst:515
msgid ""
"The :class:`DatagramHandler` class, located in the :mod:`logging.handlers` "
"module, inherits from :class:`SocketHandler` to support sending logging "
"messages over UDP sockets."
msgstr ""

#: ../Doc/library/logging.handlers.rst:522
msgid ""
"Returns a new instance of the :class:`DatagramHandler` class intended to "
"communicate with a remote machine whose address is given by *host* and "
"*port*."
msgstr ""

#: ../Doc/library/logging.handlers.rst:525
msgid ""
"If ``port`` is specified as ``None``, a Unix domain socket is created using "
"the value in ``host`` - otherwise, a UDP socket is created."
msgstr ""

#: ../Doc/library/logging.handlers.rst:531
msgid ""
"Pickles the record's attribute dictionary and writes it to the socket in "
"binary format. If there is an error with the socket, silently drops the "
"packet. To unpickle the record at the receiving end into a :class:`~logging."
"LogRecord`, use the :func:`~logging.makeLogRecord` function."
msgstr ""

#: ../Doc/library/logging.handlers.rst:540
msgid ""
"The factory method of :class:`SocketHandler` is here overridden to create a "
"UDP socket (:const:`socket.SOCK_DGRAM`)."
msgstr ""

#: ../Doc/library/logging.handlers.rst:546
msgid "Send a pickled string to a socket."
msgstr ""

#: ../Doc/library/logging.handlers.rst:552
msgid "SysLogHandler"
msgstr ""

#: ../Doc/library/logging.handlers.rst:554
msgid ""
"The :class:`SysLogHandler` class, located in the :mod:`logging.handlers` "
"module, supports sending logging messages to a remote or local Unix syslog."
msgstr ""

#: ../Doc/library/logging.handlers.rst:560
msgid ""
"Returns a new instance of the :class:`SysLogHandler` class intended to "
"communicate with a remote Unix machine whose address is given by *address* "
"in the form of a ``(host, port)`` tuple.  If *address* is not specified, "
"``('localhost', 514)`` is used.  The address is used to open a socket.  An "
"alternative to providing a ``(host, port)`` tuple is providing an address as "
"a string, for example '/dev/log'. In this case, a Unix domain socket is used "
"to send the message to the syslog. If *facility* is not specified, :const:"
"`LOG_USER` is used. The type of socket opened depends on the *socktype* "
"argument, which defaults to :const:`socket.SOCK_DGRAM` and thus opens a UDP "
"socket. To open a TCP socket (for use with the newer syslog daemons such as "
"rsyslog), specify a value of :const:`socket.SOCK_STREAM`."
msgstr ""

#: ../Doc/library/logging.handlers.rst:572
msgid ""
"Note that if your server is not listening on UDP port 514, :class:"
"`SysLogHandler` may appear not to work. In that case, check what address you "
"should be using for a domain socket - it's system dependent. For example, on "
"Linux it's usually '/dev/log' but on OS/X it's '/var/run/syslog'. You'll "
"need to check your platform and use the appropriate address (you may need to "
"do this check at runtime if your application needs to run on several "
"platforms). On Windows, you pretty much have to use the UDP option."
msgstr ""

#: ../Doc/library/logging.handlers.rst:581
msgid "*socktype* was added."
msgstr ""

#: ../Doc/library/logging.handlers.rst:587
msgid "Closes the socket to the remote host."
msgstr ""

#: ../Doc/library/logging.handlers.rst:592
msgid ""
"The record is formatted, and then sent to the syslog server. If exception "
"information is present, it is *not* sent to the server."
msgstr ""

#: ../Doc/library/logging.handlers.rst:595
msgid ""
"(See: :issue:`12168`.) In earlier versions, the message sent to the syslog "
"daemons was always terminated with a NUL byte, because early versions of "
"these daemons expected a NUL terminated message - even though it's not in "
"the relevant specification (:rfc:`5424`). More recent versions of these "
"daemons don't expect the NUL byte but strip it off if it's there, and even "
"more recent daemons (which adhere more closely to RFC 5424) pass the NUL "
"byte on as part of the message."
msgstr ""

#: ../Doc/library/logging.handlers.rst:604
msgid ""
"To enable easier handling of syslog messages in the face of all these "
"differing daemon behaviours, the appending of the NUL byte has been made "
"configurable, through the use of a class-level attribute, ``append_nul``. "
"This defaults to ``True`` (preserving the existing behaviour) but can be set "
"to ``False`` on a ``SysLogHandler`` instance in order for that instance to "
"*not* append the NUL terminator."
msgstr ""

#: ../Doc/library/logging.handlers.rst:611
msgid ""
"(See: :issue:`12419`.) In earlier versions, there was no facility for an "
"\"ident\" or \"tag\" prefix to identify the source of the message. This can "
"now be specified using a class-level attribute, defaulting to ``\"\"`` to "
"preserve existing behaviour, but which can be overridden on a "
"``SysLogHandler`` instance in order for that instance to prepend the ident "
"to every message handled. Note that the provided ident must be text, not "
"bytes, and is prepended to the message exactly as is."
msgstr ""

#: ../Doc/library/logging.handlers.rst:622
msgid ""
"Encodes the facility and priority into an integer. You can pass in strings "
"or integers - if strings are passed, internal mapping dictionaries are used "
"to convert them to integers."
msgstr ""

#: ../Doc/library/logging.handlers.rst:626
msgid ""
"The symbolic ``LOG_`` values are defined in :class:`SysLogHandler` and "
"mirror the values defined in the ``sys/syslog.h`` header file."
msgstr ""

#: ../Doc/library/logging.handlers.rst:629
msgid "**Priorities**"
msgstr ""

#: ../Doc/library/logging.handlers.rst:632
#: ../Doc/library/logging.handlers.rst:654
msgid "Name (string)"
msgstr ""

#: ../Doc/library/logging.handlers.rst:632
#: ../Doc/library/logging.handlers.rst:654
msgid "Symbolic value"
msgstr ""

#: ../Doc/library/logging.handlers.rst:634
msgid "``alert``"
msgstr "``alert``"

#: ../Doc/library/logging.handlers.rst:634
msgid "LOG_ALERT"
msgstr "LOG_ALERT"

#: ../Doc/library/logging.handlers.rst:636
msgid "``crit`` or ``critical``"
msgstr "``crit`` ou ``critical``"

#: ../Doc/library/logging.handlers.rst:636
msgid "LOG_CRIT"
msgstr "LOG_CRIT"

#: ../Doc/library/logging.handlers.rst:638
msgid "``debug``"
msgstr "``debug``"

#: ../Doc/library/logging.handlers.rst:638
msgid "LOG_DEBUG"
msgstr "LOG_DEBUG"

#: ../Doc/library/logging.handlers.rst:640
msgid "``emerg`` or ``panic``"
msgstr "``emerg`` ou ``panic``"

#: ../Doc/library/logging.handlers.rst:640
msgid "LOG_EMERG"
msgstr "LOG_EMERG"

#: ../Doc/library/logging.handlers.rst:642
msgid "``err`` or ``error``"
msgstr "``err`` ou ``error``"

#: ../Doc/library/logging.handlers.rst:642
msgid "LOG_ERR"
msgstr "LOG_ERR"

#: ../Doc/library/logging.handlers.rst:644
msgid "``info``"
msgstr "``info``"

#: ../Doc/library/logging.handlers.rst:644
msgid "LOG_INFO"
msgstr "LOG_INFO"

#: ../Doc/library/logging.handlers.rst:646
msgid "``notice``"
msgstr "``notice``"

#: ../Doc/library/logging.handlers.rst:646
msgid "LOG_NOTICE"
msgstr "LOG_NOTICE"

#: ../Doc/library/logging.handlers.rst:648
msgid "``warn`` or ``warning``"
msgstr "``warn`` ou ``warning``"

#: ../Doc/library/logging.handlers.rst:648
msgid "LOG_WARNING"
msgstr "LOG_WARNING"

#: ../Doc/library/logging.handlers.rst:651
msgid "**Facilities**"
msgstr ""

#: ../Doc/library/logging.handlers.rst:656
msgid "``auth``"
msgstr "``auth``"

#: ../Doc/library/logging.handlers.rst:656
msgid "LOG_AUTH"
msgstr "LOG_AUTH"

#: ../Doc/library/logging.handlers.rst:658
msgid "``authpriv``"
msgstr "``authpriv``"

#: ../Doc/library/logging.handlers.rst:658
msgid "LOG_AUTHPRIV"
msgstr "LOG_AUTHPRIV"

#: ../Doc/library/logging.handlers.rst:660
msgid "``cron``"
msgstr "``cron``"

#: ../Doc/library/logging.handlers.rst:660
msgid "LOG_CRON"
msgstr "LOG_CRON"

#: ../Doc/library/logging.handlers.rst:662
msgid "``daemon``"
msgstr "``daemon``"

#: ../Doc/library/logging.handlers.rst:662
msgid "LOG_DAEMON"
msgstr "LOG_DAEMON"

#: ../Doc/library/logging.handlers.rst:664
msgid "``ftp``"
msgstr "``ftp``"

#: ../Doc/library/logging.handlers.rst:664
msgid "LOG_FTP"
msgstr "LOG_FTP"

#: ../Doc/library/logging.handlers.rst:666
msgid "``kern``"
msgstr "``kern``"

#: ../Doc/library/logging.handlers.rst:666
msgid "LOG_KERN"
msgstr "LOG_KERN"

#: ../Doc/library/logging.handlers.rst:668
msgid "``lpr``"
msgstr "``lpr``"

#: ../Doc/library/logging.handlers.rst:668
msgid "LOG_LPR"
msgstr "LOG_LPR"

#: ../Doc/library/logging.handlers.rst:670
msgid "``mail``"
msgstr "``mail``"

#: ../Doc/library/logging.handlers.rst:670
msgid "LOG_MAIL"
msgstr "LOG_MAIL"

#: ../Doc/library/logging.handlers.rst:672
msgid "``news``"
msgstr "``news``"

#: ../Doc/library/logging.handlers.rst:672
msgid "LOG_NEWS"
msgstr "LOG_NEWS"

#: ../Doc/library/logging.handlers.rst:674
msgid "``syslog``"
msgstr "``syslog``"

#: ../Doc/library/logging.handlers.rst:674
msgid "LOG_SYSLOG"
msgstr "LOG_SYSLOG"

#: ../Doc/library/logging.handlers.rst:676
msgid "``user``"
msgstr "``user``"

#: ../Doc/library/logging.handlers.rst:676
msgid "LOG_USER"
msgstr "LOG_USER"

#: ../Doc/library/logging.handlers.rst:678
msgid "``uucp``"
msgstr "``uucp``"

#: ../Doc/library/logging.handlers.rst:678
msgid "LOG_UUCP"
msgstr "LOG_UUCP"

#: ../Doc/library/logging.handlers.rst:680
msgid "``local0``"
msgstr "``local0``"

#: ../Doc/library/logging.handlers.rst:680
msgid "LOG_LOCAL0"
msgstr "LOG_LOCAL0"

#: ../Doc/library/logging.handlers.rst:682
msgid "``local1``"
msgstr "``local1``"

#: ../Doc/library/logging.handlers.rst:682
msgid "LOG_LOCAL1"
msgstr "LOG_LOCAL1"

#: ../Doc/library/logging.handlers.rst:684
msgid "``local2``"
msgstr "``local2``"

#: ../Doc/library/logging.handlers.rst:684
msgid "LOG_LOCAL2"
msgstr "LOG_LOCAL2"

#: ../Doc/library/logging.handlers.rst:686
msgid "``local3``"
msgstr "``local3``"

#: ../Doc/library/logging.handlers.rst:686
msgid "LOG_LOCAL3"
msgstr "LOG_LOCAL3"

#: ../Doc/library/logging.handlers.rst:688
msgid "``local4``"
msgstr "``local4``"

#: ../Doc/library/logging.handlers.rst:688
msgid "LOG_LOCAL4"
msgstr "LOG_LOCAL4"

#: ../Doc/library/logging.handlers.rst:690
msgid "``local5``"
msgstr "``local5``"

#: ../Doc/library/logging.handlers.rst:690
msgid "LOG_LOCAL5"
msgstr "LOG_LOCAL5"

#: ../Doc/library/logging.handlers.rst:692
msgid "``local6``"
msgstr "``local6``"

#: ../Doc/library/logging.handlers.rst:692
msgid "LOG_LOCAL6"
msgstr "LOG_LOCAL6"

#: ../Doc/library/logging.handlers.rst:694
msgid "``local7``"
msgstr "``local7``"

#: ../Doc/library/logging.handlers.rst:694
msgid "LOG_LOCAL7"
msgstr "LOG_LOCAL7"

#: ../Doc/library/logging.handlers.rst:699
msgid ""
"Maps a logging level name to a syslog priority name. You may need to "
"override this if you are using custom levels, or if the default algorithm is "
"not suitable for your needs. The default algorithm maps ``DEBUG``, ``INFO``, "
"``WARNING``, ``ERROR`` and ``CRITICAL`` to the equivalent syslog names, and "
"all other level names to 'warning'."
msgstr ""

#: ../Doc/library/logging.handlers.rst:709
msgid "NTEventLogHandler"
msgstr ""

#: ../Doc/library/logging.handlers.rst:711
msgid ""
"The :class:`NTEventLogHandler` class, located in the :mod:`logging.handlers` "
"module, supports sending logging messages to a local Windows NT, Windows "
"2000 or Windows XP event log. Before you can use it, you need Mark Hammond's "
"Win32 extensions for Python installed."
msgstr ""

#: ../Doc/library/logging.handlers.rst:719
msgid ""
"Returns a new instance of the :class:`NTEventLogHandler` class. The "
"*appname* is used to define the application name as it appears in the event "
"log. An appropriate registry entry is created using this name. The *dllname* "
"should give the fully qualified pathname of a .dll or .exe which contains "
"message definitions to hold in the log (if not specified, ``'win32service."
"pyd'`` is used - this is installed with the Win32 extensions and contains "
"some basic placeholder message definitions. Note that use of these "
"placeholders will make your event logs big, as the entire message source is "
"held in the log. If you want slimmer logs, you have to pass in the name of "
"your own .dll or .exe which contains the message definitions you want to use "
"in the event log). The *logtype* is one of ``'Application'``, ``'System'`` "
"or ``'Security'``, and defaults to ``'Application'``."
msgstr ""

#: ../Doc/library/logging.handlers.rst:735
msgid ""
"At this point, you can remove the application name from the registry as a "
"source of event log entries. However, if you do this, you will not be able "
"to see the events as you intended in the Event Log Viewer - it needs to be "
"able to access the registry to get the .dll name. The current version does "
"not do this."
msgstr ""

#: ../Doc/library/logging.handlers.rst:744
msgid ""
"Determines the message ID, event category and event type, and then logs the "
"message in the NT event log."
msgstr ""

#: ../Doc/library/logging.handlers.rst:750
msgid ""
"Returns the event category for the record. Override this if you want to "
"specify your own categories. This version returns 0."
msgstr ""

#: ../Doc/library/logging.handlers.rst:756
msgid ""
"Returns the event type for the record. Override this if you want to specify "
"your own types. This version does a mapping using the handler's typemap "
"attribute, which is set up in :meth:`__init__` to a dictionary which "
"contains mappings for :const:`DEBUG`, :const:`INFO`, :const:`WARNING`, :"
"const:`ERROR` and :const:`CRITICAL`. If you are using your own levels, you "
"will either need to override this method or place a suitable dictionary in "
"the handler's *typemap* attribute."
msgstr ""

#: ../Doc/library/logging.handlers.rst:767
msgid ""
"Returns the message ID for the record. If you are using your own messages, "
"you could do this by having the *msg* passed to the logger being an ID "
"rather than a format string. Then, in here, you could use a dictionary "
"lookup to get the message ID. This version returns 1, which is the base "
"message ID in :file:`win32service.pyd`."
msgstr ""

#: ../Doc/library/logging.handlers.rst:776
msgid "SMTPHandler"
msgstr ""

#: ../Doc/library/logging.handlers.rst:778
msgid ""
"The :class:`SMTPHandler` class, located in the :mod:`logging.handlers` "
"module, supports sending logging messages to an email address via SMTP."
msgstr ""

#: ../Doc/library/logging.handlers.rst:784
msgid ""
"Returns a new instance of the :class:`SMTPHandler` class. The instance is "
"initialized with the from and to addresses and subject line of the email. "
"The *toaddrs* should be a list of strings. To specify a non-standard SMTP "
"port, use the (host, port) tuple format for the *mailhost* argument. If you "
"use a string, the standard SMTP port is used. If your SMTP server requires "
"authentication, you can specify a (username, password) tuple for the "
"*credentials* argument."
msgstr ""

#: ../Doc/library/logging.handlers.rst:791
msgid ""
"To specify the use of a secure protocol (TLS), pass in a tuple to the "
"*secure* argument. This will only be used when authentication credentials "
"are supplied. The tuple should be either an empty tuple, or a single-value "
"tuple with the name of a keyfile, or a 2-value tuple with the names of the "
"keyfile and certificate file. (This tuple is passed to the :meth:`smtplib."
"SMTP.starttls` method.)"
msgstr ""

#: ../Doc/library/logging.handlers.rst:798
msgid ""
"A timeout can be specified for communication with the SMTP server using the "
"*timeout* argument."
msgstr ""

#: ../Doc/library/logging.handlers.rst:801
msgid "The *timeout* argument was added."
msgstr ""

#: ../Doc/library/logging.handlers.rst:806
msgid "Formats the record and sends it to the specified addressees."
msgstr ""

#: ../Doc/library/logging.handlers.rst:811
msgid ""
"If you want to specify a subject line which is record-dependent, override "
"this method."
msgstr ""

#: ../Doc/library/logging.handlers.rst:817
msgid "MemoryHandler"
msgstr ""

#: ../Doc/library/logging.handlers.rst:819
msgid ""
"The :class:`MemoryHandler` class, located in the :mod:`logging.handlers` "
"module, supports buffering of logging records in memory, periodically "
"flushing them to a :dfn:`target` handler. Flushing occurs whenever the "
"buffer is full, or when an event of a certain severity or greater is seen."
msgstr ""

#: ../Doc/library/logging.handlers.rst:824
msgid ""
":class:`MemoryHandler` is a subclass of the more general :class:"
"`BufferingHandler`, which is an abstract class. This buffers logging records "
"in memory. Whenever each record is added to the buffer, a check is made by "
"calling :meth:`shouldFlush` to see if the buffer should be flushed.  If it "
"should, then :meth:`flush` is expected to do the flushing."
msgstr ""

#: ../Doc/library/logging.handlers.rst:833
msgid "Initializes the handler with a buffer of the specified capacity."
msgstr ""

#: ../Doc/library/logging.handlers.rst:838
msgid ""
"Appends the record to the buffer. If :meth:`shouldFlush` returns true, "
"calls :meth:`flush` to process the buffer."
msgstr ""

#: ../Doc/library/logging.handlers.rst:844
msgid ""
"You can override this to implement custom flushing behavior. This version "
"just zaps the buffer to empty."
msgstr ""

#: ../Doc/library/logging.handlers.rst:850
msgid ""
"Returns true if the buffer is up to capacity. This method can be overridden "
"to implement custom flushing strategies."
msgstr ""

#: ../Doc/library/logging.handlers.rst:856
msgid ""
"Returns a new instance of the :class:`MemoryHandler` class. The instance is "
"initialized with a buffer size of *capacity*. If *flushLevel* is not "
"specified, :const:`ERROR` is used. If no *target* is specified, the target "
"will need to be set using :meth:`setTarget` before this handler does "
"anything useful. If *flushOnClose* is specified as ``False``, then the "
"buffer is *not* flushed when the handler is closed. If not specified or "
"specified as ``True``, the previous behaviour of flushing the buffer will "
"occur when the handler is closed."
msgstr ""

#: ../Doc/library/logging.handlers.rst:864
msgid "The *flushOnClose* parameter was added."
msgstr ""

#: ../Doc/library/logging.handlers.rst:870
msgid "Calls :meth:`flush`, sets the target to ``None`` and clears the buffer."
msgstr ""

#: ../Doc/library/logging.handlers.rst:876
msgid ""
"For a :class:`MemoryHandler`, flushing means just sending the buffered "
"records to the target, if there is one. The buffer is also cleared when this "
"happens. Override if you want different behavior."
msgstr ""

#: ../Doc/library/logging.handlers.rst:883
msgid "Sets the target handler for this handler."
msgstr ""

#: ../Doc/library/logging.handlers.rst:888
msgid "Checks for buffer full or a record at the *flushLevel* or higher."
msgstr ""

#: ../Doc/library/logging.handlers.rst:894
msgid "HTTPHandler"
msgstr ""

#: ../Doc/library/logging.handlers.rst:896
msgid ""
"The :class:`HTTPHandler` class, located in the :mod:`logging.handlers` "
"module, supports sending logging messages to a Web server, using either "
"``GET`` or ``POST`` semantics."
msgstr ""

#: ../Doc/library/logging.handlers.rst:903
msgid ""
"Returns a new instance of the :class:`HTTPHandler` class. The *host* can be "
"of the form ``host:port``, should you need to use a specific port number.  "
"If no *method* is specified, ``GET`` is used. If *secure* is true, a HTTPS "
"connection will be used. The *context* parameter may be set to a :class:`ssl."
"SSLContext` instance to configure the SSL settings used for the HTTPS "
"connection. If *credentials* is specified, it should be a 2-tuple consisting "
"of userid and password, which will be placed in a HTTP 'Authorization' "
"header using Basic authentication. If you specify credentials, you should "
"also specify secure=True so that your userid and password are not passed in "
"cleartext across the wire."
msgstr ""

#: ../Doc/library/logging.handlers.rst:914
msgid "The *context* parameter was added."
msgstr ""

#: ../Doc/library/logging.handlers.rst:919
msgid ""
"Provides a dictionary, based on ``record``, which is to be URL-encoded and "
"sent to the web server. The default implementation just returns ``record."
"__dict__``. This method can be overridden if e.g. only a subset of :class:"
"`~logging.LogRecord` is to be sent to the web server, or if more specific "
"customization of what's sent to the server is required."
msgstr ""

#: ../Doc/library/logging.handlers.rst:927
msgid ""
"Sends the record to the Web server as a URL-encoded dictionary. The :meth:"
"`mapLogRecord` method is used to convert the record to the dictionary to be "
"sent."
msgstr ""

#: ../Doc/library/logging.handlers.rst:931
msgid ""
"Since preparing a record for sending it to a Web server is not the same as a "
"generic formatting operation, using :meth:`~logging.Handler.setFormatter` to "
"specify a :class:`~logging.Formatter` for a :class:`HTTPHandler` has no "
"effect. Instead of calling :meth:`~logging.Handler.format`, this handler "
"calls :meth:`mapLogRecord` and then :func:`urllib.parse.urlencode` to encode "
"the dictionary in a form suitable for sending to a Web server."
msgstr ""

#: ../Doc/library/logging.handlers.rst:944
msgid "QueueHandler"
msgstr ""

#: ../Doc/library/logging.handlers.rst:948
msgid ""
"The :class:`QueueHandler` class, located in the :mod:`logging.handlers` "
"module, supports sending logging messages to a queue, such as those "
"implemented in the :mod:`queue` or :mod:`multiprocessing` modules."
msgstr ""

#: ../Doc/library/logging.handlers.rst:952
msgid ""
"Along with the :class:`QueueListener` class, :class:`QueueHandler` can be "
"used to let handlers do their work on a separate thread from the one which "
"does the logging. This is important in Web applications and also other "
"service applications where threads servicing clients need to respond as "
"quickly as possible, while any potentially slow operations (such as sending "
"an email via :class:`SMTPHandler`) are done on a separate thread."
msgstr ""

#: ../Doc/library/logging.handlers.rst:961
msgid ""
"Returns a new instance of the :class:`QueueHandler` class. The instance is "
"initialized with the queue to send messages to. The queue can be any queue-"
"like object; it's used as-is by the :meth:`enqueue` method, which needs to "
"know how to send messages to it."
msgstr ""

#: ../Doc/library/logging.handlers.rst:969
msgid "Enqueues the result of preparing the LogRecord."
msgstr ""

#: ../Doc/library/logging.handlers.rst:973
msgid ""
"Prepares a record for queuing. The object returned by this method is "
"enqueued."
msgstr ""

#: ../Doc/library/logging.handlers.rst:976
msgid ""
"The base implementation formats the record to merge the message, arguments, "
"and exception information, if present.  It also removes unpickleable items "
"from the record in-place."
msgstr ""

#: ../Doc/library/logging.handlers.rst:980
msgid ""
"You might want to override this method if you want to convert the record to "
"a dict or JSON string, or send a modified copy of the record while leaving "
"the original intact."
msgstr ""

#: ../Doc/library/logging.handlers.rst:986
msgid ""
"Enqueues the record on the queue using ``put_nowait()``; you may want to "
"override this if you want to use blocking behaviour, or a timeout, or a "
"customized queue implementation."
msgstr ""

#: ../Doc/library/logging.handlers.rst:995
msgid "QueueListener"
msgstr ""

#: ../Doc/library/logging.handlers.rst:999
msgid ""
"The :class:`QueueListener` class, located in the :mod:`logging.handlers` "
"module, supports receiving logging messages from a queue, such as those "
"implemented in the :mod:`queue` or :mod:`multiprocessing` modules. The "
"messages are received from a queue in an internal thread and passed, on the "
"same thread, to one or more handlers for processing. While :class:"
"`QueueListener` is not itself a handler, it is documented here because it "
"works hand-in-hand with :class:`QueueHandler`."
msgstr ""

#: ../Doc/library/logging.handlers.rst:1007
msgid ""
"Along with the :class:`QueueHandler` class, :class:`QueueListener` can be "
"used to let handlers do their work on a separate thread from the one which "
"does the logging. This is important in Web applications and also other "
"service applications where threads servicing clients need to respond as "
"quickly as possible, while any potentially slow operations (such as sending "
"an email via :class:`SMTPHandler`) are done on a separate thread."
msgstr ""

#: ../Doc/library/logging.handlers.rst:1016
msgid ""
"Returns a new instance of the :class:`QueueListener` class. The instance is "
"initialized with the queue to send messages to and a list of handlers which "
"will handle entries placed on the queue. The queue can be any queue-like "
"object; it's passed as-is to the :meth:`dequeue` method, which needs to know "
"how to get messages from it. If ``respect_handler_level`` is ``True``, a "
"handler's level is respected (compared with the level for the message) when "
"deciding whether to pass messages to that handler; otherwise, the behaviour "
"is as in previous Python versions - to always pass each message to each "
"handler."
msgstr ""

#: ../Doc/library/logging.handlers.rst:1026
msgid "The ``respect_handler_levels`` argument was added."
msgstr ""

#: ../Doc/library/logging.handlers.rst:1031
msgid "Dequeues a record and return it, optionally blocking."
msgstr ""

#: ../Doc/library/logging.handlers.rst:1033
msgid ""
"The base implementation uses ``get()``. You may want to override this method "
"if you want to use timeouts or work with custom queue implementations."
msgstr ""

#: ../Doc/library/logging.handlers.rst:1039
msgid "Prepare a record for handling."
msgstr ""

#: ../Doc/library/logging.handlers.rst:1041
msgid ""
"This implementation just returns the passed-in record. You may want to "
"override this method if you need to do any custom marshalling or "
"manipulation of the record before passing it to the handlers."
msgstr ""

#: ../Doc/library/logging.handlers.rst:1047
msgid "Handle a record."
msgstr ""

#: ../Doc/library/logging.handlers.rst:1049
msgid ""
"This just loops through the handlers offering them the record to handle. The "
"actual object passed to the handlers is that which is returned from :meth:"
"`prepare`."
msgstr ""

#: ../Doc/library/logging.handlers.rst:1055
msgid "Starts the listener."
msgstr ""

#: ../Doc/library/logging.handlers.rst:1057
msgid ""
"This starts up a background thread to monitor the queue for LogRecords to "
"process."
msgstr ""

#: ../Doc/library/logging.handlers.rst:1062
msgid "Stops the listener."
msgstr ""

#: ../Doc/library/logging.handlers.rst:1064
msgid ""
"This asks the thread to terminate, and then waits for it to do so. Note that "
"if you don't call this before your application exits, there may be some "
"records still left on the queue, which won't be processed."
msgstr ""

#: ../Doc/library/logging.handlers.rst:1070
msgid ""
"Writes a sentinel to the queue to tell the listener to quit. This "
"implementation uses ``put_nowait()``.  You may want to override this method "
"if you want to use timeouts or work with custom queue implementations."
msgstr ""

#: ../Doc/library/logging.handlers.rst:1081
msgid "Module :mod:`logging`"
msgstr ""

#: ../Doc/library/logging.handlers.rst:1081
msgid "API reference for the logging module."
msgstr ""

#: ../Doc/library/logging.handlers.rst:1083
msgid "Module :mod:`logging.config`"
msgstr ""

#: ../Doc/library/logging.handlers.rst:1084
msgid "Configuration API for the logging module."
msgstr ""
