Andersen

一个Python的日志库的封装

使用方式

安装

pip install andersen

代码使用

直接使用

import andersen


andersen.debug('debug')
andersen.info('info')
andersen.warn('warn')
andersen.error('error')

系统自带了一个输出到控制台的handler，日志级别为info，因此上边的代码会输出：

自定义配置

可以自己指定配置的文件，有两种指定方式：环境变量和函数指定

指定环境变量

import os
os.environ.setdefault('ANDERSEN_CONFIG', 'log_config.toml')
# 必须在导入前设置环境变量
import andersen
andersen.debug('debug')
andersen.info('info')
andersen.warn('warn')
andersen.error('error')

函数加载

import andersen
andersen.init('log_config.toml')

andersen.debug('debug')
andersen.info('info')
andersen.warn('warn')
andersen.error('error')

目前只支持toml的自定义配置文件，示例文件如下

[log.common]
    # 可选参数
    name = "common"

    # 必要参数
    level = "info"

    # 可选参数，这里如果配置的话则handler处没有配置的话会到这里查找。如果都找不到则会抛出异常
    format = "[%(asctime)s] [%(levelname)s] %(message)s"

# 输出到控制台的配置
[[log.common.handlers]]
    type = "std"
    # 可选参数
    format = "%(asctime)s %(levelname)s %(message)s"
    level = "info"

# 输出到文件的配置
[[log.common.handlers]]
    type = "file"
    # 可选参数
    format = "%(asctime)s %(levelname)s %(message)s"
    level = "info"

    # 必要参数
    log_file = "log/common.log"

# 输出到按大小迭代的文件的配置
[[log.common.handlers]]
    type = "rotate"
    # 可选参数
    format = "%(asctime)s %(levelname)s %(message)s"
    level = "info"

    # 必要参数
    log_file = "log/common1.log"
    max_bytes = 1024

# 输出到按时间迭代的文件的配置
[[log.common.handlers]]
    type = "time_rotate"
    # 可选参数
    format = "%(asctime)s %(levelname)s %(message)s"
    level = "info"

    # 必要参数
    log_file = "log/common2.log"
    when = 'h'

# 如果需要配置另一个，修改log后边的key名称即可，然后需要配置哪些类型的handler，从上边复制后修改即可
[log.sample]
    name = "sample"
    level = "debug"
    format = "[%(asctime)s] [%(levelname)s] %(message)s"

# 输出到控制台的配置
[[log.sample.handlers]]
    type = "std"
    # 可选参数
    format = "%(asctime)s %(levelname)s %(message)s"
    level = "debug"

相关函数

日志配置

init(conf=None, default_logger='common')

初始化函数。可重复调用，只会实际执行一次。

• conf 如果为None则从环境变量读取配置文件，如果不存在则使用默认配置，即创建一个输出到控制台的日志对象
• default_logger 初始化后默认使用的日志对象

generate_sample_config(filename)

将示例配置写入一个toml文件。写入内容见上文

• filename 目标文件

get_logger(key='common')

获取日志对象。key必须在配置文件里已经定义。返回的是一个python的logging.Logger对象

• key 日志的key值，即配置中log后边所跟的参数，默认是common

日志输出

debug(*args, **kwargs)

输出调试信息。kwargs中可选参数

• logger 要使用哪个日志输出信息，未指定的话使用默认日志输出
• sep 默认分隔符，如果指定该参数那么下边三个参数的默认值是该值
• list_sep 列表分隔符，即使用该参数连接参数args
• para_sep 参数分隔符，即使用该参数连接args和kwargs生成的字符串
• dict_sep 字典分隔符，即使用该参数连接参数kwargs

info(*args, **kwargs)

输出信息。kwargs中可选参数

• logger 要使用哪个日志输出信息，未指定的话使用默认日志输出
• sep 默认分隔符，如果指定该参数那么下边三个参数的默认值是该值
• list_sep 列表分隔符，即使用该参数连接参数args
• para_sep 参数分隔符，即使用该参数连接args和kwargs生成的字符串
• dict_sep 字典分隔符，即使用该参数连接参数kwargs

warn(*args, **kwargs)

输出警告信息。kwargs中可选参数

• logger 要使用哪个日志输出信息，未指定的话使用默认日志输出
• sep 默认分隔符，如果指定该参数那么下边三个参数的默认值是该值
• list_sep 列表分隔符，即使用该参数连接参数args
• para_sep 参数分隔符，即使用该参数连接args和kwargs生成的字符串
• dict_sep 字典分隔符，即使用该参数连接参数kwargs

error(*args, **kwargs)

输出错误信息。kwargs中可选参数

• logger 要使用哪个日志输出信息，未指定的话使用默认日志输出
• sep 默认分隔符，如果指定该参数那么下边三个参数的默认值是该值
• list_sep 列表分隔符，即使用该参数连接参数args
• para_sep 参数分隔符，即使用该参数连接args和kwargs生成的字符串
• dict_sep 字典分隔符，即使用该参数连接参数kwargs