Logging模块的简单使用

以前看过，但一直认为很复杂。象 NewEdit 都是自已写的日志处理。其实 logging 做得很好，也不是很复杂，只要看明白例子。在新发布的crawl 2.1.1中使用了logging，下面把它的使用代码写出来，很简单：

1       def initlog():
2           import logging
3          
4           logger = logging.getLogger()
5           hdlr = logging.FileHandler(logfile)
6           formatter = logging.Formatter('%(asctime)s %(levelname)s %(message)s')
7           hdlr.setFormatter(formatter)
8           logger.addHandler(hdlr)
9           logger.setLevel(logging.NOTSET)
10         
11          return logger

这个函数用来返回一个日志对象。

第4行生成一个日志对象，可以带一个名字，可以缺省。
第5行生成一个Handler。logging支持许多Handler，象FileHandler, SocketHandler, SMTPHandler等，我由于要写文件就使用了FileHandler。logfile是一个全局变量，它就是一个文件名，如：'crawl.log'。
第6行生成一个格式器，用于规范日志的输出格式。如果没有这行代码，那么缺省的格式就是："%(message)s"。也就是写日志时，信息是什么日志中就是什么，没有日期，没有信息级别等信息。logging支持许多种替换值，详细请看Formatter的文档说明。这里有三项：时间，信息级别，日志信息。
第7行将格式器设置到处理器上。
第8行将处理器加到日志对象上。
第9行设置日志信息输出的级别。logging提供多种级别的日志信息，如：NOTSET, DEBUG, INFO, WARNING, ERROR, CRITICAL等。每个级别都对应一个数值。如果不执行此句，缺省为30(WARNING)。可以执行：logging.getLevelName(logger.getEffectiveLevel())来查看缺省的日志级别。日志对象对于不同的级别信息提供不同的函数进行输出，如：info(), error(), debug()等。当写入日志时，小于指定级别的信息将被忽略。因此为了输出想要的日志级别一定要设置好此参数。这里我设为NOTSET（值为0），也就是想输出所有信息。

有了日志对象，输出就非常简单了：

logger.error(message)
logger.info(message)