basedpyright 1.1.389 → 1.1.392

package/dist/typeshed-fallback/stdlib/socketserver.pyi

@@ -1,169 +1,169 @@
-import sys
-import types
-from _socket import _Address, _RetAddress
-from _typeshed import ReadableBuffer
-from collections.abc import Callable
-from io import BufferedIOBase
-from socket import socket as _socket
-from typing import Any, ClassVar
-from typing_extensions import Self, TypeAlias
-
-__all__ = [
-    "BaseServer",
-    "TCPServer",
-    "UDPServer",
-    "ThreadingUDPServer",
-    "ThreadingTCPServer",
-    "BaseRequestHandler",
-    "StreamRequestHandler",
-    "DatagramRequestHandler",
-    "ThreadingMixIn",
-]
-if sys.platform != "win32":
-    __all__ += [
-        "ForkingMixIn",
-        "ForkingTCPServer",
-        "ForkingUDPServer",
-        "ThreadingUnixDatagramServer",
-        "ThreadingUnixStreamServer",
-        "UnixDatagramServer",
-        "UnixStreamServer",
-    ]
-    if sys.version_info >= (3, 12):
-        __all__ += ["ForkingUnixStreamServer", "ForkingUnixDatagramServer"]
-
-_RequestType: TypeAlias = _socket | tuple[bytes, _socket]
-_AfUnixAddress: TypeAlias = str | ReadableBuffer  # address acceptable for an AF_UNIX socket
-_AfInetAddress: TypeAlias = tuple[str | bytes | bytearray, int]  # address acceptable for an AF_INET socket
-
-# This can possibly be generic at some point:
-class BaseServer:
-    address_family: int
-    server_address: _Address
-    socket: _socket
-    allow_reuse_address: bool
-    request_queue_size: int
-    socket_type: int
-    timeout: float | None
-    RequestHandlerClass: Callable[[Any, _RetAddress, Self], BaseRequestHandler]
-    def __init__(
-        self, server_address: _Address, RequestHandlerClass: Callable[[Any, _RetAddress, Self], BaseRequestHandler]
-    ) -> None: ...
-    def fileno(self) -> int: ...
-    def handle_request(self) -> None: ...
-    def serve_forever(self, poll_interval: float = 0.5) -> None: ...
-    def shutdown(self) -> None: ...
-    def server_close(self) -> None: ...
-    def finish_request(self, request: _RequestType, client_address: _RetAddress) -> None: ...
-    def get_request(self) -> tuple[Any, Any]: ...
-    def handle_error(self, request: _RequestType, client_address: _RetAddress) -> None: ...
-    def handle_timeout(self) -> None: ...
-    def process_request(self, request: _RequestType, client_address: _RetAddress) -> None: ...
-    def server_activate(self) -> None: ...
-    def server_bind(self) -> None: ...
-    def verify_request(self, request: _RequestType, client_address: _RetAddress) -> bool: ...
-    def __enter__(self) -> Self: ...
-    def __exit__(
-        self, exc_type: type[BaseException] | None, exc_val: BaseException | None, exc_tb: types.TracebackType | None
-    ) -> None: ...
-    def service_actions(self) -> None: ...
-    def shutdown_request(self, request: _RequestType) -> None: ...  # undocumented
-    def close_request(self, request: _RequestType) -> None: ...  # undocumented
-
-class TCPServer(BaseServer):
-    if sys.version_info >= (3, 11):
-        allow_reuse_port: bool
-    server_address: _AfInetAddress
-    def __init__(
-        self,
-        server_address: _AfInetAddress,
-        RequestHandlerClass: Callable[[Any, _RetAddress, Self], BaseRequestHandler],
-        bind_and_activate: bool = True,
-    ) -> None: ...
-    def get_request(self) -> tuple[_socket, _RetAddress]: ...
-
-class UDPServer(TCPServer):
-    max_packet_size: ClassVar[int]
-    def get_request(self) -> tuple[tuple[bytes, _socket], _RetAddress]: ...  # type: ignore[override]
-
-if sys.platform != "win32":
-    class UnixStreamServer(TCPServer):
-        server_address: _AfUnixAddress  # type: ignore[assignment]
-        def __init__(
-            self,
-            server_address: _AfUnixAddress,
-            RequestHandlerClass: Callable[[Any, _RetAddress, Self], BaseRequestHandler],
-            bind_and_activate: bool = True,
-        ) -> None: ...
-
-    class UnixDatagramServer(UDPServer):
-        server_address: _AfUnixAddress  # type: ignore[assignment]
-        def __init__(
-            self,
-            server_address: _AfUnixAddress,
-            RequestHandlerClass: Callable[[Any, _RetAddress, Self], BaseRequestHandler],
-            bind_and_activate: bool = True,
-        ) -> None: ...
-
-if sys.platform != "win32":
-    class ForkingMixIn:
-        timeout: float | None  # undocumented
-        active_children: set[int] | None  # undocumented
-        max_children: int  # undocumented
-        block_on_close: bool
-        def collect_children(self, *, blocking: bool = False) -> None: ...  # undocumented
-        def handle_timeout(self) -> None: ...  # undocumented
-        def service_actions(self) -> None: ...  # undocumented
-        def process_request(self, request: _RequestType, client_address: _RetAddress) -> None: ...
-        def server_close(self) -> None: ...
-
-class ThreadingMixIn:
-    daemon_threads: bool
-    block_on_close: bool
-    def process_request_thread(self, request: _RequestType, client_address: _RetAddress) -> None: ...  # undocumented
-    def process_request(self, request: _RequestType, client_address: _RetAddress) -> None: ...
-    def server_close(self) -> None: ...
-
-if sys.platform != "win32":
-    class ForkingTCPServer(ForkingMixIn, TCPServer): ...
-    class ForkingUDPServer(ForkingMixIn, UDPServer): ...
-    if sys.version_info >= (3, 12):
-        class ForkingUnixStreamServer(ForkingMixIn, UnixStreamServer): ...
-        class ForkingUnixDatagramServer(ForkingMixIn, UnixDatagramServer): ...
-
-class ThreadingTCPServer(ThreadingMixIn, TCPServer): ...
-class ThreadingUDPServer(ThreadingMixIn, UDPServer): ...
-
-if sys.platform != "win32":
-    class ThreadingUnixStreamServer(ThreadingMixIn, UnixStreamServer): ...
-    class ThreadingUnixDatagramServer(ThreadingMixIn, UnixDatagramServer): ...
-
-class BaseRequestHandler:
-    # `request` is technically of type _RequestType,
-    # but there are some concerns that having a union here would cause
-    # too much inconvenience to people using it (see
-    # https://github.com/python/typeshed/pull/384#issuecomment-234649696)
-    #
-    # Note also that _RetAddress is also just an alias for `Any`
-    request: Any
-    client_address: _RetAddress
-    server: BaseServer
-    def __init__(self, request: _RequestType, client_address: _RetAddress, server: BaseServer) -> None: ...
-    def setup(self) -> None: ...
-    def handle(self) -> None: ...
-    def finish(self) -> None: ...
-
-class StreamRequestHandler(BaseRequestHandler):
-    rbufsize: ClassVar[int]  # undocumented
-    wbufsize: ClassVar[int]  # undocumented
-    timeout: ClassVar[float | None]  # undocumented
-    disable_nagle_algorithm: ClassVar[bool]  # undocumented
-    connection: Any  # undocumented
-    rfile: BufferedIOBase
-    wfile: BufferedIOBase
-
-class DatagramRequestHandler(BaseRequestHandler):
-    packet: bytes  # undocumented
-    socket: _socket  # undocumented
-    rfile: BufferedIOBase
-    wfile: BufferedIOBase
+import sys
+import types
+from _socket import _Address, _RetAddress
+from _typeshed import ReadableBuffer
+from collections.abc import Callable
+from io import BufferedIOBase
+from socket import socket as _socket
+from typing import Any, ClassVar
+from typing_extensions import Self, TypeAlias
+
+__all__ = [
+    "BaseServer",
+    "TCPServer",
+    "UDPServer",
+    "ThreadingUDPServer",
+    "ThreadingTCPServer",
+    "BaseRequestHandler",
+    "StreamRequestHandler",
+    "DatagramRequestHandler",
+    "ThreadingMixIn",
+]
+if sys.platform != "win32":
+    __all__ += [
+        "ForkingMixIn",
+        "ForkingTCPServer",
+        "ForkingUDPServer",
+        "ThreadingUnixDatagramServer",
+        "ThreadingUnixStreamServer",
+        "UnixDatagramServer",
+        "UnixStreamServer",
+    ]
+    if sys.version_info >= (3, 12):
+        __all__ += ["ForkingUnixStreamServer", "ForkingUnixDatagramServer"]
+
+_RequestType: TypeAlias = _socket | tuple[bytes, _socket]
+_AfUnixAddress: TypeAlias = str | ReadableBuffer  # address acceptable for an AF_UNIX socket
+_AfInetAddress: TypeAlias = tuple[str | bytes | bytearray, int]  # address acceptable for an AF_INET socket
+
+# This can possibly be generic at some point:
+class BaseServer:
+    address_family: int
+    server_address: _Address
+    socket: _socket
+    allow_reuse_address: bool
+    request_queue_size: int
+    socket_type: int
+    timeout: float | None
+    RequestHandlerClass: Callable[[Any, _RetAddress, Self], BaseRequestHandler]
+    def __init__(
+        self, server_address: _Address, RequestHandlerClass: Callable[[Any, _RetAddress, Self], BaseRequestHandler]
+    ) -> None: ...
+    def fileno(self) -> int: ...
+    def handle_request(self) -> None: ...
+    def serve_forever(self, poll_interval: float = 0.5) -> None: ...
+    def shutdown(self) -> None: ...
+    def server_close(self) -> None: ...
+    def finish_request(self, request: _RequestType, client_address: _RetAddress) -> None: ...
+    def get_request(self) -> tuple[Any, Any]: ...
+    def handle_error(self, request: _RequestType, client_address: _RetAddress) -> None: ...
+    def handle_timeout(self) -> None: ...
+    def process_request(self, request: _RequestType, client_address: _RetAddress) -> None: ...
+    def server_activate(self) -> None: ...
+    def server_bind(self) -> None: ...
+    def verify_request(self, request: _RequestType, client_address: _RetAddress) -> bool: ...
+    def __enter__(self) -> Self: ...
+    def __exit__(
+        self, exc_type: type[BaseException] | None, exc_val: BaseException | None, exc_tb: types.TracebackType | None
+    ) -> None: ...
+    def service_actions(self) -> None: ...
+    def shutdown_request(self, request: _RequestType) -> None: ...  # undocumented
+    def close_request(self, request: _RequestType) -> None: ...  # undocumented
+
+class TCPServer(BaseServer):
+    if sys.version_info >= (3, 11):
+        allow_reuse_port: bool
+    server_address: _AfInetAddress
+    def __init__(
+        self,
+        server_address: _AfInetAddress,
+        RequestHandlerClass: Callable[[Any, _RetAddress, Self], BaseRequestHandler],
+        bind_and_activate: bool = True,
+    ) -> None: ...
+    def get_request(self) -> tuple[_socket, _RetAddress]: ...
+
+class UDPServer(TCPServer):
+    max_packet_size: ClassVar[int]
+    def get_request(self) -> tuple[tuple[bytes, _socket], _RetAddress]: ...  # type: ignore[override]
+
+if sys.platform != "win32":
+    class UnixStreamServer(TCPServer):
+        server_address: _AfUnixAddress  # type: ignore[assignment]
+        def __init__(
+            self,
+            server_address: _AfUnixAddress,
+            RequestHandlerClass: Callable[[Any, _RetAddress, Self], BaseRequestHandler],
+            bind_and_activate: bool = True,
+        ) -> None: ...
+
+    class UnixDatagramServer(UDPServer):
+        server_address: _AfUnixAddress  # type: ignore[assignment]
+        def __init__(
+            self,
+            server_address: _AfUnixAddress,
+            RequestHandlerClass: Callable[[Any, _RetAddress, Self], BaseRequestHandler],
+            bind_and_activate: bool = True,
+        ) -> None: ...
+
+if sys.platform != "win32":
+    class ForkingMixIn:
+        timeout: float | None  # undocumented
+        active_children: set[int] | None  # undocumented
+        max_children: int  # undocumented
+        block_on_close: bool
+        def collect_children(self, *, blocking: bool = False) -> None: ...  # undocumented
+        def handle_timeout(self) -> None: ...  # undocumented
+        def service_actions(self) -> None: ...  # undocumented
+        def process_request(self, request: _RequestType, client_address: _RetAddress) -> None: ...
+        def server_close(self) -> None: ...
+
+class ThreadingMixIn:
+    daemon_threads: bool
+    block_on_close: bool
+    def process_request_thread(self, request: _RequestType, client_address: _RetAddress) -> None: ...  # undocumented
+    def process_request(self, request: _RequestType, client_address: _RetAddress) -> None: ...
+    def server_close(self) -> None: ...
+
+if sys.platform != "win32":
+    class ForkingTCPServer(ForkingMixIn, TCPServer): ...
+    class ForkingUDPServer(ForkingMixIn, UDPServer): ...
+    if sys.version_info >= (3, 12):
+        class ForkingUnixStreamServer(ForkingMixIn, UnixStreamServer): ...
+        class ForkingUnixDatagramServer(ForkingMixIn, UnixDatagramServer): ...
+
+class ThreadingTCPServer(ThreadingMixIn, TCPServer): ...
+class ThreadingUDPServer(ThreadingMixIn, UDPServer): ...
+
+if sys.platform != "win32":
+    class ThreadingUnixStreamServer(ThreadingMixIn, UnixStreamServer): ...
+    class ThreadingUnixDatagramServer(ThreadingMixIn, UnixDatagramServer): ...
+
+class BaseRequestHandler:
+    # `request` is technically of type _RequestType,
+    # but there are some concerns that having a union here would cause
+    # too much inconvenience to people using it (see
+    # https://github.com/python/typeshed/pull/384#issuecomment-234649696)
+    #
+    # Note also that _RetAddress is also just an alias for `Any`
+    request: Any
+    client_address: _RetAddress
+    server: BaseServer
+    def __init__(self, request: _RequestType, client_address: _RetAddress, server: BaseServer) -> None: ...
+    def setup(self) -> None: ...
+    def handle(self) -> None: ...
+    def finish(self) -> None: ...
+
+class StreamRequestHandler(BaseRequestHandler):
+    rbufsize: ClassVar[int]  # undocumented
+    wbufsize: ClassVar[int]  # undocumented
+    timeout: ClassVar[float | None]  # undocumented
+    disable_nagle_algorithm: ClassVar[bool]  # undocumented
+    connection: Any  # undocumented
+    rfile: BufferedIOBase
+    wfile: BufferedIOBase
+
+class DatagramRequestHandler(BaseRequestHandler):
+    packet: bytes  # undocumented
+    socket: _socket  # undocumented
+    rfile: BufferedIOBase
+    wfile: BufferedIOBase

