3.3. Log

3.3. Log

这里介绍 module/logger.py。

日志格式: %(asctime)s.%(msecs)03d | %(levelname)s | %(message)s。

时间格式: %Y-%m-%d %H:%M:%S。

例子: 2020-09-11 08:35:59.460 | INFO | XXXXXXXX。

Log 会打印在控制台上，也会写入到文件中，位置为 f'./log/{datetime.date.today()}_{pyw_name}.txt'

logger 支持基本的调用，比如 logger.info，logger.warning。此外，还有一些额外的函数，用来增强 log 文件的可读性。

关于日志

目前，Alas 的 log 需要人工阅读，为了 log 的可读性，请避免大量使用 logger.hr()，logger.warning()，感叹号 ( ! ) 等表示强调的字符。强调是一个相对的概念，我们之所以看到某个事物被强调了，并不是因为它本身被强调了，而是因为存在大量其他事物并没有被强调。如果你强调了所有的事物，那么相当于你没有强调任何一个事物。

logger.hr(title, level=0)

仅在脚本开始运行时使用。

2020-01-01 00:00:00.000 | INFO | +---------------------------------------------+
2020-01-01 00:00:00.000 | INFO | |                    TITLE                    |
2020-01-01 00:00:00.000 | INFO | +---------------------------------------------+

logger.hr(title, level=1)

表示开始执行 GUI 中的某个功能。

2020-01-01 00:00:00.000 | INFO | ==================== TITLE ====================

logger.hr(title, level=2)

表示功能的某个阶段的开始。比如开始第一场战斗。

2020-01-01 00:00:00.000 | INFO | -------------------- TITLE --------------------

logger.hr(title, level=3)

表示功能的某个细分阶段的开始。

2020-01-01 00:00:00.000 | INFO | <<< TITLE >>>

logger.attr(name, text)

用于打印属性值.

2020-01-01 00:00:00.000 | INFO | [name] text

logger.attr_align(name, text, front='', align=22)

用于打印属性值，有一定的格式。一般用在海图识别的属性打印中。

2020-09-11 02:16:51.542 | INFO |           vanish_point: (  635，-1676)
2020-09-11 02:16:51.543 | INFO |          distant_point: (-2245，-1676)
2020-09-11 02:16:51.568 | INFO | 0.109s  _   Horizontal: 6 (6 inner，2 edge)
2020-09-11 02:16:51.568 | INFO | Edges: /_\    Vertical: 9 (9 inner，2 edge)
2020-09-11 02:16:51.617 | INFO |            tile_center: 0.955 (good match)
2020-09-11 02:16:51.627 | INFO | 0.058s  _   edge_lines: 3 hori，2 vert
2020-09-11 02:16:51.627 | INFO | Edges: /_\   homo_loca: ( 24， 54)
2020-09-11 02:16:51.630 | INFO |            center_loca: (3，2)
2020-09-11 02:16:51.630 | INFO |       camera_corrected: A1 -> D3
2020-09-11 02:16:51.630 | INFO |                 Camera: D3

Misc

• 如果在 Alas 的子目录中运行任意文件，且该文件导入了 logger，就会将运行目录切换至 Alas 的根目录。这样在调试或者运行 dev_tools 的时候，就不会因为忘记切换目录而导致找不到模块。