layermap 0.1.0

package/analyzers/project-map-python/typeshed/stdlib/multiprocessing/reduction.pyi

@@ -0,0 +1,95 @@
+import pickle
+import sys
+from _pickle import _BufferCallback, _ReducedType
+from _typeshed import HasFileno, SupportsWrite, Unused
+from abc import ABCMeta
+from builtins import type as Type  # alias to avoid name clash
+from collections.abc import Callable
+from copyreg import _DispatchTableType
+from multiprocessing import connection, popen_forkserver, popen_spawn_posix, resource_sharer
+from socket import socket
+from typing import Any, Final
+
+if sys.platform == "win32":
+    __all__ = ["send_handle", "recv_handle", "ForkingPickler", "register", "dump", "DupHandle", "duplicate", "steal_handle"]
+else:
+    __all__ = ["send_handle", "recv_handle", "ForkingPickler", "register", "dump", "DupFd", "sendfds", "recvfds"]
+
+HAVE_SEND_HANDLE: Final[bool]
+
+class ForkingPickler(pickle.Pickler):
+    dispatch_table: _DispatchTableType
+    def __init__(
+        self,
+        file: SupportsWrite[bytes],
+        protocol: int | None = None,
+        fix_imports: bool = True,
+        buffer_callback: _BufferCallback = None,
+        /,
+    ) -> None: ...
+    @classmethod
+    def register(cls, type: Type, reduce: Callable[[Any], _ReducedType]) -> None: ...
+    @classmethod
+    def dumps(cls, obj: Any, protocol: int | None = None) -> memoryview: ...
+    loads = pickle.loads
+
+register = ForkingPickler.register
+
+def dump(obj: Any, file: SupportsWrite[bytes], protocol: int | None = None) -> None: ...
+
+if sys.platform == "win32":
+    def duplicate(
+        handle: int, target_process: int | None = None, inheritable: bool = False, *, source_process: int | None = None
+    ) -> int: ...
+    def steal_handle(source_pid: int, handle: int) -> int: ...
+    def send_handle(conn: connection.PipeConnection[DupHandle, Any], handle: int, destination_pid: int) -> None: ...
+    def recv_handle(conn: connection.PipeConnection[Any, DupHandle]) -> int: ...
+
+    class DupHandle:
+        def __init__(self, handle: int, access: int, pid: int | None = None) -> None: ...
+        def detach(self) -> int: ...
+
+else:
+    if sys.version_info < (3, 14):
+        ACKNOWLEDGE: Final[bool]
+
+    def recvfds(sock: socket, size: int) -> list[int]: ...
+    def send_handle(conn: HasFileno, handle: int, destination_pid: Unused) -> None: ...
+    def recv_handle(conn: HasFileno) -> int: ...
+    def sendfds(sock: socket, fds: list[int]) -> None: ...
+    def DupFd(fd: int) -> popen_forkserver._DupFd | popen_spawn_posix._DupFd | resource_sharer.DupFd: ...
+
+# These aliases are to work around pyright complaints.
+# Pyright doesn't like it when a class object is defined as an alias
+# of a global object with the same name.
+_ForkingPickler = ForkingPickler
+_register = register
+_dump = dump
+_send_handle = send_handle
+_recv_handle = recv_handle
+
+if sys.platform == "win32":
+    _steal_handle = steal_handle
+    _duplicate = duplicate
+    _DupHandle = DupHandle
+else:
+    _sendfds = sendfds
+    _recvfds = recvfds
+    _DupFd = DupFd
+
+class AbstractReducer(metaclass=ABCMeta):
+    ForkingPickler = _ForkingPickler
+    register = _register
+    dump = _dump
+    send_handle = _send_handle
+    recv_handle = _recv_handle
+    if sys.platform == "win32":
+        steal_handle = _steal_handle
+        duplicate = _duplicate
+        DupHandle = _DupHandle
+    else:
+        sendfds = _sendfds
+        recvfds = _recvfds
+        DupFd = _DupFd
+
+    def __init__(self, *args: Unused) -> None: ...

package/analyzers/project-map-python/typeshed/stdlib/multiprocessing/resource_sharer.pyi

