Mercurial > kallithea
annotate docs/usage/debugging.rst @ 4998:177ccc998b04
tests: Remove imported_from_test function
AFAICT, this function is not used:
$ ag imported_from_test
kallithea/tests/nose_parametrized.py
144:def imported_from_test():
author | Marc Abramowitz <marc@marc-abramowitz.com> |
---|---|
date | Wed, 08 Apr 2015 13:48:30 -0700 |
parents | 4e6dfdb3fa01 |
children | fbbe80e3322b |
rev | line source |
---|---|
2119
4d076981a7b1
docs about debugging
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
1 .. _debugging: |
4d076981a7b1
docs about debugging
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
2 |
4d076981a7b1
docs about debugging
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
3 =================== |
4192
e73a69cb98dc
Rename some strings examples and commands in documentation
Bradley M. Kuhn <bkuhn@sfconservancy.org>
parents:
3224
diff
changeset
|
4 Debugging Kallithea |
2119
4d076981a7b1
docs about debugging
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
5 =================== |
4d076981a7b1
docs about debugging
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
6 |
4955
4e6dfdb3fa01
docs: English and consistency corrections
Michael V. DePalatis <mike@depalatis.net>
parents:
4902
diff
changeset
|
7 If you encounter problems with Kallithea, here are some instructions |
4e6dfdb3fa01
docs: English and consistency corrections
Michael V. DePalatis <mike@depalatis.net>
parents:
4902
diff
changeset
|
8 on how to debug them. |
2119
4d076981a7b1
docs about debugging
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
9 |
4955
4e6dfdb3fa01
docs: English and consistency corrections
Michael V. DePalatis <mike@depalatis.net>
parents:
4902
diff
changeset
|
10 .. note:: First make sure you're using the latest version available. |
2119
4d076981a7b1
docs about debugging
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
11 |
4902 | 12 Enable detailed debug |
2119
4d076981a7b1
docs about debugging
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
13 --------------------- |
4d076981a7b1
docs about debugging
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
14 |
4955
4e6dfdb3fa01
docs: English and consistency corrections
Michael V. DePalatis <mike@depalatis.net>
parents:
4902
diff
changeset
|
15 Kallithea uses the standard Python ``logging`` module to log its output. |
4e6dfdb3fa01
docs: English and consistency corrections
Michael V. DePalatis <mike@depalatis.net>
parents:
4902
diff
changeset
|
16 By default only loggers with ``INFO`` level are displayed. To enable full output |
4e6dfdb3fa01
docs: English and consistency corrections
Michael V. DePalatis <mike@depalatis.net>
parents:
4902
diff
changeset
|
17 change ``level = DEBUG`` for all logging handlers in the currently used .ini file. |
4e6dfdb3fa01
docs: English and consistency corrections
Michael V. DePalatis <mike@depalatis.net>
parents:
4902
diff
changeset
|
18 This change will allow you to see much more detailed output in the log file or |
2125
097327aaf2ad
more detailed logging on auth system
Marcin Kuzminski <marcin@python-works.com>
parents:
2119
diff
changeset
|
19 console. This generally helps a lot to track issues. |
2119
4d076981a7b1
docs about debugging
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
20 |
4d076981a7b1
docs about debugging
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
21 |
4902 | 22 Enable interactive debug mode |
2119
4d076981a7b1
docs about debugging
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
23 ----------------------------- |
4d076981a7b1
docs about debugging
Marcin Kuzminski <marcin@python-works.com>
parents:
diff
changeset
|
24 |
4955
4e6dfdb3fa01
docs: English and consistency corrections
Michael V. DePalatis <mike@depalatis.net>
parents:
4902
diff
changeset
|
25 To enable interactive debug mode simply comment out ``set debug = false`` in |
4e6dfdb3fa01
docs: English and consistency corrections
Michael V. DePalatis <mike@depalatis.net>
parents:
4902
diff
changeset
|
26 the .ini file. This will trigger an interactive debugger each time |
4e6dfdb3fa01
docs: English and consistency corrections
Michael V. DePalatis <mike@depalatis.net>
parents:
4902
diff
changeset
|
27 there is an error in the browser, or send a http link if an error occured in the backend. This |
4e6dfdb3fa01
docs: English and consistency corrections
Michael V. DePalatis <mike@depalatis.net>
parents:
4902
diff
changeset
|
28 is a great tool for fast debugging as you get a handy Python console right |
4e6dfdb3fa01
docs: English and consistency corrections
Michael V. DePalatis <mike@depalatis.net>
parents:
4902
diff
changeset
|
29 in the web view. |
4e6dfdb3fa01
docs: English and consistency corrections
Michael V. DePalatis <mike@depalatis.net>
parents:
4902
diff
changeset
|
30 |
4e6dfdb3fa01
docs: English and consistency corrections
Michael V. DePalatis <mike@depalatis.net>
parents:
4902
diff
changeset
|
31 .. warning:: NEVER ENABLE THIS ON PRODUCTION! The interactive console |
4e6dfdb3fa01
docs: English and consistency corrections
Michael V. DePalatis <mike@depalatis.net>
parents:
4902
diff
changeset
|
32 can be a serious security threat to your system. |