package/dist/typeshed-fallback/stdlib/spwd.pyi

@@ -1,15 +1,3 @@
-"""
-This module provides access to the Unix shadow password database.
-It is available on various Unix versions.
-
-Shadow password database entries are reported as 9-tuples of type struct_spwd,
-containing the following items from the password database (see `<shadow.h>'):
-sp_namp, sp_pwdp, sp_lstchg, sp_min, sp_max, sp_warn, sp_inact, sp_expire, sp_flag.
-The sp_namp and sp_pwdp are strings, the rest are integers.
-An exception is raised if the entry asked for cannot be found.
-You have to be root to be able to use this module.
-"""
-
 import sys
 from _typeshed import structseq
 from typing import Any, Final, final
@@ -17,13 +5,6 @@ from typing import Any, Final, final
 if sys.platform != "win32":
     @final
     class struct_spwd(structseq[Any], tuple[str, str, int, int, int, int, int, int, int]):
-        """
-        spwd.struct_spwd: Results from getsp*() routines.
-
-        This object may be accessed either as a 9-tuple of
-          (sp_namp,sp_pwdp,sp_lstchg,sp_min,sp_max,sp_warn,sp_inact,sp_expire,sp_flag)
-        or via the object attributes as named in the above tuple.
-        """
         if sys.version_info >= (3, 10):
             __match_args__: Final = (
                 "sp_namp",
@@ -38,62 +19,28 @@ if sys.platform != "win32":
             )
 
         @property
