add (overwrite with) mypy stubs, if available

stdlib/3/logging/__init__.pyi

@@ -0,0 +1,239 @@
+# Stubs for logging (Python 3.4)
+#
+# NOTE: This dynamically typed stub was automatically generated by stubgen.
+
+from typing import Any
+
+CRITICAL = ...  # type: Any
+FATAL = ...  # type: Any
+ERROR = ...  # type: Any
+WARNING = ...  # type: Any
+WARN = ...  # type: Any
+INFO = ...  # type: Any
+DEBUG = ...  # type: Any
+NOTSET = ...  # type: Any
+
+def getLevelName(level): ...
+def addLevelName(level, levelName): ...
+
+class LogRecord:
+    name = ...  # type: Any
+    msg = ...  # type: Any
+    args = ...  # type: Any
+    levelname = ...  # type: Any
+    levelno = ...  # type: Any
+    pathname = ...  # type: Any
+    filename = ...  # type: Any
+    module = ...  # type: Any
+    exc_info = ...  # type: Any
+    exc_text = ...  # type: Any
+    stack_info = ...  # type: Any
+    lineno = ...  # type: Any
+    funcName = ...  # type: Any
+    created = ...  # type: Any
+    msecs = ...  # type: Any
+    relativeCreated = ...  # type: Any
+    thread = ...  # type: Any
+    threadName = ...  # type: Any
+    processName = ...  # type: Any
+    process = ...  # type: Any
+    def __init__(self, name, level, pathname, lineno, msg, args, exc_info, func=None, sinfo=None,
+                 **kwargs): ...
+    def getMessage(self): ...
+
+def setLogRecordFactory(factory): ...
+def getLogRecordFactory(): ...
+def makeLogRecord(dict): ...
+
+class PercentStyle:
+    default_format = ...  # type: Any
+    asctime_format = ...  # type: Any
+    asctime_search = ...  # type: Any
+    def __init__(self, fmt): ...
+    def usesTime(self): ...
+    def format(self, record): ...
+
+class StrFormatStyle(PercentStyle):
+    default_format = ...  # type: Any
+    asctime_format = ...  # type: Any
+    asctime_search = ...  # type: Any
+    def format(self, record): ...
+
+class StringTemplateStyle(PercentStyle):
+    default_format = ...  # type: Any
+    asctime_format = ...  # type: Any
+    asctime_search = ...  # type: Any
+    def __init__(self, fmt): ...
+    def usesTime(self): ...
+    def format(self, record): ...
+
+BASIC_FORMAT = ...  # type: Any
+
+class Formatter:
+    converter = ...  # type: Any
+    datefmt = ...  # type: Any
+    def __init__(self, fmt=None, datefmt=None, style=''): ...
+    default_time_format = ...  # type: Any
+    default_msec_format = ...  # type: Any
+    def formatTime(self, record, datefmt=None): ...
+    def formatException(self, ei): ...
+    def usesTime(self): ...
+    def formatMessage(self, record): ...
+    def formatStack(self, stack_info): ...
+    def format(self, record): ...
+
+class BufferingFormatter:
+    linefmt = ...  # type: Any
+    def __init__(self, linefmt=None): ...
+    def formatHeader(self, records): ...
+    def formatFooter(self, records): ...
+    def format(self, records): ...
+
+class Filter:
+    name = ...  # type: Any
+    nlen = ...  # type: Any
+    def __init__(self, name=''): ...
+    def filter(self, record): ...
+
+class Filterer:
+    filters = ...  # type: Any
+    def __init__(self): ...
+    def addFilter(self, filter): ...
+    def removeFilter(self, filter): ...
+    def filter(self, record): ...
+
+class Handler(Filterer):
+    level = ...  # type: Any
+    formatter = ...  # type: Any
+    def __init__(self, level=...): ...
+    def get_name(self): ...
+    def set_name(self, name): ...
+    name = ...  # type: Any
+    lock = ...  # type: Any
+    def createLock(self): ...
+    def acquire(self): ...
+    def release(self): ...
+    def setLevel(self, level): ...
+    def format(self, record): ...
+    def emit(self, record): ...
+    def handle(self, record): ...
+    def setFormatter(self, fmt): ...
+    def flush(self): ...
+    def close(self): ...
+    def handleError(self, record): ...
+
+class StreamHandler(Handler):
+    terminator = ...  # type: Any
+    stream = ...  # type: Any
+    def __init__(self, stream=None): ...
+    def flush(self): ...
+    def emit(self, record): ...
+
+class FileHandler(StreamHandler):
+    baseFilename = ...  # type: Any
+    mode = ...  # type: Any
+    encoding = ...  # type: Any
+    delay = ...  # type: Any
+    stream = ...  # type: Any
+    def __init__(self, filename, mode='', encoding=None, delay=False): ...
+    def close(self): ...
+    def emit(self, record): ...
+
+class _StderrHandler(StreamHandler):
+    def __init__(self, level=...): ...
+
+lastResort = ...  # type: Any
+
+class PlaceHolder:
+    loggerMap = ...  # type: Any
+    def __init__(self, alogger): ...
+    def append(self, alogger): ...
+
+def setLoggerClass(klass): ...
+def getLoggerClass(): ...
+
+class Manager:
+    root = ...  # type: Any
+    disable = ...  # type: Any
+    emittedNoHandlerWarning = ...  # type: Any
+    loggerDict = ...  # type: Any
+    loggerClass = ...  # type: Any
+    logRecordFactory = ...  # type: Any
+    def __init__(self, rootnode): ...
+    def getLogger(self, name): ...
+    def setLoggerClass(self, klass): ...
+    def setLogRecordFactory(self, factory): ...
+
+class Logger(Filterer):
+    name = ...  # type: Any
+    level = ...  # type: Any
+    parent = ...  # type: Any
+    propagate = ...  # type: Any
+    handlers = ...  # type: Any
+    disabled = ...  # type: Any
+    def __init__(self, name, level=...): ...
+    def setLevel(self, level): ...
+    def debug(self, msg, *args, **kwargs): ...
+    def info(self, msg, *args, **kwargs): ...
+    def warning(self, msg, *args, **kwargs): ...
+    def warn(self, msg, *args, **kwargs): ...
+    def error(self, msg, *args, **kwargs): ...
+    def exception(self, msg, *args, **kwargs): ...
+    def critical(self, msg, *args, **kwargs): ...
+    fatal = ...  # type: Any
+    def log(self, level, msg, *args, **kwargs): ...
+    def findCaller(self, stack_info=False): ...
+    def makeRecord(self, name, level, fn, lno, msg, args, exc_info, func=None, extra=None,
+                   sinfo=None): ...
+    def handle(self, record): ...
+    def addHandler(self, hdlr): ...
+    def removeHandler(self, hdlr): ...
+    def hasHandlers(self): ...
+    def callHandlers(self, record): ...
+    def getEffectiveLevel(self): ...
+    def isEnabledFor(self, level): ...
+    def getChild(self, suffix): ...
+
+class RootLogger(Logger):
+    def __init__(self, level): ...
+
+class LoggerAdapter:
+    logger = ...  # type: Any
+    extra = ...  # type: Any
+    def __init__(self, logger, extra): ...
+    def process(self, msg, kwargs): ...
+    def debug(self, msg, *args, **kwargs): ...
+    def info(self, msg, *args, **kwargs): ...
+    def warning(self, msg, *args, **kwargs): ...
+    def warn(self, msg, *args, **kwargs): ...
+    def error(self, msg, *args, **kwargs): ...
+    def exception(self, msg, *args, **kwargs): ...
+    def critical(self, msg, *args, **kwargs): ...
+    def log(self, level, msg, *args, **kwargs): ...
+    def isEnabledFor(self, level): ...
+    def setLevel(self, level): ...
+    def getEffectiveLevel(self): ...
+    def hasHandlers(self): ...
+
+def basicConfig(**kwargs): ...
+def getLogger(name=None): ...
+def critical(msg, *args, **kwargs): ...
+
+fatal = ...  # type: Any
+
+def error(msg, *args, **kwargs): ...
+def exception(msg, *args, **kwargs): ...
+def warning(msg, *args, **kwargs): ...
+def warn(msg, *args, **kwargs): ...
+def info(msg, *args, **kwargs): ...
+def debug(msg, *args, **kwargs): ...
+def log(level, msg, *args, **kwargs): ...
+def disable(level): ...
+
+class NullHandler(Handler):
+    def handle(self, record): ...
+    def emit(self, record): ...
+    lock = ...  # type: Any
+    def createLock(self): ...
+
+def captureWarnings(capture): ...

