prolog 0.3.1

basic_config

开始使用 prolog 的最简单方法是将其添加到您的应用程序代码中

import prolog
prolog.basic_config()

这将配置默认级别 logging.INFO 的 root logger，并设置两个处理器：一个彩色控制台流处理器，以及一个设置为记录到主应用程序目录中默认文件 pypro.log 的文件处理器。

要指定应用程序或库代码中定义的选定logger，请传递所需logger的逗号分隔名称

prolog.basic_config('myapp,another_app')

basic_config 接受以下参数

loggers

要配置的所需logger；可以是logger名称的逗号分隔字符串、Logger实例的列表，或为root logger传递 None。

level

指定所有logger和handler的日志级别。可以是所需级别的数字值或字符串名称。

handlers

要将处理程序添加到指定的 loggers 中；可以是一个以逗号分隔的快捷名称字符串（默认为“stream”或“file”）或 Handler 实例的列表。

propagate

表示是否将每个 logger 实例设置为可传播。

reset_handlers

如果为 True，则强制重置所有当前配置的处理程序。

cfg

要使用的 prolog.config.PrologConfig 实例。如果没有提供，则使用默认值（prolog.config.config）。对于所有先前的参数，除了设置为 None（默认值）的 loggers，将使用 cfg 来确定适当的设置。

示例

安装后，可以使用 prolog 演示配置设置或示例用法。

$ python -m prolog sample --level=DEBUG basic

通过环境变量设置颜色

$ export PYPROLOG_LEVEL_COLORS='CRITICAL:white,red;ERROR:lightred;DEBUG:lightgray,cyan;*:gray,gray'
$ python -m prolog sample --level=DEBUG basic

默认值

LEVEL = 'INFO'
SHORT_FMT = "{levelname}:{name} {message}"
LONG_FMT = '[{asctime} {name}:{levelname}:{module}:{lineno}] {message}'

COLOR_LONG_FMT = '{color}[{asctime} {name}:{levelname}:{module}:{lineno}]{endcolor} {message}'
COLOR_SHORT_FMT = '{color}{levelname}:{name}{endcolor} {message}'
LEVEL_COLORS = 'DEBUG:magenta;INFO:blue;WARNING:yellow;ERROR:red;CRITICAL:white,red'

DATE_FMT = "%Y-%m-%dT%H:%M:%S"
STYLE_FMT = '{'

HANDLERS = 'stream,file'
PROPAGATE = False
DISABLE_EXISTING = True
RESET_HANDLERS = True

STREAM_LEVEL = 'NOTSET'
STREAM_FORMATTER = 'color'
STREAM_STREAM = 'sys.stderr'

FILE_LEVEL = 'NOTSET'
FILE_FORMATTER = 'long'
FILE_FILENAME = 'pypro.log'
FILE_MAX_BYTES = 0
FILE_BACKUP_COUNT = 0

环境

默认情况下，prolog.config.config 实例将加载任何以 PYPROLOG_ 开头并以以下列出的任何默认值结尾的环境变量。例如，要覆盖默认的日志级别，在执行应用程序代码之前执行以下操作

$ export PYPROLOG_LEVEL='DEBUG'
$ python myapp.py