[stdlib-sig] logging

[Doug Hellmann]

On Sep 18, 2009, at 9:57 AM, Jesse Noller wrote:

> Part of the newb-to-not-newb transition would be helped by possibly
> simplifying the docs (something I am *still* working on for
> multiprocessing) - the examples can be like drinking from a fire hose.
> Doug Hellmann - the author of the Python Module of the Week is an
> *excellent* doc writer (see his logging write up here:
> http://www.doughellmann.com/PyMOTW/logging/index.html#module-logging)
> and might be willing to help, give pointers, what have you.

We use the logging module extensively at work and have found the  
shared state (even in a multi-threaded/multi-process situation) *much*  
nicer than passing around log handles.  In fact, we recently  
overhauled several process that, for legacy reasons, had been using  
log handles and now the code is simpler and the logs are easier to  
follow.

As far as code verbosity goes, we've found the "secret" to be using a  
configuration file.  That makes it easy to set up default logging and  
if our integrators want to tie in to their "enterprise" logging  
facility they can simply reconfigure it.  We don't have to build  
custom hooks for them because they're already included.  We *love*  
writing less code!

Vinay, contact me off list if you want to talk about documentation.  
I'd be happy to help in any way I can.

Doug