mirror of
https://github.com/davidhalter/typeshed.git
synced 2025-12-08 21:14:48 +08:00
Modernize logging (#5068)
This commit is contained in:
Sebastian Rittau
File diff suppressed because it is too large
Load Diff
@@ -1,32 +1,20 @@
|
||||
import sys
|
||||
from _typeshed import AnyPath, StrPath
|
||||
from collections.abc import Callable
|
||||
from configparser import RawConfigParser
|
||||
from threading import Thread
|
||||
from typing import IO, Any, Callable, Dict, Optional, Union
|
||||
|
||||
if sys.version_info >= (3,):
|
||||
from configparser import RawConfigParser
|
||||
else:
|
||||
from ConfigParser import RawConfigParser
|
||||
from typing import IO, Any, Optional, Union
|
||||
|
||||
if sys.version_info >= (3, 7):
|
||||
_Path = AnyPath
|
||||
else:
|
||||
_Path = StrPath
|
||||
|
||||
def dictConfig(config: Dict[str, Any]) -> None: ...
|
||||
|
||||
if sys.version_info >= (3, 4):
|
||||
def fileConfig(
|
||||
fname: Union[_Path, IO[str], RawConfigParser],
|
||||
defaults: Optional[Dict[str, str]] = ...,
|
||||
disable_existing_loggers: bool = ...,
|
||||
) -> None: ...
|
||||
def listen(port: int = ..., verify: Optional[Callable[[bytes], Optional[bytes]]] = ...) -> Thread: ...
|
||||
|
||||
else:
|
||||
def fileConfig(
|
||||
fname: Union[str, IO[str]], defaults: Optional[Dict[str, str]] = ..., disable_existing_loggers: bool = ...
|
||||
) -> None: ...
|
||||
def listen(port: int = ...) -> Thread: ...
|
||||
|
||||
def dictConfig(config: dict[str, Any]) -> None: ...
|
||||
def fileConfig(
|
||||
fname: Union[_Path, IO[str], RawConfigParser],
|
||||
defaults: Optional[dict[str, str]] = ...,
|
||||
disable_existing_loggers: bool = ...,
|
||||
) -> None: ...
|
||||
def listen(port: int = ..., verify: Optional[Callable[[bytes], Optional[bytes]]] = ...) -> Thread: ...
|
||||
def stopListening() -> None: ...
|
||||
|
||||
@@ -2,16 +2,15 @@ import datetime
|
||||
import ssl
|
||||
import sys
|
||||
from _typeshed import StrPath
|
||||
from collections.abc import Callable
|
||||
from logging import FileHandler, Handler, LogRecord
|
||||
from socket import SocketKind, SocketType
|
||||
from typing import Any, Callable, ClassVar, Dict, List, Optional, Tuple, Union
|
||||
from typing import Any, ClassVar, Optional, Union
|
||||
|
||||
if sys.version_info >= (3, 7):
|
||||
from queue import Queue, SimpleQueue
|
||||
elif sys.version_info >= (3,):
|
||||
from queue import Queue
|
||||
else:
|
||||
from Queue import Queue
|
||||
from queue import Queue
|
||||
|
||||
DEFAULT_TCP_LOGGING_PORT: int
|
||||
DEFAULT_UDP_LOGGING_PORT: int
|
||||
@@ -26,90 +25,45 @@ class WatchedFileHandler(FileHandler):
|
||||
def __init__(self, filename: StrPath, mode: str = ..., encoding: Optional[str] = ..., delay: bool = ...) -> None: ...
|
||||
def _statstream(self) -> None: ...
|
||||
|
||||
if sys.version_info >= (3,):
|
||||
class BaseRotatingHandler(FileHandler):
|
||||
terminator: str
|
||||
namer: Optional[Callable[[str], str]]
|
||||
rotator: Optional[Callable[[str, str], None]]
|
||||
def __init__(self, filename: StrPath, mode: str, encoding: Optional[str] = ..., delay: bool = ...) -> None: ...
|
||||
def rotation_filename(self, default_name: str) -> None: ...
|
||||
def rotate(self, source: str, dest: str) -> None: ...
|
||||
class BaseRotatingHandler(FileHandler):
|
||||
terminator: str
|
||||
namer: Optional[Callable[[str], str]]
|
||||
rotator: Optional[Callable[[str, str], None]]
|
||||
def __init__(self, filename: StrPath, mode: str, encoding: Optional[str] = ..., delay: bool = ...) -> None: ...
|
||||
def rotation_filename(self, default_name: str) -> None: ...
|
||||
def rotate(self, source: str, dest: str) -> None: ...
|
||||
|
||||
if sys.version_info >= (3,):
|
||||
class RotatingFileHandler(BaseRotatingHandler):
|
||||
def __init__(
|
||||
self,
|
||||
filename: StrPath,
|
||||
mode: str = ...,
|
||||
maxBytes: int = ...,
|
||||
backupCount: int = ...,
|
||||
encoding: Optional[str] = ...,
|
||||
delay: bool = ...,
|
||||
) -> None: ...
|
||||
def doRollover(self) -> None: ...
|
||||
class RotatingFileHandler(BaseRotatingHandler):
|
||||
def __init__(
|
||||
self,
|
||||
filename: StrPath,
|
||||
mode: str = ...,
|
||||
maxBytes: int = ...,
|
||||
backupCount: int = ...,
|
||||
encoding: Optional[str] = ...,
|
||||
delay: bool = ...,
|
||||
) -> None: ...
|
||||
def doRollover(self) -> None: ...
|
||||
|
||||
else:
|
||||
class RotatingFileHandler(Handler):
|
||||
def __init__(
|
||||
self,
|
||||
filename: str,
|
||||
mode: str = ...,
|
||||
maxBytes: int = ...,
|
||||
backupCount: int = ...,
|
||||
encoding: Optional[str] = ...,
|
||||
delay: bool = ...,
|
||||
) -> None: ...
|
||||
def doRollover(self) -> None: ...
|
||||
|
||||
if sys.version_info >= (3,):
|
||||
class TimedRotatingFileHandler(BaseRotatingHandler):
|
||||
if sys.version_info >= (3, 4):
|
||||
def __init__(
|
||||
self,
|
||||
filename: StrPath,
|
||||
when: str = ...,
|
||||
interval: int = ...,
|
||||
backupCount: int = ...,
|
||||
encoding: Optional[str] = ...,
|
||||
delay: bool = ...,
|
||||
utc: bool = ...,
|
||||
atTime: Optional[datetime.datetime] = ...,
|
||||
) -> None: ...
|
||||
else:
|
||||
def __init__(
|
||||
self,
|
||||
filename: str,
|
||||
when: str = ...,
|
||||
interval: int = ...,
|
||||
backupCount: int = ...,
|
||||
encoding: Optional[str] = ...,
|
||||
delay: bool = ...,
|
||||
utc: bool = ...,
|
||||
) -> None: ...
|
||||
def doRollover(self) -> None: ...
|
||||
|
||||
else:
|
||||
class TimedRotatingFileHandler(Handler):
|
||||
def __init__(
|
||||
self,
|
||||
filename: str,
|
||||
when: str = ...,
|
||||
interval: int = ...,
|
||||
backupCount: int = ...,
|
||||
encoding: Optional[str] = ...,
|
||||
delay: bool = ...,
|
||||
utc: bool = ...,
|
||||
) -> None: ...
|
||||
def doRollover(self) -> None: ...
|
||||
class TimedRotatingFileHandler(BaseRotatingHandler):
|
||||
def __init__(
|
||||
self,
|
||||
filename: StrPath,
|
||||
when: str = ...,
|
||||
interval: int = ...,
|
||||
backupCount: int = ...,
|
||||
encoding: Optional[str] = ...,
|
||||
delay: bool = ...,
|
||||
utc: bool = ...,
|
||||
atTime: Optional[datetime.datetime] = ...,
|
||||
) -> None: ...
|
||||
def doRollover(self) -> None: ...
|
||||
|
||||
class SocketHandler(Handler):
|
||||
retryStart: float
|
||||
retryFactor: float
|
||||
retryMax: float
|
||||
if sys.version_info >= (3, 4):
|
||||
def __init__(self, host: str, port: Optional[int]) -> None: ...
|
||||
else:
|
||||
def __init__(self, host: str, port: int) -> None: ...
|
||||
def __init__(self, host: str, port: Optional[int]) -> None: ...
|
||||
def makeSocket(self, timeout: float = ...) -> SocketType: ... # timeout is undocumented
|
||||
def makePickle(self, record: LogRecord) -> bytes: ...
|
||||
def send(self, s: bytes) -> None: ...
|
||||
@@ -157,14 +111,13 @@ class SysLogHandler(Handler):
|
||||
LOG_LOCAL7: int
|
||||
unixsocket: bool # undocumented
|
||||
socktype: SocketKind # undocumented
|
||||
if sys.version_info >= (3,):
|
||||
ident: str # undocumented
|
||||
ident: str # undocumented
|
||||
facility: int # undocumented
|
||||
priority_names: ClassVar[Dict[str, int]] # undocumented
|
||||
facility_names: ClassVar[Dict[str, int]] # undocumented
|
||||
priority_map: ClassVar[Dict[str, str]] # undocumented
|
||||
priority_names: ClassVar[dict[str, int]] # undocumented
|
||||
facility_names: ClassVar[dict[str, int]] # undocumented
|
||||
priority_map: ClassVar[dict[str, str]] # undocumented
|
||||
def __init__(
|
||||
self, address: Union[Tuple[str, int], str] = ..., facility: int = ..., socktype: Optional[SocketKind] = ...
|
||||
self, address: Union[tuple[str, int], str] = ..., facility: int = ..., socktype: Optional[SocketKind] = ...
|
||||
) -> None: ...
|
||||
def encodePriority(self, facility: Union[int, str], priority: Union[int, str]) -> int: ...
|
||||
def mapPriority(self, levelName: str) -> str: ...
|
||||
@@ -178,81 +131,58 @@ class NTEventLogHandler(Handler):
|
||||
|
||||
class SMTPHandler(Handler):
|
||||
# TODO `secure` can also be an empty tuple
|
||||
if sys.version_info >= (3,):
|
||||
def __init__(
|
||||
self,
|
||||
mailhost: Union[str, Tuple[str, int]],
|
||||
fromaddr: str,
|
||||
toaddrs: List[str],
|
||||
subject: str,
|
||||
credentials: Optional[Tuple[str, str]] = ...,
|
||||
secure: Union[Tuple[str], Tuple[str, str], None] = ...,
|
||||
timeout: float = ...,
|
||||
) -> None: ...
|
||||
else:
|
||||
def __init__(
|
||||
self,
|
||||
mailhost: Union[str, Tuple[str, int]],
|
||||
fromaddr: str,
|
||||
toaddrs: List[str],
|
||||
subject: str,
|
||||
credentials: Optional[Tuple[str, str]] = ...,
|
||||
secure: Union[Tuple[str], Tuple[str, str], None] = ...,
|
||||
) -> None: ...
|
||||
def __init__(
|
||||
self,
|
||||
mailhost: Union[str, tuple[str, int]],
|
||||
fromaddr: str,
|
||||
toaddrs: list[str],
|
||||
subject: str,
|
||||
credentials: Optional[tuple[str, str]] = ...,
|
||||
secure: Union[tuple[str], tuple[str, str], None] = ...,
|
||||
timeout: float = ...,
|
||||
) -> None: ...
|
||||
def getSubject(self, record: LogRecord) -> str: ...
|
||||
|
||||
class BufferingHandler(Handler):
|
||||
buffer: List[LogRecord]
|
||||
buffer: list[LogRecord]
|
||||
def __init__(self, capacity: int) -> None: ...
|
||||
def shouldFlush(self, record: LogRecord) -> bool: ...
|
||||
|
||||
class MemoryHandler(BufferingHandler):
|
||||
if sys.version_info >= (3, 6):
|
||||
def __init__(
|
||||
self, capacity: int, flushLevel: int = ..., target: Optional[Handler] = ..., flushOnClose: bool = ...
|
||||
) -> None: ...
|
||||
else:
|
||||
def __init__(self, capacity: int, flushLevel: int = ..., target: Optional[Handler] = ...) -> None: ...
|
||||
def __init__(
|
||||
self, capacity: int, flushLevel: int = ..., target: Optional[Handler] = ..., flushOnClose: bool = ...
|
||||
) -> None: ...
|
||||
def setTarget(self, target: Handler) -> None: ...
|
||||
|
||||
class HTTPHandler(Handler):
|
||||
if sys.version_info >= (3, 5):
|
||||
def __init__(
|
||||
self,
|
||||
host: str,
|
||||
url: str,
|
||||
method: str = ...,
|
||||
secure: bool = ...,
|
||||
credentials: Optional[tuple[str, str]] = ...,
|
||||
context: Optional[ssl.SSLContext] = ...,
|
||||
) -> None: ...
|
||||
def mapLogRecord(self, record: LogRecord) -> dict[str, Any]: ...
|
||||
|
||||
class QueueHandler(Handler):
|
||||
if sys.version_info >= (3, 7):
|
||||
def __init__(self, queue: Union[SimpleQueue[Any], Queue[Any]]) -> None: ...
|
||||
else:
|
||||
def __init__(self, queue: Queue[Any]) -> None: ...
|
||||
def prepare(self, record: LogRecord) -> Any: ...
|
||||
def enqueue(self, record: LogRecord) -> None: ...
|
||||
|
||||
class QueueListener:
|
||||
if sys.version_info >= (3, 7):
|
||||
def __init__(
|
||||
self,
|
||||
host: str,
|
||||
url: str,
|
||||
method: str = ...,
|
||||
secure: bool = ...,
|
||||
credentials: Optional[Tuple[str, str]] = ...,
|
||||
context: Optional[ssl.SSLContext] = ...,
|
||||
) -> None: ...
|
||||
elif sys.version_info >= (3,):
|
||||
def __init__(
|
||||
self, host: str, url: str, method: str = ..., secure: bool = ..., credentials: Optional[Tuple[str, str]] = ...
|
||||
self, queue: Union[SimpleQueue[Any], Queue[Any]], *handlers: Handler, respect_handler_level: bool = ...
|
||||
) -> None: ...
|
||||
else:
|
||||
def __init__(self, host: str, url: str, method: str = ...) -> None: ...
|
||||
def mapLogRecord(self, record: LogRecord) -> Dict[str, Any]: ...
|
||||
|
||||
if sys.version_info >= (3,):
|
||||
class QueueHandler(Handler):
|
||||
if sys.version_info >= (3, 7):
|
||||
def __init__(self, queue: Union[SimpleQueue[Any], Queue[Any]]) -> None: ...
|
||||
else:
|
||||
def __init__(self, queue: Queue[Any]) -> None: ...
|
||||
def prepare(self, record: LogRecord) -> Any: ...
|
||||
def enqueue(self, record: LogRecord) -> None: ...
|
||||
class QueueListener:
|
||||
if sys.version_info >= (3, 7):
|
||||
def __init__(
|
||||
self, queue: Union[SimpleQueue[Any], Queue[Any]], *handlers: Handler, respect_handler_level: bool = ...
|
||||
) -> None: ...
|
||||
elif sys.version_info >= (3, 5):
|
||||
def __init__(self, queue: Queue[Any], *handlers: Handler, respect_handler_level: bool = ...) -> None: ...
|
||||
else:
|
||||
def __init__(self, queue: Queue, *handlers: Handler) -> None: ...
|
||||
def dequeue(self, block: bool) -> LogRecord: ...
|
||||
def prepare(self, record: LogRecord) -> Any: ...
|
||||
def start(self) -> None: ...
|
||||
def stop(self) -> None: ...
|
||||
def enqueue_sentinel(self) -> None: ...
|
||||
def __init__(self, queue: Queue[Any], *handlers: Handler, respect_handler_level: bool = ...) -> None: ...
|
||||
def dequeue(self, block: bool) -> LogRecord: ...
|
||||
def prepare(self, record: LogRecord) -> Any: ...
|
||||
def start(self) -> None: ...
|
||||
def stop(self) -> None: ...
|
||||
def enqueue_sentinel(self) -> None: ...
|
||||
|
||||
Reference in New Issue
Block a user