@@ -0,0 +1,20 @@
+import sys
+from socket import socket
+
+__all__ = ["stop"]
+
+if sys.platform == "win32":
+    __all__ += ["DupSocket"]
+
+    class DupSocket:
+        def __init__(self, sock: socket) -> None: ...
+        def detach(self) -> socket: ...
+
+else:
+    __all__ += ["DupFd"]
+
+    class DupFd:
+        def __init__(self, fd: int) -> None: ...
+        def detach(self) -> int: ...
+
+def stop(timeout: float | None = None) -> None: ...

package/analyzers/project-map-python/typeshed/stdlib/multiprocessing/resource_tracker.pyi

@@ -0,0 +1,21 @@
+import sys
+from _typeshed import FileDescriptorOrPath
+from collections.abc import Sized
+
+__all__ = ["ensure_running", "register", "unregister"]
+
+class ResourceTracker:
+    def getfd(self) -> int | None: ...
+    def ensure_running(self) -> None: ...
+    def register(self, name: Sized, rtype: str) -> None: ...
+    def unregister(self, name: Sized, rtype: str) -> None: ...
+    if sys.version_info >= (3, 12):
+        def __del__(self) -> None: ...
+
+_resource_tracker: ResourceTracker
+ensure_running = _resource_tracker.ensure_running
+register = _resource_tracker.register
+unregister = _resource_tracker.unregister
+getfd = _resource_tracker.getfd
+
+def main(fd: FileDescriptorOrPath) -> None: ...

package/analyzers/project-map-python/typeshed/stdlib/multiprocessing/shared_memory.pyi

@@ -0,0 +1,43 @@
+import sys
+from collections.abc import Iterable
+from types import GenericAlias
+from typing import Any, Generic, TypeVar, overload
+from typing_extensions import Self
+
+__all__ = ["SharedMemory", "ShareableList"]
+
+_SLT = TypeVar("_SLT", int, float, bool, str, bytes, None)
+
+class SharedMemory:
+    if sys.version_info >= (3, 13):
+        def __init__(self, name: str | None = None, create: bool = False, size: int = 0, *, track: bool = True) -> None: ...
+    else:
+        def __init__(self, name: str | None = None, create: bool = False, size: int = 0) -> None: ...
+
+    @property
+    def buf(self) -> memoryview | None: ...
+    @property
+    def name(self) -> str: ...
+    @property
+    def size(self) -> int: ...
+    def close(self) -> None: ...
+    def unlink(self) -> None: ...
+    def __del__(self) -> None: ...
+
+class ShareableList(Generic[_SLT]):
+    shm: SharedMemory
+
+    @overload
+    def __init__(self, sequence: None = None, *, name: str | None = None) -> None: ...
+    @overload
+    def __init__(self, sequence: Iterable[_SLT], *, name: str | None = None) -> None: ...
+
+    def __getitem__(self, position: int) -> _SLT: ...
+    def __setitem__(self, position: int, value: _SLT) -> None: ...
+    def __reduce__(self) -> tuple[Self, tuple[_SLT, ...]]: ...
+    def __len__(self) -> int: ...
+    @property
+    def format(self) -> str: ...
+    def count(self, value: _SLT) -> int: ...
+    def index(self, value: _SLT) -> int: ...
+    def __class_getitem__(cls, item: Any, /) -> GenericAlias: ...

package/analyzers/project-map-python/typeshed/stdlib/multiprocessing/sharedctypes.pyi

