日志模块python loguru

小鹏的色彩

日志模块python loguru

下载

1. pip install loguru

复制代码

开箱即用

Loguru 的主要概念是只有一个：logger

1. from loguru import logger
3. logger.info("This is log info!")
4. logger.warning("This is log warn!")
5. logger.error("This is log error!")
6. logger.debug("This is log debug!")

复制代码

可以看到不需要手动设置，Loguru 会提前配置一些基础信息，自动输出时间、日志级别、模块名、行号等信息，而且根据等级的不同，还自动设置了不同的颜色，方便观察，真正做到了开箱即用！
如果想自定义日志级别，自定义日志格式，保存日志到文件该怎么办？

与 logging 模块不同，不需要 Handler，不需要 Formatter，只需要一个 add() 函数就可以了，

1. from loguru import logger
3. logger.add('test.log')
4. logger.debug('this is a debug')

复制代码

我们不需要像 logging 模块一样再声明一个 FileHandler 了，就一行 add() 语句搞定，运行之后会发现目录下 test.log 里面同样出现了刚刚控制台输出的 debug 信息。
与 add() 语句相反，remove() 语句可以删除我们添加的配置：

1. from loguru import logger
3. log_file = logger.add('test.log')
4. logger.debug('This is log debug!')
5. logger.remove(log_file)
6. logger.debug('This is another log debug!')

复制代码

完整参数

Loguru 对输出到文件的配置有非常强大的支持，比如支持输出到多个文件，分级别分别输出，过大创建新文件，过久自动删除等等。 下面我们来详细看一下 add() 语句的详细参数：
基本语法：

1. add(sink, *, level='DEBUG', format='<green>{time:YYYY-MM-DD HH:mm:ss.SSS}</green> | <level>{level: <8}</level> | <cyan>{name}</cyan>:<cyan>{function}</cyan>:<cyan>{line}</cyan> - <level>{message}</level>', filter=None, colorize=None, serialize=False, backtrace=True, diagnose=True, enqueue=False, catch=True, **kwargs)

复制代码

在控制台的输出是这样的：

相关文献

1. sink：可以是一个 file 对象，例如 sys.stderr 或 open('file.log', 'w')，也可以是 str 字符串或者 pathlib.Path 对象，即文件路径，也可以是一个方法，可以自行定义输出实现，也可以是一个 logging 模块的 Handler，比如 FileHandler、StreamHandler 等，还可以是 coroutine function，即一个返回协程对象的函数等。
2. level：日志输出和保存级别。
3. format：日志格式模板。
4. filter：一个可选的指令，用于决定每个记录的消息是否应该发送到 sink。
5. colorize：格式化消息中包含的颜色标记是否应转换为用于终端着色的 ansi 代码，或以其他方式剥离。 如果没有，则根据 sink 是否为 tty（电传打字机缩写） 自动做出选择。
6. serialize：在发送到 sink 之前，是否应首先将记录的消息转换为 JSON 字符串。
7. backtrace：格式化的异常跟踪是否应该向上扩展，超出捕获点，以显示生成错误的完整堆栈跟踪。
8. diagnose：异常跟踪是否应显示变量值以简化调试。建议在生产环境中设置 False，避免泄露敏感数据。
9. enqueue：要记录的消息是否应在到达 sink 之前首先通过多进程安全队列，这在通过多个进程记录到文件时很有用，这样做的好处还在于使日志记录调用是非阻塞的。
10. catch：是否应自动捕获 sink 处理日志消息时发生的错误，如果为 True，则会在 sys.stderr 上显示异常消息，但该异常不会传播到 sink，从而防止应用程序崩溃。
11. \kwargs：仅对配置协程或文件接收器有效的附加参数（见下文）。
12. 当且仅当 sink 是协程函数时，以下参数适用：
14. loop：将在其中调度和执行异步日志记录任务的事件循环。如果为 None，将使用 asyncio.get_event_loop() 返回的循环。
15. 当且仅当 sink 是文件路径时，以下参数适用：
17. rotation：一种条件，指示何时应关闭当前记录的文件并开始新的文件。
19. *retention *：过滤旧文件的指令，在循环或程序结束期间会删除旧文件。
21. compression：日志文件在关闭时应转换为的压缩或存档格式。
23. delay：是在配置 sink 后立即创建文件，还是延迟到第一条记录的消息时再创建。默认为 False。
25. mode：内置 open() 函数的打开模式，默认为 a（以追加模式打开文件）。
26. buffering：内置 open() 函数的缓冲策略，默认为1（行缓冲文件）。
27. encoding：内置 open() 函数的文件编码，如果 None，则默认为 locale.getpreferredencoding()。
28. \kwargs：其他传递给内置 open() 函数的参数。
29. 这么多参数可以见识到 add() 函数的强大之处，仅仅一个函数就能实

复制代码

来源:https://www.cnblogs.com/zhangfanshixiaobai/p/17873410.html
免责声明：由于采集信息均来自互联网，如果侵犯了您的权益，请联系我们【E-Mail:cb@itdo.tech】 我们会及时删除侵权内容，谢谢合作！