Handlers
--------

QueueListenerHandler
++++++++++++++++++++

A simple ``QueueHandler`` subclass implementation utilizing ``QueueListener`` for configured handlers. This is helpful for detaching the logger handlers from the main threads, which reduces the risk of getting blocked, for example, when using slower handlers such as smtp, file, or socket handlers.

Example Usage
*************

An example YAML configuration file utilizing ``QueueListenerHandler``

.. literalinclude:: snippets/queue_listener_handler/logging.yaml
   :caption: logging.yaml
   :language: yaml
   :emphasize-lines: 2-5, 18-23, 27-28

Just load the configuration file and start logging.

.. literalinclude:: snippets/queue_listener_handler/test_logger.py
   :caption: test_logger.py
   :language: python

Optional Params
***************

A queue object must be passed since the handler does not set a default queue implementation. Set ``maxsize: -1`` to make the queue unlimited.

Module Members
++++++++++++++

.. automodule:: logging_.handlers.queue_listener_handler
   :members:
   :special-members:
   :show-inheritance:
   :exclude-members: emit