@@ -0,0 +1,140 @@
+import ctypes
+from _ctypes import _CData
+from collections.abc import Callable, Iterable, Sequence
+from ctypes import _SimpleCData, c_char
+from multiprocessing.context import BaseContext
+from multiprocessing.synchronize import _LockLike
+from types import TracebackType
+from typing import Any, Generic, Literal, Protocol, SupportsIndex, TypeVar, overload, type_check_only
+
+__all__ = ["RawValue", "RawArray", "Value", "Array", "copy", "synchronized"]
+
+_T = TypeVar("_T")
+_CT = TypeVar("_CT", bound=_CData)
+
+@overload
+def RawValue(typecode_or_type: type[_CT], *args: Any) -> _CT: ...
+@overload
+def RawValue(typecode_or_type: str, *args: Any) -> Any: ...
+
+@overload
+def RawArray(typecode_or_type: type[_CT], size_or_initializer: int | Sequence[Any]) -> ctypes.Array[_CT]: ...
+@overload
+def RawArray(typecode_or_type: str, size_or_initializer: int | Sequence[Any]) -> Any: ...
+
+@overload
+def Value(typecode_or_type: type[_CT], *args: Any, lock: Literal[False], ctx: BaseContext | None = None) -> _CT: ...
+@overload
+def Value(
+    typecode_or_type: type[_CT], *args: Any, lock: Literal[True] | _LockLike = True, ctx: BaseContext | None = None
+) -> SynchronizedBase[_CT]: ...
+@overload
+def Value(
+    typecode_or_type: str, *args: Any, lock: Literal[True] | _LockLike = True, ctx: BaseContext | None = None
+) -> SynchronizedBase[Any]: ...
+@overload
+def Value(
+    typecode_or_type: str | type[_CData], *args: Any, lock: bool | _LockLike = True, ctx: BaseContext | None = None
+) -> Any: ...
+
+@overload
+def Array(
+    typecode_or_type: type[_CT], size_or_initializer: int | Sequence[Any], *, lock: Literal[False], ctx: BaseContext | None = None
+) -> _CT: ...
+@overload
+def Array(
+    typecode_or_type: type[c_char],
+    size_or_initializer: int | Sequence[Any],
+    *,
+    lock: Literal[True] | _LockLike = True,
+    ctx: BaseContext | None = None,
+) -> SynchronizedString: ...
+@overload
+def Array(
+    typecode_or_type: type[_SimpleCData[_T]],
+    size_or_initializer: int | Sequence[Any],
+    *,
+    lock: Literal[True] | _LockLike = True,
+    ctx: BaseContext | None = None,
+) -> SynchronizedArray[_T]: ...
+@overload
+def Array(
+    typecode_or_type: str,
+    size_or_initializer: int | Sequence[Any],
+    *,
+    lock: Literal[True] | _LockLike = True,
+    ctx: BaseContext | None = None,
+) -> SynchronizedArray[Any]: ...
+@overload
+def Array(
+    typecode_or_type: str | type[_CData],
+    size_or_initializer: int | Sequence[Any],
+    *,
+    lock: bool | _LockLike = True,
+    ctx: BaseContext | None = None,
+) -> Any: ...
+
+def copy(obj: _CT) -> _CT: ...
+
+@overload
+def synchronized(obj: _SimpleCData[_T], lock: _LockLike | None = None, ctx: Any | None = None) -> Synchronized[_T]: ...
+@overload
+def synchronized(obj: ctypes.Array[c_char], lock: _LockLike | None = None, ctx: Any | None = None) -> SynchronizedString: ...
+@overload
+def synchronized(
+    obj: ctypes.Array[_SimpleCData[_T]], lock: _LockLike | None = None, ctx: Any | None = None
+) -> SynchronizedArray[_T]: ...
+@overload
+def synchronized(obj: _CT, lock: _LockLike | None = None, ctx: Any | None = None) -> SynchronizedBase[_CT]: ...
+
+@type_check_only
+class _AcquireFunc(Protocol):
+    def __call__(self, block: bool = ..., timeout: float | None = ..., /) -> bool: ...
+
+class SynchronizedBase(Generic[_CT]):
+    acquire: _AcquireFunc
+    release: Callable[[], None]
+    def __init__(self, obj: Any, lock: _LockLike | None = None, ctx: Any | None = None) -> None: ...
+    def __reduce__(self) -> tuple[Callable[[Any, _LockLike], SynchronizedBase[Any]], tuple[Any, _LockLike]]: ...
+    def get_obj(self) -> _CT: ...
+    def get_lock(self) -> _LockLike: ...
+    def __enter__(self) -> bool: ...
+    def __exit__(
+        self, exc_type: type[BaseException] | None, exc_val: BaseException | None, exc_tb: TracebackType | None, /
+    ) -> None: ...
+
+class Synchronized(SynchronizedBase[_SimpleCData[_T]], Generic[_T]):
+    value: _T
+
+class SynchronizedArray(SynchronizedBase[ctypes.Array[_SimpleCData[_T]]], Generic[_T]):
+    def __len__(self) -> int: ...
+
+    @overload
+    def __getitem__(self, i: slice[SupportsIndex | None]) -> list[_T]: ...
+    @overload
+    def __getitem__(self, i: SupportsIndex) -> _T: ...
+
+    @overload
+    def __setitem__(self, i: slice[SupportsIndex | None], value: Iterable[_T]) -> None: ...
+    @overload
+    def __setitem__(self, i: SupportsIndex, value: _T) -> None: ...
+
+    def __getslice__(self, start: SupportsIndex, stop: SupportsIndex) -> list[_T]: ...
+    def __setslice__(self, start: SupportsIndex, stop: SupportsIndex, values: Iterable[_T]) -> None: ...
+
+class SynchronizedString(SynchronizedArray[bytes]):
+    @overload  # type: ignore[override]
+    def __getitem__(self, i: slice[SupportsIndex | None]) -> bytes: ...
+    @overload
+    def __getitem__(self, i: SupportsIndex) -> bytes: ...
+
+    @overload  # type: ignore[override]
+    def __setitem__(self, i: slice[SupportsIndex | None], value: bytes) -> None: ...
+    @overload
+    def __setitem__(self, i: SupportsIndex, value: bytes) -> None: ...
+
+    def __getslice__(self, start: SupportsIndex, stop: SupportsIndex) -> bytes: ...  # type: ignore[override]
+    def __setslice__(self, start: SupportsIndex, stop: SupportsIndex, values: bytes) -> None: ...  # type: ignore[override]
+
+    value: bytes
+    raw: bytes

