debugging.rst
33 lines
| 1.2 KiB
| text/x-rst
|
RstLexer
r2119 | .. _debugging: | |||
=================== | ||||
Bradley M. Kuhn
|
r4192 | Debugging Kallithea | ||
r2119 | =================== | |||
Michael V. DePalatis
|
r4955 | If you encounter problems with Kallithea, here are some instructions | ||
on how to debug them. | ||||
r2119 | ||||
Michael V. DePalatis
|
r4955 | .. note:: First make sure you're using the latest version available. | ||
r2119 | ||||
Mads Kiilerich
|
r5433 | |||
Mads Kiilerich
|
r4902 | Enable detailed debug | ||
r2119 | --------------------- | |||
Michael V. DePalatis
|
r4955 | Kallithea uses the standard Python ``logging`` module to log its output. | ||
By default only loggers with ``INFO`` level are displayed. To enable full output | ||||
change ``level = DEBUG`` for all logging handlers in the currently used .ini file. | ||||
This change will allow you to see much more detailed output in the log file or | ||||
r2125 | console. This generally helps a lot to track issues. | |||
r2119 | ||||
Mads Kiilerich
|
r4902 | Enable interactive debug mode | ||
r2119 | ----------------------------- | |||
Michael V. DePalatis
|
r4955 | To enable interactive debug mode simply comment out ``set debug = false`` in | ||
the .ini file. This will trigger an interactive debugger each time | ||||
timeless@gmail.com
|
r5817 | there is an error in the browser, or send a http link if an error occurred in the backend. This | ||
Michael V. DePalatis
|
r4955 | is a great tool for fast debugging as you get a handy Python console right | ||
in the web view. | ||||
.. warning:: NEVER ENABLE THIS ON PRODUCTION! The interactive console | ||||
can be a serious security threat to your system. | ||||