From 0c1551ae85940d9f75a79865356da02a72abad7b Mon Sep 17 00:00:00 2001 From: Tanya Schlusser Date: Sat, 17 Jan 2015 21:09:52 -0600 Subject: [PATCH] Added pro / con bullets to the list of ways to configure a logger --- docs/writing/logging.rst | 17 ++++++++++++++--- 1 file changed, 14 insertions(+), 3 deletions(-) diff --git a/docs/writing/logging.rst b/docs/writing/logging.rst index 7faa553..0cee15d 100644 --- a/docs/writing/logging.rst +++ b/docs/writing/logging.rst @@ -82,9 +82,20 @@ application environment. There are at least three ways to configure a logger: -- using a file -- using a dictionary -- using code +- Using an INI-formatted file: + - *Pro* -- possible to update configuration while running + using the function :func:`logging.config.listen` to listen + on a socket. + - *Con* -- less control (*e.g.* custom subclassed filters or loggers) + than possible when configuring a logger in code. +- Using a dictionary or a JSON-formatted file: + - *Pro* -- in addition to updating while running, it is possible to + load from a file using the :mod:`json` module, in the standard + library since Python 2.6. + - *Con* -- less control than when configuring a logger in code. +- Using code: + - *Pro* -- complete control over the configuration. + - *Con* -- modifications require a change to source code. Example Configuration via an INI File