package/analyzers/project-map-python/typeshed/stdlib/multiprocessing/spawn.pyi

@@ -0,0 +1,32 @@
+from collections.abc import Mapping, Sequence
+from types import ModuleType
+from typing import Any, Final
+
+__all__ = [
+    "_main",
+    "freeze_support",
+    "set_executable",
+    "get_executable",
+    "get_preparation_data",
+    "get_command_line",
+    "import_main_path",
+]
+
+WINEXE: Final[bool]
+WINSERVICE: Final[bool]
+
+def set_executable(exe: str) -> None: ...
+def get_executable() -> str: ...
+def is_forking(argv: Sequence[str]) -> bool: ...
+def freeze_support() -> None: ...
+def get_command_line(**kwds: Any) -> list[str]: ...
+def spawn_main(pipe_handle: int, parent_pid: int | None = None, tracker_fd: int | None = None) -> None: ...
+
+# undocumented
+def _main(fd: int, parent_sentinel: int) -> int: ...
+def get_preparation_data(name: str) -> dict[str, Any]: ...
+
+old_main_modules: list[ModuleType]
+
+def prepare(data: Mapping[str, Any]) -> None: ...
+def import_main_path(main_path: str) -> None: ...

package/analyzers/project-map-python/typeshed/stdlib/multiprocessing/synchronize.pyi

