Telethon/readthedocs/extra/troubleshooting/enable-logging.rst

================
Enabling Logging
================

Telethon makes use of the `logging`__ module, and you can enable it as follows:

.. code:: python

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

The library has the `NullHandler`__ added by default so that no log calls
will be printed unless you explicitly enable it.

You can also `use the module`__ on your own project very easily:

.. code-block:: python

    import logging
    logger = logging.getLogger(__name__)

    logger.debug('Debug messages')
    logger.info('Useful information')
    logger.warning('This is a warning!')


If you want to enable ``logging`` for your project *but* use a different
log level for the library:

.. code-block:: python

    import logging
    logging.basicConfig(level=logging.DEBUG)
    # For instance, show only warnings and above
    logging.getLogger('telethon').setLevel(level=logging.WARNING)


__ https://docs.python.org/3/library/logging.html
__ https://docs.python.org/3/howto/logging.html#configuring-logging-for-a-library
__ https://docs.python.org/3/howto/logging.html