彩色日志 10.0.1

安装

colouredlogs 包可在 PyPI 上找到，这意味着安装应该像这样简单

$ pip install colouredlogs

实际上有无数种安装 Python 包的方法（例如，用户 site-packages 目录、虚拟环境或仅全局安装），我无意在这里讨论这些，所以如果您感到害怕，请在返回这些说明之前阅读有关选项的信息 ;-)

使用方法

以下是开始使用的一个例子

import colouredlogs, logging

# Create a logger object.
logger = logging.getLogger(__name__)

# By default the install() function installs a handler on the root logger,
# this means that log messages from your code and log messages from the
# libraries that you use will all show up on the terminal.
colouredlogs.install(level='DEBUG')

# If you don't want to see log messages from libraries, you can pass a
# specific logger object to the install() function. In this case only log
# messages originating from that logger will show up on the terminal.
colouredlogs.install(level='DEBUG', logger=logger)

# Some examples.
logger.debug("this is a debugging message")
logger.info("this is an informational message")
logger.warning("this is a warning message")
logger.error("this is an error message")
logger.critical("this is a critical message")

日志消息的格式

ColouredFormatter 类支持用户定义的日志格式，因此您可以使用您喜欢的任何日志格式。默认的日志格式如下

%(asctime)s %(hostname)s %(name)s[%(process)d] %(levelname)s %(message)s

此日志格式将产生以下输出

2015-10-23 03:32:22 peter-macbook colouredlogs.demo[30462] DEBUG message with level 'debug'
2015-10-23 03:32:23 peter-macbook colouredlogs.demo[30462] VERBOSE message with level 'verbose'
2015-10-23 03:32:24 peter-macbook colouredlogs.demo[30462] INFO message with level 'info'
...

您可以使用环境变量以及编程方式来自定义日志格式和样式，有关详细信息，请参阅 在线文档。

更改文本样式和颜色

在线文档中包含了一个自定义文本样式和颜色的示例。

cron 中的彩色输出

当在cron任务中使用colouredlogs时，cron发送给你的电子邮件输出不会包含任何ANSI转义序列，因为colouredlogs意识到它并未连接到交互式终端。如果你想通过cron发送带有颜色的电子邮件，有两种方法可以实现

MAILTO="your-email-address@here"
CONTENT_TYPE="text/html"
* * * * * root colouredlogs --to-html your-command

联系方式

colouredlogs的最新版本可在PyPI和GitHub上找到。在线文档可在Read The Docs上查看，包括变更日志。对于错误报告，请在GitHub上创建一个问题。如果您有任何问题、建议等，请随时通过peter@peterodding.com给我发电子邮件。

许可

本软件受MIT许可协议约束。

© 2018 Peter Odding。