@@ -0,0 +1,63 @@
+import sys
+import threading
+from collections.abc import Callable
+from multiprocessing.context import BaseContext
+from types import TracebackType
+from typing import TypeAlias
+
+__all__ = ["Lock", "RLock", "Semaphore", "BoundedSemaphore", "Condition", "Event"]
+
+_LockLike: TypeAlias = Lock | RLock
+
+class Barrier(threading.Barrier):
+    def __init__(
+        self, parties: int, action: Callable[[], object] | None = None, timeout: float | None = None, *, ctx: BaseContext
+    ) -> None: ...
+
+class Condition:
+    def __init__(self, lock: _LockLike | None = None, *, ctx: BaseContext) -> None: ...
+    def notify(self, n: int = 1) -> None: ...
+    def notify_all(self) -> None: ...
+    def wait(self, timeout: float | None = None) -> bool: ...
+    def wait_for(self, predicate: Callable[[], bool], timeout: float | None = None) -> bool: ...
+    def __enter__(self) -> bool: ...
+    def __exit__(
+        self, exc_type: type[BaseException] | None, exc_val: BaseException | None, exc_tb: TracebackType | None, /
+    ) -> None: ...
+    # These methods are copied from the lock passed to the constructor, or an
+    # instance of ctx.RLock() if lock was None.
+    def acquire(self, block: bool = True, timeout: float | None = None) -> bool: ...
+    def release(self) -> None: ...
+
+class Event:
+    def __init__(self, *, ctx: BaseContext) -> None: ...
+    def is_set(self) -> bool: ...
+    def set(self) -> None: ...
+    def clear(self) -> None: ...
+    def wait(self, timeout: float | None = None) -> bool: ...
+
+# Not part of public API
+class SemLock:
+    def __init__(self, kind: int, value: int, maxvalue: int, *, ctx: BaseContext | None) -> None: ...
+    def __enter__(self) -> bool: ...
+    def __exit__(
+        self, exc_type: type[BaseException] | None, exc_val: BaseException | None, exc_tb: TracebackType | None, /
+    ) -> None: ...
+    # These methods are copied from the wrapped _multiprocessing.SemLock object
+    def acquire(self, block: bool = True, timeout: float | None = None) -> bool: ...
+    def release(self) -> None: ...
+    if sys.version_info >= (3, 14):
+        def locked(self) -> bool: ...
+
+class Lock(SemLock):
+    def __init__(self, *, ctx: BaseContext) -> None: ...
+
+class RLock(SemLock):
+    def __init__(self, *, ctx: BaseContext) -> None: ...
+
+class Semaphore(SemLock):
+    def __init__(self, value: int = 1, *, ctx: BaseContext) -> None: ...
+    def get_value(self) -> int: ...
+
+class BoundedSemaphore(Semaphore):
+    def __init__(self, value: int = 1, *, ctx: BaseContext) -> None: ...

package/analyzers/project-map-python/typeshed/stdlib/multiprocessing/util.pyi

@@ -0,0 +1,109 @@
+import sys
+import threading
+from _typeshed import ConvertibleToInt, Incomplete, Unused
+from collections.abc import Callable, Iterable, Mapping, MutableMapping, Sequence
+from logging import Logger, _Level as _LoggingLevel
+from typing import Any, Final, Generic, TypeVar, overload
+
+__all__ = [
+    "sub_debug",
+    "debug",
+    "info",
+    "sub_warning",
+    "get_logger",
+    "log_to_stderr",
+    "get_temp_dir",
+    "register_after_fork",
+    "is_exiting",
+    "Finalize",
+    "ForkAwareThreadLock",
+    "ForkAwareLocal",
+    "close_all_fds_except",
+    "SUBDEBUG",
+    "SUBWARNING",
+]
+
+if sys.version_info >= (3, 14):
+    __all__ += ["warn"]
+
+_T = TypeVar("_T")
+_R_co = TypeVar("_R_co", default=Any, covariant=True)
+
+NOTSET: Final = 0
+SUBDEBUG: Final = 5
+DEBUG: Final = 10
+INFO: Final = 20
+SUBWARNING: Final = 25
+if sys.version_info >= (3, 14):
+    WARNING: Final = 30
+
+LOGGER_NAME: Final[str]
+DEFAULT_LOGGING_FORMAT: Final[str]
+
+def sub_debug(msg: object, *args: object) -> None: ...
+def debug(msg: object, *args: object) -> None: ...
+def info(msg: object, *args: object) -> None: ...
+
+if sys.version_info >= (3, 14):
+    def warn(msg: object, *args: object) -> None: ...
+
+def sub_warning(msg: object, *args: object) -> None: ...
+def get_logger() -> Logger: ...
+def log_to_stderr(level: _LoggingLevel | None = None) -> Logger: ...
+def is_abstract_socket_namespace(address: str | bytes | None) -> bool: ...
+
+abstract_sockets_supported: Final[bool]
+
+def get_temp_dir() -> str: ...
+def register_after_fork(obj: _T, func: Callable[[_T], object]) -> None: ...
+
+class Finalize(Generic[_R_co]):
+    # "args" and "kwargs" are passed as arguments to "callback".
+    @overload
+    def __init__(
+        self,
+        obj: None,
+        callback: Callable[..., _R_co],
+        *,
+        args: Sequence[Any] = (),
+        kwargs: Mapping[str, Any] | None = None,
+        exitpriority: int,
+    ) -> None: ...
+    @overload
+    def __init__(
+        self, obj: None, callback: Callable[..., _R_co], args: Sequence[Any], kwargs: Mapping[str, Any] | None, exitpriority: int
+    ) -> None: ...
+    @overload
+    def __init__(
+        self,
+        obj: Any,
+        callback: Callable[..., _R_co],
+        args: Sequence[Any] = (),
+        kwargs: Mapping[str, Any] | None = None,
+        exitpriority: int | None = None,
+    ) -> None: ...
+
+    def __call__(
+        self,
+        wr: Unused = None,
+        _finalizer_registry: MutableMapping[Incomplete, Incomplete] = {},
+        sub_debug: Callable[..., object] = ...,
+        getpid: Callable[[], int] = ...,
+    ) -> _R_co: ...
+    def cancel(self) -> None: ...
+    def still_active(self) -> bool: ...
+
+def is_exiting() -> bool: ...
+
+class ForkAwareThreadLock:
+    acquire: Callable[[bool, float], bool]
+    release: Callable[[], None]
+    def __enter__(self) -> bool: ...
+    def __exit__(self, *args: Unused) -> None: ...
+
+class ForkAwareLocal(threading.local): ...
+
+MAXFD: Final[int]
+
+def close_all_fds_except(fds: Iterable[int]) -> None: ...
+def spawnv_passfds(path: bytes, args: Sequence[ConvertibleToInt], passfds: Sequence[int]) -> int: ...

