]> granicus.if.org Git - python/commitdiff
Add some text
authorAndrew M. Kuchling <amk@amk.ca>
Wed, 14 Apr 2010 14:28:31 +0000 (14:28 +0000)
committerAndrew M. Kuchling <amk@amk.ca>
Wed, 14 Apr 2010 14:28:31 +0000 (14:28 +0000)
Doc/whatsnew/2.7.rst

index 0ddeff4e1bb5d46414dff85a748e55b1dc48c963..8f02d1c723ee3fafb16c44b851fcbdd5860cefe1 100644 (file)
@@ -331,7 +331,28 @@ standard input or output.
 PEP 391: Dictionary-Based Configuration For Logging
 ====================================================
 
-XXX write this section.
+.. not documented in library reference yet.
+
+The :mod:`logging` module is very flexible; an application can define
+a tree of logging subsystems, and each logger in this tree can filter
+out certain messages, format them differently, and direct messages to
+a varying number of handlers.
+
+All this flexibility can require a lot of configuration.  You can
+write Python statements to create objects and set their properties,
+but a complex set-up would require verbose but boring code.
+:mod:`logging` also supports a :func:`~logging.config.fileConfig`
+function that parses a file, but the file format doesn't support
+configuring filters, and it's messier to generate programmatically.
+
+Python 2.7 adds a :func:`~logging.config.dictConfig` function that
+uses a dictionary, and there are many ways to produce a dictionary
+from different sources.  You can construct one with code, of course.
+Python's standard library now includes a JSON parser, so you could
+parse a file containing JSON, or you could use a YAML parsing library
+if one is installed.
+
+XXX describe an example.
 
 Two smaller enhancements to the logging module are: