.. _troubleshooting:

=================
 Troubleshooting
=================

.. seealso::

   :ref:`support`
     If this page doesn't help.

.. _troubleshooting-no-handler-for-logger:

A Message about no Handlers being found appears
===============================================

Problem *(applies to Python)*

  When I import the :py:mod:`rst` or :py:mod:`rstsandbox` module, a
  message like::

    No handlers could be found for logger "rstsandbox"

  appears. Am I doing something wrong?

Solution

  Everything is fine. The output is produced by Python's
  :py:mod:`logging` module when logging has not been
  configured. |project| uses this module to log messages.

  If you find these messages annoying, add the following code fragment
  to your program:

  .. code-block:: python

     import logging
     logging.basicConfig(level = logging.WARNING)

  See :py:func:`logging.basicConfig` for more configuration options.