package/analyzers/project-map-python/typeshed/stdlib/netrc.pyi

@@ -0,0 +1,23 @@
+import sys
+from _typeshed import StrOrBytesPath
+from typing import TypeAlias
+
+__all__ = ["netrc", "NetrcParseError"]
+
+class NetrcParseError(Exception):
+    filename: str | None
+    lineno: int | None
+    msg: str
+    def __init__(self, msg: str, filename: StrOrBytesPath | None = None, lineno: int | None = None) -> None: ...
+
+# (login, account, password) tuple
+if sys.version_info >= (3, 11):
+    _NetrcTuple: TypeAlias = tuple[str, str, str]
+else:
+    _NetrcTuple: TypeAlias = tuple[str, str | None, str | None]
+
+class netrc:
+    hosts: dict[str, _NetrcTuple]
+    macros: dict[str, list[str]]
+    def __init__(self, file: StrOrBytesPath | None = None) -> None: ...
+    def authenticators(self, host: str) -> _NetrcTuple | None: ...

package/analyzers/project-map-python/typeshed/stdlib/nis.pyi

@@ -0,0 +1,9 @@
+import sys
+
+if sys.platform != "win32":
+    def cat(map: str, domain: str = ...) -> dict[str, str]: ...
+    def get_default_domain() -> str: ...
+    def maps(domain: str = ...) -> list[str]: ...
+    def match(key: str, map: str, domain: str = ...) -> str: ...
+
+    class error(Exception): ...

package/analyzers/project-map-python/typeshed/stdlib/nntplib.pyi

