pip.utils.loggingIndentingFormatter()：使日志输出更加清晰

pip.utils.loggingIndentingFormatter() 是 pip 工具中一个用于日志输出的格式化处理类。它能够将日志输出按照不同的层级进行缩进，使日志更加清晰易读。

下面是 loggingIndentingFormatter() 类的代码实现：

import logging
import sys

class IndentingFormatter(logging.Formatter):
    def __init__(self, fmt=None, indent_str='    '):
        super(IndentingFormatter, self).__init__(fmt)
        self.indent_str = indent_str
        self.indent = 0

    def format(self, record):
        if record.levelno == logging.INFO:
            self.indent += 1
        formatted = super(IndentingFormatter, self).format(record)
        if record.levelno == logging.INFO:
            self.indent -= 1
        return self.indent_str * self.indent + formatted

# 用法示例
if __name__ == '__main__':
    logger = logging.getLogger()
    logger.setLevel(logging.DEBUG)

    handler = logging.StreamHandler(sys.stdout)
    handler.setLevel(logging.DEBUG)

    formatter = IndentingFormatter('%(levelname)s: %(message)s')
    handler.setFormatter(formatter)

    logger.addHandler(handler)

    logger.debug('Debug message')
    logger.info('Info message')
    logger.warn('Warning message')
    logger.error('Error message')
    logger.critical('Critical message')

该类继承了 logging.Formatter ，在 format() 方法中对输出信息进行格式化。它添加了一个 indent_str 属性，默认为四个空格，用于设置缩进的字符数。在每个输出信息的前面加上了相应数量的缩进字符，以实现层级缩进的效果。

用法示例中，首先获取默认的 root logger，并将日志级别设置为 DEBUG 。然后创建一个 StreamHandler ，将日志输出到标准输出流。接着创建一个 IndentingFormatter 对象，并设置日志消息的格式。最后将 StreamHandler 添加到 root logger 中。

这样执行示例代码时，会输出以下日志信息（已添加缩进）：

DEBUG: Debug message
    INFO: Info message
        WARNING: Warning message
            ERROR: Error message
                CRITICAL: Critical message

从输出中可以看到，不同层级的日志信息通过缩进进行了区分，使得日志输出更加清晰易读。

实际使用中，你可以根据自己的需求自定义格式化字符串，并灵活设置日志级别和日志输出目标。这对于调试和排查问题非常有用。