|
"""Customize logging |
|
|
|
Defines custom logger class for the `logger.verbose(...)` method. |
|
|
|
init_logging() must be called before any other modules that call logging.getLogger. |
|
""" |
|
|
|
import logging |
|
from typing import Any, cast |
|
|
|
|
|
|
|
VERBOSE = 15 |
|
|
|
|
|
class VerboseLogger(logging.Logger): |
|
"""Custom Logger, defining a verbose log-level |
|
|
|
VERBOSE is between INFO and DEBUG. |
|
""" |
|
|
|
def verbose(self, msg: str, *args: Any, **kwargs: Any) -> None: |
|
return self.log(VERBOSE, msg, *args, **kwargs) |
|
|
|
|
|
def getLogger(name: str) -> VerboseLogger: |
|
"""logging.getLogger, but ensures our VerboseLogger class is returned""" |
|
return cast(VerboseLogger, logging.getLogger(name)) |
|
|
|
|
|
def init_logging() -> None: |
|
"""Register our VerboseLogger and VERBOSE log level. |
|
|
|
Should be called before any calls to getLogger(), |
|
i.e. in pip._internal.__init__ |
|
""" |
|
logging.setLoggerClass(VerboseLogger) |
|
logging.addLevelName(VERBOSE, "VERBOSE") |
|
|