@@ -0,0 +1,120 @@
+import datetime
+import socket
+import ssl
+from _typeshed import Unused
+from builtins import list as _list  # conflicts with a method named "list"
+from collections.abc import Iterable
+from typing import IO, Any, Final, NamedTuple, TypeAlias
+from typing_extensions import Self
+
+__all__ = [
+    "NNTP",
+    "NNTPError",
+    "NNTPReplyError",
+    "NNTPTemporaryError",
+    "NNTPPermanentError",
+    "NNTPProtocolError",
+    "NNTPDataError",
+    "decode_header",
+    "NNTP_SSL",
+]
+
+_File: TypeAlias = IO[bytes] | bytes | str | None
+
+class NNTPError(Exception):
+    response: str
+
+class NNTPReplyError(NNTPError): ...
+class NNTPTemporaryError(NNTPError): ...
+class NNTPPermanentError(NNTPError): ...
+class NNTPProtocolError(NNTPError): ...
+class NNTPDataError(NNTPError): ...
+
+NNTP_PORT: Final = 119
+NNTP_SSL_PORT: Final = 563
+
+class GroupInfo(NamedTuple):
+    group: str
+    last: str
+    first: str
+    flag: str
+
+class ArticleInfo(NamedTuple):
+    number: int
+    message_id: str
+    lines: list[bytes]
+
+def decode_header(header_str: str) -> str: ...
+
+class NNTP:
+    encoding: str
+    errors: str
+
+    host: str
+    port: int
+    sock: socket.socket
+    file: IO[bytes]
+    debugging: int
+    welcome: str
+    readermode_afterauth: bool
+    tls_on: bool
+    authenticated: bool
+    nntp_implementation: str
+    nntp_version: int
+    def __init__(
+        self,
+        host: str,
+        port: int = 119,
+        user: str | None = None,
+        password: str | None = None,
+        readermode: bool | None = None,
+        usenetrc: bool = False,
+        timeout: float = ...,
+    ) -> None: ...
+    def __enter__(self) -> Self: ...
+    def __exit__(self, *args: Unused) -> None: ...
+    def getwelcome(self) -> str: ...
+    def getcapabilities(self) -> dict[str, _list[str]]: ...
+    def set_debuglevel(self, level: int) -> None: ...
+    def debug(self, level: int) -> None: ...
+    def capabilities(self) -> tuple[str, dict[str, _list[str]]]: ...
+    def newgroups(self, date: datetime.date | datetime.datetime, *, file: _File = None) -> tuple[str, _list[str]]: ...
+    def newnews(self, group: str, date: datetime.date | datetime.datetime, *, file: _File = None) -> tuple[str, _list[str]]: ...
+    def list(self, group_pattern: str | None = None, *, file: _File = None) -> tuple[str, _list[str]]: ...
+    def description(self, group: str) -> str: ...
+    def descriptions(self, group_pattern: str) -> tuple[str, dict[str, str]]: ...
+    def group(self, name: str) -> tuple[str, int, int, int, str]: ...
+    def help(self, *, file: _File = None) -> tuple[str, _list[str]]: ...
+    def stat(self, message_spec: Any = None) -> tuple[str, int, str]: ...
+    def next(self) -> tuple[str, int, str]: ...
+    def last(self) -> tuple[str, int, str]: ...
+    def head(self, message_spec: Any = None, *, file: _File = None) -> tuple[str, ArticleInfo]: ...
+    def body(self, message_spec: Any = None, *, file: _File = None) -> tuple[str, ArticleInfo]: ...
+    def article(self, message_spec: Any = None, *, file: _File = None) -> tuple[str, ArticleInfo]: ...
+    def slave(self) -> str: ...
+    def xhdr(self, hdr: str, str: Any, *, file: _File = None) -> tuple[str, _list[str]]: ...
+    def xover(self, start: int, end: int, *, file: _File = None) -> tuple[str, _list[tuple[int, dict[str, str]]]]: ...
+    def over(
+        self, message_spec: None | str | _list[Any] | tuple[Any, ...], *, file: _File = None
+    ) -> tuple[str, _list[tuple[int, dict[str, str]]]]: ...
+    def date(self) -> tuple[str, datetime.datetime]: ...
+    def post(self, data: bytes | Iterable[bytes]) -> str: ...
+    def ihave(self, message_id: Any, data: bytes | Iterable[bytes]) -> str: ...
+    def quit(self) -> str: ...
+    def login(self, user: str | None = None, password: str | None = None, usenetrc: bool = True) -> None: ...
+    def starttls(self, context: ssl.SSLContext | None = None) -> None: ...
+
+class NNTP_SSL(NNTP):
+    ssl_context: ssl.SSLContext | None
+    sock: ssl.SSLSocket
+    def __init__(
+        self,
+        host: str,
+        port: int = 563,
+        user: str | None = None,
+        password: str | None = None,
+        ssl_context: ssl.SSLContext | None = None,
+        readermode: bool | None = None,
+        usenetrc: bool = False,
+        timeout: float = ...,
+    ) -> None: ...