-        def sp_namp(self) -> str:
-            """login name"""
-            ...
+        def sp_namp(self) -> str: ...
         @property
-        def sp_pwdp(self) -> str:
-            """encrypted password"""
-            ...
+        def sp_pwdp(self) -> str: ...
         @property
-        def sp_lstchg(self) -> int:
-            """date of last change"""
-            ...
+        def sp_lstchg(self) -> int: ...
         @property
-        def sp_min(self) -> int:
-            """min #days between changes"""
-            ...
+        def sp_min(self) -> int: ...
         @property
-        def sp_max(self) -> int:
-            """max #days between changes"""
-            ...
+        def sp_max(self) -> int: ...
         @property
-        def sp_warn(self) -> int:
-            """#days before pw expires to warn user about it"""
-            ...
+        def sp_warn(self) -> int: ...
         @property
-        def sp_inact(self) -> int:
-            """#days after pw expires until account is disabled"""
-            ...
+        def sp_inact(self) -> int: ...
         @property
-        def sp_expire(self) -> int:
-            """#days since 1970-01-01 when account expires"""
-            ...
+        def sp_expire(self) -> int: ...
         @property
-        def sp_flag(self) -> int:
-            """reserved"""
-            ...
+        def sp_flag(self) -> int: ...
         # Deprecated aliases below.
         @property
-        def sp_nam(self) -> str:
-            """login name; deprecated"""
-            ...
+        def sp_nam(self) -> str: ...
         @property
-        def sp_pwd(self) -> str:
-            """encrypted password; deprecated"""
-            ...
-
-    def getspall() -> list[struct_spwd]:
-        """
-        Return a list of all available shadow password database entries, in arbitrary order.
-
-        See `help(spwd)` for more on shadow password database entries.
-        """
-        ...
-    def getspnam(arg: str, /) -> struct_spwd:
-        """
-        Return the shadow password database entry for the given user name.
+        def sp_pwd(self) -> str: ...
 
-        See `help(spwd)` for more on shadow password database entries.
-        """
-        ...
+    def getspall() -> list[struct_spwd]: ...
+    def getspnam(arg: str, /) -> struct_spwd: ...