stdlib/3/logging/handlers.pyi

@@ -0,0 +1,200 @@
+# Stubs for logging.handlers (Python 3.4)
+#
+# NOTE: This dynamically typed stub was automatically generated by stubgen.
+
+from typing import Any
+import logging
+
+threading = ...  # type: Any
+DEFAULT_TCP_LOGGING_PORT = ...  # type: Any
+DEFAULT_UDP_LOGGING_PORT = ...  # type: Any
+DEFAULT_HTTP_LOGGING_PORT = ...  # type: Any
+DEFAULT_SOAP_LOGGING_PORT = ...  # type: Any
+SYSLOG_UDP_PORT = ...  # type: Any
+SYSLOG_TCP_PORT = ...  # type: Any
+
+class BaseRotatingHandler(logging.FileHandler):
+    mode = ...  # type: Any
+    encoding = ...  # type: Any
+    namer = ...  # type: Any
+    rotator = ...  # type: Any
+    def __init__(self, filename, mode, encoding=None, delay=False): ...
+    def emit(self, record): ...
+    def rotation_filename(self, default_name): ...
+    def rotate(self, source, dest): ...
+
+class RotatingFileHandler(BaseRotatingHandler):
+    maxBytes = ...  # type: Any
+    backupCount = ...  # type: Any
+    def __init__(self, filename, mode='', maxBytes=0, backupCount=0, encoding=None,
+                 delay=False): ...
+    stream = ...  # type: Any
+    def doRollover(self): ...
+    def shouldRollover(self, record): ...
+
+class TimedRotatingFileHandler(BaseRotatingHandler):
+    when = ...  # type: Any
+    backupCount = ...  # type: Any
+    utc = ...  # type: Any
+    atTime = ...  # type: Any
+    interval = ...  # type: Any
+    suffix = ...  # type: Any
+    extMatch = ...  # type: Any
+    dayOfWeek = ...  # type: Any
+    rolloverAt = ...  # type: Any
+    def __init__(self, filename, when='', interval=1, backupCount=0, encoding=None, delay=False,
+                 utc=False, atTime=None): ...
+    def computeRollover(self, currentTime): ...
+    def shouldRollover(self, record): ...
+    def getFilesToDelete(self): ...
+    stream = ...  # type: Any
+    def doRollover(self): ...
+
+class WatchedFileHandler(logging.FileHandler):
+    def __init__(self, filename, mode='', encoding=None, delay=False): ...
+    stream = ...  # type: Any
+    def emit(self, record): ...
+
+class SocketHandler(logging.Handler):
+    host = ...  # type: Any
+    port = ...  # type: Any
+    address = ...  # type: Any
+    sock = ...  # type: Any
+    closeOnError = ...  # type: Any
+    retryTime = ...  # type: Any
+    retryStart = ...  # type: Any
+    retryMax = ...  # type: Any
+    retryFactor = ...  # type: Any
+    def __init__(self, host, port): ...
+    def makeSocket(self, timeout=1): ...
+    retryPeriod = ...  # type: Any
+    def createSocket(self): ...
+    def send(self, s): ...
+    def makePickle(self, record): ...
+    def handleError(self, record): ...
+    def emit(self, record): ...
+    def close(self): ...
+
+class DatagramHandler(SocketHandler):
+    closeOnError = ...  # type: Any
+    def __init__(self, host, port): ...
+    def makeSocket(self, timeout=1): ... # TODO: Actually does not have the timeout argument.
+    def send(self, s): ...
+
+class SysLogHandler(logging.Handler):
+    LOG_EMERG = ...  # type: Any
+    LOG_ALERT = ...  # type: Any
+    LOG_CRIT = ...  # type: Any
+    LOG_ERR = ...  # type: Any
+    LOG_WARNING = ...  # type: Any
+    LOG_NOTICE = ...  # type: Any
+    LOG_INFO = ...  # type: Any
+    LOG_DEBUG = ...  # type: Any
+    LOG_KERN = ...  # type: Any
+    LOG_USER = ...  # type: Any
+    LOG_MAIL = ...  # type: Any
+    LOG_DAEMON = ...  # type: Any
+    LOG_AUTH = ...  # type: Any
+    LOG_SYSLOG = ...  # type: Any
+    LOG_LPR = ...  # type: Any
+    LOG_NEWS = ...  # type: Any
+    LOG_UUCP = ...  # type: Any
+    LOG_CRON = ...  # type: Any
+    LOG_AUTHPRIV = ...  # type: Any
+    LOG_FTP = ...  # type: Any
+    LOG_LOCAL0 = ...  # type: Any
+    LOG_LOCAL1 = ...  # type: Any
+    LOG_LOCAL2 = ...  # type: Any
+    LOG_LOCAL3 = ...  # type: Any
+    LOG_LOCAL4 = ...  # type: Any
+    LOG_LOCAL5 = ...  # type: Any
+    LOG_LOCAL6 = ...  # type: Any
+    LOG_LOCAL7 = ...  # type: Any
+    priority_names = ...  # type: Any
+    facility_names = ...  # type: Any
+    priority_map = ...  # type: Any
+    address = ...  # type: Any
+    facility = ...  # type: Any
+    socktype = ...  # type: Any
+    unixsocket = ...  # type: Any
+    socket = ...  # type: Any
+    formatter = ...  # type: Any
+    def __init__(self, address=..., facility=..., socktype=None): ...
+    def encodePriority(self, facility, priority): ...
+    def close(self): ...
+    def mapPriority(self, levelName): ...
+    ident = ...  # type: Any
+    append_nul = ...  # type: Any
+    def emit(self, record): ...
+
+class SMTPHandler(logging.Handler):
+    username = ...  # type: Any
+    fromaddr = ...  # type: Any
+    toaddrs = ...  # type: Any
+    subject = ...  # type: Any
+    secure = ...  # type: Any
+    timeout = ...  # type: Any
+    def __init__(self, mailhost, fromaddr, toaddrs, subject, credentials=None, secure=None,
+                 timeout=0.0): ...
+    def getSubject(self, record): ...
+    def emit(self, record): ...
+
+class NTEventLogHandler(logging.Handler):
+    appname = ...  # type: Any
+    dllname = ...  # type: Any
+    logtype = ...  # type: Any
+    deftype = ...  # type: Any
+    typemap = ...  # type: Any
+    def __init__(self, appname, dllname=None, logtype=''): ...
+    def getMessageID(self, record): ...
+    def getEventCategory(self, record): ...
+    def getEventType(self, record): ...
+    def emit(self, record): ...
+    def close(self): ...
+
+class HTTPHandler(logging.Handler):
+    host = ...  # type: Any
+    url = ...  # type: Any
+    method = ...  # type: Any
+    secure = ...  # type: Any
+    credentials = ...  # type: Any
+    def __init__(self, host, url, method='', secure=False, credentials=None): ...
+    def mapLogRecord(self, record): ...
+    def emit(self, record): ...
+
+class BufferingHandler(logging.Handler):
+    capacity = ...  # type: Any
+    buffer = ...  # type: Any
+    def __init__(self, capacity): ...
+    def shouldFlush(self, record): ...
+    def emit(self, record): ...
+    def flush(self): ...
+    def close(self): ...
+
+class MemoryHandler(BufferingHandler):
+    flushLevel = ...  # type: Any
+    target = ...  # type: Any
+    def __init__(self, capacity, flushLevel=..., target=None): ...
+    def shouldFlush(self, record): ...
+    def setTarget(self, target): ...
+    buffer = ...  # type: Any
+    def flush(self): ...
+    def close(self): ...
+
+class QueueHandler(logging.Handler):
+    queue = ...  # type: Any
+    def __init__(self, queue): ...
+    def enqueue(self, record): ...
+    def prepare(self, record): ...
+    def emit(self, record): ...
+
+class QueueListener:
+    queue = ...  # type: Any
+    handlers = ...  # type: Any
+    def __init__(self, queue, *handlers): ...
+    def dequeue(self, block): ...
+    def start(self): ...
+    def prepare(self, record): ...
+    def handle(self, record): ...
+    def enqueue_sentinel(self): ...
+    def stop(self): ...