软件开发规范及日志模块

项目名称
    bin                                  项目的启动文件目录
               ------  stat.py
    conf config                                     配置文件
      ------settings.py 可能会发生改变的配置信息
    core  核心代码
        -------user.py
      --------auth.py
      --------main.py
     lib                                       反复调用的代码库
     db database        数据库 可以引用的所有数据 
     log                                             指定日志目录

=============================================================================
日志模块

 1 import logging
 2 logging.basicConfig(level=logging.DEBUG,     #把记录级别从warning减低到debug
 3                     format='%(asctime)s %(filename)s[line:%(lineno)d] 
%(lecelname)s %(message)s
' #记录内容格式化 4 detefmt='%a,%d %b %Y %H:%M:%S', #指定的日期时间格式 5 filename='/tmp/test.log', #指定文件名 6 filemode='w') #指定读写方式 7 logging.debug('调试信息') 8 logging.ingo('普通信息') 9 logging.warning('警告信息') 10 logging.error('错误信息') 11 logging.critical('严重信息')

配置参数

logging.basicConfig()函数中可通过具体参数来更改logging模块默认行为,可用参数有:

filename:用指定的文件名创建FiledHandler,这样日志会被存储在指定的文件中。
filemode:文件打开方式,在指定了filename时使用这个参数,默认值为“a”还可指定为“w”。
format:指定handler使用的日志显示格式。
datefmt:指定日期时间格式。
level:设置rootlogger(后边会讲解具体概念)的日志级别
stream:用指定的stream创建StreamHandler。可以指定输出到sys.stderr,sys.stdout或者文件(f=open(‘test.log’,’w’)),默认为sys.stderr。若同时列出了filename和stream两个参数,则stream参数会被忽略。

format参数中可能用到的格式化串:
%(name)s Logger的名字
%(levelno)s 数字形式的日志级别
%(levelname)s 文本形式的日志级别
%(pathname)s 调用日志输出函数的模块的完整路径名,可能没有
%(filename)s 调用日志输出函数的模块的文件名
%(module)s 调用日志输出函数的模块名
%(funcName)s 调用日志输出函数的函数名
%(lineno)d 调用日志输出函数的语句所在的代码行
%(created)f 当前时间,用UNIX标准的表示时间的浮 点数表示
%(relativeCreated)d 输出日志信息时的,自Logger创建以 来的毫秒数
%(asctime)s 字符串形式的当前时间。默认格式是 “2003-07-08 16:49:45,896”。逗号后面的是毫秒
%(thread)d 线程ID。可能没有
%(threadName)s 线程名。可能没有
%(process)d 进程ID。可能没有
%(message)s用户输出的消息

但是logging模块不能同时输出文件和属性,同时日志中不支持中文
第二种日志方式

用logger对象的方式来写日志

import logging
logger=logging.getLogger() #先创建logger对象
logger.setLevel(logging.DEBUG) #升级记录模式
fh=logging.FileHandler('log',encoding='utf-8') #创建文件操作符(指定名字模式)
sh=logging.StreamHandler() #创建屏幕操作符
fmt=logging.Formatter('%(asctime)s-%(name)s -%(levelname)s-%(message)s')
#创建一个记录格式
logger.addHandler(fh) #logger绑定文件操作符
logger.addHandler(sh) #绑定屏幕操作符
fh.setFormatter(fmt) #文件操作符绑定格式
sh.setFormatter(fmt) #屏幕操作符绑定格式
#logger对象可以添加多个fh和ch对象
logger.debug('调试信息')
logger.info('普通信息')
logger.warning('警告信息')
logger.error('错误信息')
logger.critical('严重信息')

logging库提供了多个组件:Logger、Handler、Filter、Formatter。Logger对象提供应用程序可直接使用的接口,Handler发送日志到适当的目的地,Filter提供了过滤日志信息的方法,Formatter指定日志显示格式。另外,可以通过:logger.setLevel(logging.Debug)设置级别,当然,也可以通过

fh.setLevel(logging.Debug)单对文件流设置某个级别。

 1 # ==================================================================================
 2 # 简单版本 不支持中文
 3 
 4 # import logging
 5 #
 6 # logging.basicConfig(filename='wf000.log',
 7 #         format='%(asctime)s - %(name)s - %(levelname)s - %(module)s: %(message)s',
 8 #         datefmt='%Y-%m-%d %H:%M:%S %p',
 9 #         level=logging.ERROR
10 # )
11 # logging.error('日志记录信息')
 1 # ↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓推荐使用↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓
 2 
 3 #简单模式改良版,加入设置文件操作符FileHandler,支持中文,生成一个log文件------推荐使用
 4 
 5 # import logging
 6 #
 7 # file_handler = logging.FileHandler(filename='x1.log',
 8 #                                    mode='a',
 9 #                                    encoding='utf-8',)
10 # logging.basicConfig(
11 #     format='%(asctime)s -%(name)s -%(levelname)s -%(module)s: %(message)s',
12 #     datefmt='%Y-%m-%d %H:%M:%S %p',
13 #     handlers=[file_handler,],
14 #     level=logging.ERROR
15 # )
16 # try:
17 #     int('a')
18 # except Exception as e:
19 #     msg=str(e)  #调用e.__str__方法
20 #     print(msg)
21 #     logging.error(msg,exc_info=True)
22 
23 #当日志记录异常处理信息时,保留异常的堆栈信息
# ================推荐处理的日志模式===添加===随时间的日志分割=====================


# import time
# import logging
# from logging import handlers
# file_handler = handlers.TimedRotatingFileHandler(filename='rz.log',
#                     when='s',interval=5,encoding='utf-8')
#             #间隔时间可以按参数修改
# logging.basicConfig(
#     format='%(asctime)s -%(name)s -%(levelname)s -%(module)s -%(message)s',
#     datefmt='%Y-%m-%d %H:%M:%S %p',
#     handlers=[file_handler,],
#     level=logging.ERROR
# )
# for i in range(1,100000):
#     time.sleep(1)
#     logging.error(str(i))


# ===============================================================================
原文地址:https://www.cnblogs.com/OB19227/p/10656451.html