--- /dev/null
+# Stubs for logging (Python 3.4)\r
+\r
+from typing import (\r
+ Any, Callable, Dict, Iterable, List, Mapping, MutableMapping, Optional, IO,\r
+ Tuple, Text, Union, overload,\r
+)\r
+from string import Template\r
+from time import struct_time\r
+from types import TracebackType\r
+import sys\r
+import threading\r
+\r
+_SysExcInfoType = Union[Tuple[type, BaseException, Optional[TracebackType]],\r
+ Tuple[None, None, None]]\r
+if sys.version_info >= (3, 5):\r
+ _ExcInfoType = Union[None, bool, _SysExcInfoType, BaseException]\r
+else:\r
+ _ExcInfoType = Union[None, bool, _SysExcInfoType]\r
+_ArgsType = Union[Tuple[Any, ...], Dict[str, Any]]\r
+_FilterType = Union['Filter', Callable[['LogRecord'], int]]\r
+_Level = Union[int, Text]\r
+\r
+raiseExceptions: bool\r
+\r
+if sys.version_info >= (3,):\r
+ _levelToName = ... # type: Dict[int, str]\r
+ _nameToLevel = ... # type: Dict[str, int]\r
+else:\r
+ _levelNames = ... # type: dict\r
+\r
+class Filterer(object):\r
+ filters = ... # type: List[Filter]\r
+ def __init__(self) -> None: ...\r
+ def addFilter(self, filter: Filter) -> None: ...\r
+ def removeFilter(self, filter: Filter) -> None: ...\r
+ def filter(self, record: 'LogRecord') -> bool: ...\r
+\r
+class Logger(Filterer):\r
+ name = ... # type: str\r
+ level = ... # type: int\r
+ parent = ... # type: Union[Logger, PlaceHolder]\r
+ propagate = ... # type: bool\r
+ handlers = ... # type: List[Handler]\r
+ disabled = ... # type: int\r
+ def __init__(self, name: str, level: _Level = ...) -> None: ...\r
+ def setLevel(self, lvl: Union[int, str]) -> None: ...\r
+ def isEnabledFor(self, lvl: int) -> bool: ...\r
+ def getEffectiveLevel(self) -> int: ...\r
+ def getChild(self, suffix: str) -> 'Logger': ...\r
+ if sys.version_info >= (3,):\r
+ def debug(self, msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ stack_info: bool = ..., extra: Optional[Dict[str, Any]] = ...,\r
+ **kwargs: Any) -> None: ...\r
+ def info(self, msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ stack_info: bool = ..., extra: Optional[Dict[str, Any]] = ...,\r
+ **kwargs: Any) -> None: ...\r
+ def warning(self, msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ stack_info: bool = ..., extra: Optional[Dict[str, Any]] = ...,\r
+ **kwargs: Any) -> None: ...\r
+ def warn(self, msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ stack_info: bool = ..., extra: Optional[Dict[str, Any]] = ...,\r
+ **kwargs: Any) -> None: ...\r
+ def error(self, msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ stack_info: bool = ..., extra: Optional[Dict[str, Any]] = ...,\r
+ **kwargs: Any) -> None: ...\r
+ def critical(self, msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ stack_info: bool = ..., extra: Optional[Dict[str, Any]] = ...,\r
+ **kwargs: Any) -> None: ...\r
+ def log(self, lvl: int, msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ stack_info: bool = ..., extra: Optional[Dict[str, Any]] = ...,\r
+ **kwargs: Any) -> None: ...\r
+ def exception(self, msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ stack_info: bool = ..., extra: Optional[Dict[str, Any]] = ...,\r
+ **kwargs: Any) -> None: ...\r
+ else:\r
+ def debug(self,\r
+ msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ extra: Optional[Dict[str, Any]] = ..., **kwargs: Any) -> None: ...\r
+ def info(self,\r
+ msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ extra: Optional[Dict[str, Any]] = ..., **kwargs: Any) -> None: ...\r
+ def warning(self,\r
+ msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ extra: Optional[Dict[str, Any]] = ..., **kwargs: Any) -> None: ...\r
+ def warn(self,\r
+ msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ extra: Optional[Dict[str, Any]] = ..., **kwargs: Any) -> None: ...\r
+ def error(self,\r
+ msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ extra: Optional[Dict[str, Any]] = ..., **kwargs: Any) -> None: ...\r
+ def critical(self,\r
+ msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ extra: Optional[Dict[str, Any]] = ..., **kwargs: Any) -> None: ...\r
+ def log(self,\r
+ lvl: int, msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ extra: Optional[Dict[str, Any]] = ..., **kwargs: Any) -> None: ...\r
+ def exception(self,\r
+ msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ extra: Optional[Dict[str, Any]] = ..., **kwargs: Any) -> None: ...\r
+ def addFilter(self, filt: _FilterType) -> None: ...\r
+ def removeFilter(self, filt: _FilterType) -> None: ...\r
+ def filter(self, record: 'LogRecord') -> bool: ...\r
+ def addHandler(self, hdlr: 'Handler') -> None: ...\r
+ def removeHandler(self, hdlr: 'Handler') -> None: ...\r
+ if sys.version_info >= (3,):\r
+ def findCaller(self, stack_info: bool = ...) -> Tuple[str, int, str, Optional[str]]: ...\r
+ else:\r
+ def findCaller(self) -> Tuple[str, int, str]: ...\r
+ def handle(self, record: 'LogRecord') -> None: ...\r
+ if sys.version_info >= (3,):\r
+ def makeRecord(self, name: str, lvl: int, fn: str, lno: int, msg: Any,\r
+ args: Mapping[str, Any],\r
+ exc_info: Optional[_SysExcInfoType],\r
+ func: Optional[str] = ...,\r
+ extra: Optional[Mapping[str, Any]] = ...,\r
+ sinfo: Optional[str] = ...) -> LogRecord: ...\r
+ else:\r
+ def makeRecord(self,\r
+ name: str, lvl: int, fn: str, lno: int, msg: Any,\r
+ args: Mapping[str, Any],\r
+ exc_info: Optional[_SysExcInfoType],\r
+ func: Optional[str] = ...,\r
+ extra: Optional[Mapping[str, Any]] = ...) -> LogRecord: ...\r
+ if sys.version_info >= (3,):\r
+ def hasHandlers(self) -> bool: ...\r
+\r
+\r
+CRITICAL = ... # type: int\r
+FATAL = ... # type: int\r
+ERROR = ... # type: int\r
+WARNING = ... # type: int\r
+WARN = ... # type: int\r
+INFO = ... # type: int\r
+DEBUG = ... # type: int\r
+NOTSET = ... # type: int\r
+\r
+\r
+class Handler(Filterer):\r
+ level = ... # type: int\r
+ formatter = ... # type: Optional[Formatter]\r
+ lock = ... # type: Optional[threading.Lock]\r
+ def __init__(self, level: _Level = ...) -> None: ...\r
+ def createLock(self) -> None: ...\r
+ def acquire(self) -> None: ...\r
+ def release(self) -> None: ...\r
+ def setLevel(self, lvl: Union[int, str]) -> None: ...\r
+ def setFormatter(self, form: 'Formatter') -> None: ...\r
+ def addFilter(self, filt: _FilterType) -> None: ...\r
+ def removeFilter(self, filt: _FilterType) -> None: ...\r
+ def filter(self, record: 'LogRecord') -> bool: ...\r
+ def flush(self) -> None: ...\r
+ def close(self) -> None: ...\r
+ def handle(self, record: 'LogRecord') -> None: ...\r
+ def handleError(self, record: 'LogRecord') -> None: ...\r
+ def format(self, record: 'LogRecord') -> str: ...\r
+ def emit(self, record: 'LogRecord') -> None: ...\r
+\r
+\r
+class Formatter:\r
+ converter = ... # type: Callable[[Optional[float]], struct_time]\r
+ _fmt = ... # type: Optional[str]\r
+ datefmt = ... # type: Optional[str]\r
+ if sys.version_info >= (3,):\r
+ _style = ... # type: PercentStyle\r
+ default_time_format = ... # type: str\r
+ default_msec_format = ... # type: str\r
+\r
+ if sys.version_info >= (3,):\r
+ def __init__(self, fmt: Optional[str] = ...,\r
+ datefmt: Optional[str] =...,\r
+ style: str = ...) -> None: ...\r
+ else:\r
+ def __init__(self,\r
+ fmt: Optional[str] = ...,\r
+ datefmt: Optional[str] =...) -> None: ...\r
+\r
+ def format(self, record: 'LogRecord') -> str: ...\r
+ def formatTime(self, record: 'LogRecord', datefmt: str = ...) -> str: ...\r
+ def formatException(self, exc_info: _SysExcInfoType) -> str: ...\r
+ if sys.version_info >= (3,):\r
+ def formatStack(self, stack_info: str) -> str: ...\r
+\r
+\r
+class Filter:\r
+ def __init__(self, name: str = ...) -> None: ...\r
+ def filter(self, record: 'LogRecord') -> int: ...\r
+\r
+\r
+class LogRecord:\r
+ args = ... # type: _ArgsType\r
+ asctime = ... # type: str\r
+ created = ... # type: int\r
+ exc_info = ... # type: Optional[_SysExcInfoType]\r
+ filename = ... # type: str\r
+ funcName = ... # type: str\r
+ levelname = ... # type: str\r
+ levelno = ... # type: int\r
+ lineno = ... # type: int\r
+ module = ... # type: str\r
+ msecs = ... # type: int\r
+ message = ... # type: str\r
+ msg = ... # type: str\r
+ name = ... # type: str\r
+ pathname = ... # type: str\r
+ process = ... # type: int\r
+ processName = ... # type: str\r
+ relativeCreated = ... # type: int\r
+ if sys.version_info >= (3,):\r
+ stack_info = ... # type: Optional[str]\r
+ thread = ... # type: int\r
+ threadName = ... # type: str\r
+ if sys.version_info >= (3,):\r
+ def __init__(self, name: str, level: int, pathname: str, lineno: int,\r
+ msg: Any, args: _ArgsType,\r
+ exc_info: Optional[_SysExcInfoType],\r
+ func: Optional[str] = ...,\r
+ sinfo: Optional[str] = ...) -> None: ...\r
+ else:\r
+ def __init__(self,\r
+ name: str, level: int, pathname: str, lineno: int,\r
+ msg: Any, args: _ArgsType,\r
+ exc_info: Optional[_SysExcInfoType],\r
+ func: Optional[str] = ...) -> None: ...\r
+ def getMessage(self) -> str: ...\r
+\r
+\r
+class LoggerAdapter:\r
+ def __init__(self, logger: Logger, extra: Mapping[str, Any]) -> None: ...\r
+ def process(self, msg: Any, kwargs: MutableMapping[str, Any]) -> Tuple[Any, MutableMapping[str, Any]]: ...\r
+ if sys.version_info >= (3,):\r
+ def debug(self, msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ stack_info: bool = ..., extra: Optional[Dict[str, Any]] = ...,\r
+ **kwargs: Any) -> None: ...\r
+ def info(self, msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ stack_info: bool = ..., extra: Optional[Dict[str, Any]] = ...,\r
+ **kwargs: Any) -> None: ...\r
+ def warning(self, msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ stack_info: bool = ..., extra: Optional[Dict[str, Any]] = ...,\r
+ **kwargs: Any) -> None: ...\r
+ def error(self, msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ stack_info: bool = ..., extra: Optional[Dict[str, Any]] = ...,\r
+ **kwargs: Any) -> None: ...\r
+ def exception(self, msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ stack_info: bool = ..., extra: Optional[Dict[str, Any]] = ...,\r
+ **kwargs: Any) -> None: ...\r
+ def critical(self, msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ stack_info: bool = ..., extra: Optional[Dict[str, Any]] = ...,\r
+ **kwargs: Any) -> None: ...\r
+ def log(self, lvl: int, msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ stack_info: bool = ..., extra: Optional[Dict[str, Any]] = ...,\r
+ **kwargs: Any) -> None: ...\r
+ else:\r
+ def debug(self,\r
+ msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ extra: Optional[Dict[str, Any]] = ..., **kwargs: Any) -> None: ...\r
+ def info(self,\r
+ msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ extra: Optional[Dict[str, Any]] = ..., **kwargs: Any) -> None: ...\r
+ def warning(self,\r
+ msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ extra: Optional[Dict[str, Any]] = ..., **kwargs: Any) -> None: ...\r
+ def error(self,\r
+ msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ extra: Optional[Dict[str, Any]] = ..., **kwargs: Any) -> None: ...\r
+ def exception(self,\r
+ msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ extra: Optional[Dict[str, Any]] = ..., **kwargs: Any) -> None: ...\r
+ def critical(self,\r
+ msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ extra: Optional[Dict[str, Any]] = ..., **kwargs: Any) -> None: ...\r
+ def log(self,\r
+ lvl: int, msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ extra: Optional[Dict[str, Any]] = ..., **kwargs: Any) -> None: ...\r
+ def isEnabledFor(self, lvl: int) -> bool: ...\r
+ if sys.version_info >= (3,):\r
+ def getEffectiveLevel(self) -> int: ...\r
+ def setLevel(self, lvl: Union[int, str]) -> None: ...\r
+ def hasHandlers(self) -> bool: ...\r
+\r
+\r
+if sys.version_info >= (3,):\r
+ def getLogger(name: Optional[str] = ...) -> Logger: ...\r
+else:\r
+ @overload\r
+ def getLogger() -> Logger: ...\r
+ @overload\r
+ def getLogger(name: Union[Text, str]) -> Logger: ...\r
+def getLoggerClass() -> type: ...\r
+if sys.version_info >= (3,):\r
+ def getLogRecordFactory() -> Callable[..., LogRecord]: ...\r
+\r
+if sys.version_info >= (3,):\r
+ def debug(msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ stack_info: bool = ..., extra: Optional[Dict[str, Any]] = ...,\r
+ **kwargs: Any) -> None: ...\r
+ def info(msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ stack_info: bool = ..., extra: Optional[Dict[str, Any]] = ...,\r
+ **kwargs: Any) -> None: ...\r
+ def warning(msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ stack_info: bool = ..., extra: Optional[Dict[str, Any]] = ...,\r
+ **kwargs: Any) -> None: ...\r
+ def warn(msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ stack_info: bool = ..., extra: Optional[Dict[str, Any]] = ...,\r
+ **kwargs: Any) -> None: ...\r
+ def error(msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ stack_info: bool = ..., extra: Optional[Dict[str, Any]] = ...,\r
+ **kwargs: Any) -> None: ...\r
+ def critical(msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ stack_info: bool = ..., extra: Optional[Dict[str, Any]] = ...,\r
+ **kwargs: Any) -> None: ...\r
+ def exception(msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ stack_info: bool = ..., extra: Optional[Dict[str, Any]] = ...,\r
+ **kwargs: Any) -> None: ...\r
+ def log(lvl: int, msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ stack_info: bool = ..., extra: Optional[Dict[str, Any]] = ...,\r
+ **kwargs: Any) -> None: ...\r
+else:\r
+ def debug(msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ extra: Optional[Dict[str, Any]] = ..., **kwargs: Any) -> None: ...\r
+ def info(msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ extra: Optional[Dict[str, Any]] = ..., **kwargs: Any) -> None: ...\r
+ def warning(msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ extra: Optional[Dict[str, Any]] = ..., **kwargs: Any) -> None: ...\r
+ def warn(msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ extra: Optional[Dict[str, Any]] = ..., **kwargs: Any) -> None: ...\r
+ def error(msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ extra: Optional[Dict[str, Any]] = ..., **kwargs: Any) -> None: ...\r
+ def critical(msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ extra: Optional[Dict[str, Any]] = ..., **kwargs: Any) -> None: ...\r
+ def exception(msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ extra: Optional[Dict[str, Any]] = ..., **kwargs: Any) -> None: ...\r
+ def log(lvl: int, msg: Any, *args: Any, exc_info: _ExcInfoType = ...,\r
+ extra: Optional[Dict[str, Any]] = ..., **kwargs: Any) -> None: ...\r
+fatal = critical\r
+\r
+def disable(lvl: int) -> None: ...\r
+def addLevelName(lvl: int, levelName: str) -> None: ...\r
+def getLevelName(lvl: int) -> str: ...\r
+\r
+def makeLogRecord(attrdict: Mapping[str, Any]) -> LogRecord: ...\r
+\r
+if sys.version_info >= (3,):\r
+ def basicConfig(*, filename: str = ..., filemode: str = ...,\r
+ format: str = ..., datefmt: str = ..., style: str = ...,\r
+ level: _Level = ..., stream: IO[str] = ...,\r
+ handlers: Iterable[Handler] = ...) -> None: ...\r
+else:\r
+ @overload\r
+ def basicConfig() -> None: ...\r
+ @overload\r
+ def basicConfig(*, filename: str = ..., filemode: str = ...,\r
+ format: str = ..., datefmt: str = ...,\r
+ level: _Level = ..., stream: IO[str] = ...) -> None: ...\r
+def shutdown() -> None: ...\r
+\r
+def setLoggerClass(klass: type) -> None: ...\r
+\r
+def captureWarnings(capture: bool) -> None: ...\r
+\r
+if sys.version_info >= (3,):\r
+ def setLogRecordFactory(factory: Callable[..., LogRecord]) -> None: ...\r
+\r
+\r
+if sys.version_info >= (3,):\r
+ lastResort = ... # type: Optional['StreamHandler']\r
+\r
+\r
+class StreamHandler(Handler):\r
+ stream = ... # type: IO[str]\r
+ if sys.version_info >= (3,):\r
+ terminator = ... # type: str\r
+ def __init__(self, stream: Optional[IO[str]] = ...) -> None: ...\r
+\r
+\r
+class FileHandler(Handler):\r
+ baseFilename = ... # type: str\r
+ mode = ... # type: str\r
+ encoding = ... # type: Optional[str]\r
+ delay = ... # type: bool\r
+ def __init__(self, filename: str, mode: str = ...,\r
+ encoding: Optional[str] = ..., delay: bool = ...) -> None: ...\r
+\r
+\r
+class NullHandler(Handler): ...\r
+\r
+\r
+class PlaceHolder:\r
+ def __init__(self, alogger: Logger) -> None: ...\r
+ def append(self, alogger: Logger) -> None: ...\r
+\r
+\r
+# Below aren't in module docs but still visible\r
+\r
+class RootLogger(Logger): ...\r
+\r
+root = ... # type: RootLogger\r
+\r
+\r
+if sys.version_info >= (3,):\r
+ class PercentStyle(object):\r
+ default_format = ... # type: str\r
+ asctime_format = ... # type: str\r
+ asctime_search = ... # type: str\r
+ _fmt = ... # type: str\r
+\r
+ def __init__(self, fmt: str) -> None: ...\r
+ def usesTime(self) -> bool: ...\r
+ def format(self, record: Any) -> str: ...\r
+\r
+ class StrFormatStyle(PercentStyle):\r
+ ...\r
+\r
+ class StringTemplateStyle(PercentStyle):\r
+ _tpl = ... # type: Template\r
+\r
+ _STYLES = ... # type: Dict[str, Tuple[PercentStyle, str]]\r
+\r
+\r
+BASIC_FORMAT = ... # type: str\r