Ticket #14861: logging-imports.diff

docs/topics/logging.txt

@@ -349 +349 @@
           printed to the console; ``ERROR`` and ``CRITICAL``
           messages will also be output via e-mail.
 
+.. note::
+    If your ``settings.py`` specifies a custom handler class, and the file
+    defining that class also imports ``settings.py``, a circular import will
+    occur.
+
+    So for example if ``settings.py`` contains the following config for
+    ``LOGGING``::
+
+        LOGGING = {
+          'version': 1,
+          'handlers': {
+            'custom_handler': {
+              'level': 'INFO',
+              'class': 'myproject.logconfig.MyHandler',
+            }
+          }
+        }
+
+    and ``myproject/logconfig.py`` has the following line before the
+    ``MyHandler`` definition::
+
+        from django.conf import settings
+
+    The dictconfig module spits out an exception like::
+
+        ValueError: Unable to configure handler 'custom_handler':
+        Unable to configure handler 'custom_handler':
+        'module' object has no attribute 'logconfig'
+
 .. _formatter documentation: http://docs.python.org/library/logging.html#formatter-objects
 
 Custom logging configuration