Kivy - 日志记录器

Python 的标准库包含 logging 模块，该模块有助于在 Python 应用程序中实现强大的事件日志系统。Kivy 的日志记录机制在此基础上构建，并具有一些额外的功能，例如在支持的终端上进行颜色编码的输出、消息分类等。

每次运行 Kivy 应用程序时，您都会看到控制台窗口中显示的日志。它看起来像这样：

[INFO  ] [Logger  ] Record log in C:\Users\user\.kivy\logs\kivy_23-07-10_67.txt
[INFO  ] [deps    ] Successfully imported "kivy_deps.gstreamer" 0.3.3
[INFO  ] [deps    ] Successfully imported "kivy_deps.angle" 0.3.3
[INFO  ] [deps    ] Successfully imported "kivy_deps.glew" 0.3.1
[INFO  ] [deps    ] Successfully imported "kivy_deps.sdl2" 0.6.0
[INFO  ] [Kivy    ] v2.2.0
[INFO  ] [Kivy    ] Installed at "c:\kivyenv\Lib\sitepackages\kivy\__init__.py"
[INFO  ] [Python  ] v3.11.2 (tags/v3.11.2:878ead1, Feb 7 2023, 16:38:35) [MSC v.1934 64 bit (AMD64)]
[INFO  ] [Python  ] Interpreter at "c:\kivyenv\Scripts\python.exe"
[INFO  ] [Logger  ] Purge log fired. Processing...
[INFO  ] [Logger  ] Purge finished!
[INFO  ] [Factory ] 190 symbols loaded
[INFO  ] [Image   ] Providers: img_tex, img_dds, img_sdl2, img_pil (img_ffpyplayer ignored)
[INFO  ] [Window  ] Provider: sdl2
[INFO  ] [GL      ] Using the "OpenGL" graphics system
[INFO  ] [GL      ] GLEW initialization succeeded
[INFO  ] [GL      ] Backend used <glew>
[INFO  ] [GL      ] OpenGL version <b'4.6.0 - Build 31.0.101.3959'>
[INFO  ] [GL      ] OpenGL vendor <b'Intel'>
[INFO  ] [GL      ] OpenGL renderer <b'Intel(R) Iris(R) Xe Graphics'>
[INFO  ] [GL      ] OpenGL parsed version: 4, 6
[INFO  ] [GL      ] Shading version <b'4.60 - Build 31.0.101.3959'>
[INFO  ] [GL      ] Texture max size <16384>
[INFO  ] [GL      ] Texture max units <32>
[INFO  ] [Window  ] auto add sdl2 input provider
[INFO  ] [Window  ] virtual keyboard not allowed, single mode, not docked
[INFO  ] [Text    ] Provider: sdl2
[INFO  ] [Base    ] Start application main loop
[INFO  ] [GL      ] NPOT texture support is available

这些消息告诉您已检测到并初始化了哪些硬件和驱动程序，以及哪些硬件和驱动程序无法完成初始化。

Kivy 库中的 Logger 类提供了一个单例实例，并在 kivy.logger 模块中定义。除了 Python 的 logging 模块中的日志级别（debug、info、warning、error 和 critical）之外，Kivy 还具有一个额外的跟踪级别。

Logger 对象具有与上述日志级别相对应的方法。这些方法中的每一个都接受一个字符串参数 - message - 分为两部分，用冒号（:）符号分隔。第一部分用作标题，冒号后的字符串是日志消息。

from kivy.logger import Logger

Logger.info('title: This is a info message.')
Logger.debug('title: This is a debug message.')

默认日志级别在 Kivy 的配置文件中设置为 info。因此，您会看到如此长的日志输出。您可以通过 Logger 对象的 setlevel() 方法将其设置为任何所需的日志级别。

from kivy.logger import Logger, LOG_LEVELS

Logger.setLevel(LOG_LEVELS["debug"])

Kivy 的日志记录机制由环境变量 KIVY_LOG_MODE 控制，该变量具有三个可能的值：KIVY、PYTHON、MIXED。

默认的 KIVY_LOG_MODE 是 KIVY，因此系统中的所有日志消息都输出到 Kivy 日志文件和控制台。

如果将其设置为 PYTHON 模式，则不会添加任何处理程序，并且不会捕获 sys.stderr 输出。客户端可以自行添加合适的处理程序。

在 MIXED 模式下，处理程序直接添加到 Kivy 的 Logger 对象，并且关闭传播。sys.stderr 未重定向。

所有与日志记录相关的配置参数都可以在 config.ini 文件的 [Kivy] 部分中找到。参数及其默认值如下：

log_dir = logs
log_enable = 1
log_level = info
log_name = kivy_%y-%m-%d_%_.txt
log_maxfiles = 100

请注意，即使未启用日志记录器，您也可以访问最后 100 个 LogRecords。

from kivy.logger import LoggerHistory
print(LoggerHistory.history)

打印页面