basedpyright 1.13.2 → 1.13.3

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

@@ -98,14 +98,37 @@ else:
 
 _create_default_https_context: Callable[..., SSLContext]
 
-def RAND_bytes(n: int, /) -> bytes: ...
+def RAND_bytes(n: int, /) -> bytes:
+    """Generate n cryptographically strong pseudo-random bytes."""
+    ...
 
 if sys.version_info < (3, 12):
-    def RAND_pseudo_bytes(n: int, /) -> tuple[bytes, bool]: ...
-
-def RAND_status() -> bool: ...
+    def RAND_pseudo_bytes(n: int, /) -> tuple[bytes, bool]:
+        """
+        Generate n pseudo-random bytes.
+
+        Return a pair (bytes, is_cryptographic).  is_cryptographic is True
+        if the bytes generated are cryptographically strong.
+        """
+        ...
+
+def RAND_status() -> bool:
+    """
+    Returns 1 if the OpenSSL PRNG has been seeded with enough data and 0 if not.
+
+    It is necessary to seed the PRNG with RAND_add() on some platforms before
+    using the ssl() function.
+    """
+    ...
 def RAND_egd(path: str) -> None: ...
-def RAND_add(string: str | ReadableBuffer, entropy: float, /) -> None: ...
+def RAND_add(string: str | ReadableBuffer, entropy: float, /) -> None:
+    """
+    Mix string into the OpenSSL PRNG state.
+
+    entropy (a float) is a lower bound on the entropy contained in
+    string.  See RFC 4086.
+    """
+    ...
 
 if sys.version_info < (3, 12):
     def match_hostname(cert: _PeerCertRetDictType, hostname: str) -> None: ...
@@ -316,6 +339,10 @@ class _ASN1Object(_ASN1ObjectBase):
     def fromname(cls, name: str) -> Self: ...
 
 class Purpose(_ASN1Object, enum.Enum):
+    """
+    SSLContext purpose flags with X509v3 Extended Key Usage objects
+    
+    """
     SERVER_AUTH = (129, "serverAuth", "TLS Web Server Authentication", "1.3.6.1.5.5.7.3.2")  # pyright: ignore[reportCallIssue]
     CLIENT_AUTH = (130, "clientAuth", "TLS Web Client Authentication", "1.3.6.1.5.5.7.3.1")  # pyright: ignore[reportCallIssue]
 
@@ -325,7 +352,9 @@ class SSLSocket(socket.socket):
     server_hostname: str | None
     session: SSLSession | None
     @property
-    def session_reused(self) -> bool | None: ...
+    def session_reused(self) -> bool | None:
+        """Was the client session reused during handshake"""
+        ...
     def __init__(self, *args: Any, **kwargs: Any) -> None: ...
     def connect(self, addr: socket._Address) -> None: ...
     def connect_ex(self, addr: socket._Address) -> int: ...
@@ -406,7 +435,17 @@ class SSLContext:
     else:
         def __new__(cls, protocol: int = ..., *args: Any, **kwargs: Any) -> Self: ...
 
-    def cert_store_stats(self) -> dict[str, int]: ...
+    def cert_store_stats(self) -> dict[str, int]:
+        """
+        Returns quantities of loaded X.509 certificates.
+
+        X.509 certificates with a CA extension and certificate revocation lists
+        inside the context's cert store.
+
+        NOTE: Certificates in a capath directory aren't loaded unless they have
+        been used at least once.
+        """
+        ...
     def load_cert_chain(
         self, certfile: StrOrBytesPath, keyfile: StrOrBytesPath | None = None, password: _PasswordType | None = None
     ) -> None: ...
@@ -418,11 +457,41 @@ class SSLContext:
         cadata: str | ReadableBuffer | None = None,
     ) -> None: ...
     @overload
-    def get_ca_certs(self, binary_form: Literal[False] = False) -> list[_PeerCertRetDictType]: ...
+    def get_ca_certs(self, binary_form: Literal[False] = False) -> list[_PeerCertRetDictType]:
+        """
+        Returns a list of dicts with information of loaded CA certs.
+
+        If the optional argument is True, returns a DER-encoded copy of the CA
+        certificate.
+
+        NOTE: Certificates in a capath directory aren't loaded unless they have
+        been used at least once.
+        """
+        ...
     @overload
-    def get_ca_certs(self, binary_form: Literal[True]) -> list[bytes]: ...
+    def get_ca_certs(self, binary_form: Literal[True]) -> list[bytes]:
+        """
+        Returns a list of dicts with information of loaded CA certs.
+
+        If the optional argument is True, returns a DER-encoded copy of the CA
+        certificate.
+
+        NOTE: Certificates in a capath directory aren't loaded unless they have
+        been used at least once.
+        """
+        ...
     @overload
-    def get_ca_certs(self, binary_form: bool = False) -> Any: ...
+    def get_ca_certs(self, binary_form: bool = False) -> Any:
+        """
+        Returns a list of dicts with information of loaded CA certs.
+
+        If the optional argument is True, returns a DER-encoded copy of the CA
+        certificate.
+
+        NOTE: Certificates in a capath directory aren't loaded unless they have
+        been used at least once.
+        """
+        ...
     def get_ciphers(self) -> list[_Cipher]: ...
     def set_default_verify_paths(self) -> None: ...
     def set_ciphers(self, cipherlist: str, /) -> None: ...
@@ -453,12 +522,21 @@ class SSLContext:
 class SSLObject:
     context: SSLContext
     @property
-    def server_side(self) -> bool: ...
+    def server_side(self) -> bool:
+        """Whether this is a server-side socket."""
+        ...
     @property
-    def server_hostname(self) -> str | None: ...
+    def server_hostname(self) -> str | None:
+        """
+        The currently set server hostname (for SNI), or ``None`` if no
+        server hostname is set.
+        """
+        ...
     session: SSLSession | None
     @property
-    def session_reused(self) -> bool: ...
+    def session_reused(self) -> bool:
+        """Was the client session reused during handshake"""
+        ...
     def __init__(self, *args: Any, **kwargs: Any) -> None: ...
     def read(self, len: int = 1024, buffer: bytearray | None = None) -> bytes: ...
     def write(self, data: ReadableBuffer) -> int: ...
@@ -487,23 +565,56 @@ class SSLObject:
 class MemoryBIO:
     pending: int
     eof: bool
-    def read(self, size: int = -1, /) -> bytes: ...
-    def write(self, b: ReadableBuffer, /) -> int: ...
-    def write_eof(self) -> None: ...
+    def read(self, size: int = -1, /) -> bytes:
+        """
+        Read up to size bytes from the memory BIO.
+
+        If size is not specified, read the entire buffer.
+        If the return value is an empty bytes instance, this means either
+        EOF or that no data is available. Use the "eof" property to
+        distinguish between the two.
+        """
+        ...
+    def write(self, b: ReadableBuffer, /) -> int:
+        """
+        Writes the bytes b into the memory BIO.
+
+        Returns the number of bytes written.
+        """
+        ...
+    def write_eof(self) -> None:
+        """
+        Write an EOF marker to the memory BIO.
+
+        When all data has been read, the "eof" property will be True.
+        """
+        ...
 
 @final
 class SSLSession:
     @property
-    def has_ticket(self) -> bool: ...
+    def has_ticket(self) -> bool:
+        """Does the session contain a ticket?"""
+        ...
     @property
-    def id(self) -> bytes: ...
+    def id(self) -> bytes:
+        """Session id"""
+        ...
     @property
-    def ticket_lifetime_hint(self) -> int: ...
+    def ticket_lifetime_hint(self) -> int:
+        """Ticket life time hint."""
+        ...
     @property
-    def time(self) -> int: ...
+    def time(self) -> int:
+        """Session creation time (seconds since epoch)."""
+        ...
     @property
-    def timeout(self) -> int: ...
-    def __eq__(self, value: object, /) -> bool: ...
+    def timeout(self) -> int:
+        """Session timeout (delta in seconds)."""
+        ...
+    def __eq__(self, value: object, /) -> bool:
+        """Return self==value."""
+        ...
 
 class SSLErrorNumber(enum.IntEnum):
     SSL_ERROR_EOF = 8

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

@@ -78,15 +78,30 @@ def variance(data: Iterable[_NumberT], xbar: _NumberT | None = None) -> _NumberT
 class NormalDist:
     def __init__(self, mu: float = 0.0, sigma: float = 1.0) -> None: ...
     @property
-    def mean(self) -> float: ...
+    def mean(self) -> float:
+        """Arithmetic mean of the normal distribution."""
+        ...
     @property
-    def median(self) -> float: ...
+    def median(self) -> float:
+        """Return the median of the normal distribution"""
+        ...
     @property
-    def mode(self) -> float: ...
+    def mode(self) -> float:
+        """
+        Return the mode of the normal distribution
+
+        The mode is the value x where which the probability density
+        function (pdf) takes its maximum value.
+        """
+        ...
     @property
-    def stdev(self) -> float: ...
+    def stdev(self) -> float:
+        """Standard deviation of the normal distribution."""
+        ...
     @property
-    def variance(self) -> float: ...
+    def variance(self) -> float:
+        """Square of the standard deviation."""
+        ...
     @classmethod
     def from_samples(cls, data: Iterable[SupportsFloat]) -> Self: ...
     def samples(self, n: int, *, seed: Any | None = None) -> list[float]: ...

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

@@ -6,21 +6,122 @@ __all__ = ["calcsize", "pack", "pack_into", "unpack", "unpack_from", "iter_unpac
 
 class error(Exception): ...
 
-def pack(fmt: str | bytes, /, *v: Any) -> bytes: ...
-def pack_into(fmt: str | bytes, buffer: WriteableBuffer, offset: int, /, *v: Any) -> None: ...
-def unpack(format: str | bytes, buffer: ReadableBuffer, /) -> tuple[Any, ...]: ...
-def unpack_from(format: str | bytes, /, buffer: ReadableBuffer, offset: int = 0) -> tuple[Any, ...]: ...
-def iter_unpack(format: str | bytes, buffer: ReadableBuffer, /) -> Iterator[tuple[Any, ...]]: ...
-def calcsize(format: str | bytes, /) -> int: ...
+def pack(fmt: str | bytes, /, *v: Any) -> bytes:
+    """
+    pack(format, v1, v2, ...) -> bytes
+
+    Return a bytes object containing the values v1, v2, ... packed according
+    to the format string.  See help(struct) for more on format strings.
+    """
+    ...
+def pack_into(fmt: str | bytes, buffer: WriteableBuffer, offset: int, /, *v: Any) -> None:
+    """
+    pack_into(format, buffer, offset, v1, v2, ...)
+
+    Pack the values v1, v2, ... according to the format string and write
+    the packed bytes into the writable buffer buf starting at offset.  Note
+    that the offset is a required argument.  See help(struct) for more
+    on format strings.
+    """
+    ...
+def unpack(format: str | bytes, buffer: ReadableBuffer, /) -> tuple[Any, ...]:
+    """
+    Return a tuple containing values unpacked according to the format string.
+
+    The buffer's size in bytes must be calcsize(format).
+
+    See help(struct) for more on format strings.
+    """
+    ...
+def unpack_from(format: str | bytes, /, buffer: ReadableBuffer, offset: int = 0) -> tuple[Any, ...]:
+    """
+    Return a tuple containing values unpacked according to the format string.
+
+    The buffer's size, minus offset, must be at least calcsize(format).
+
+    See help(struct) for more on format strings.
+    """
+    ...
+def iter_unpack(format: str | bytes, buffer: ReadableBuffer, /) -> Iterator[tuple[Any, ...]]:
+    """
+    Return an iterator yielding tuples unpacked from the given bytes.
+
+    The bytes are unpacked according to the format string, like
+    a repeated invocation of unpack_from().
+
+    Requires that the bytes length be a multiple of the format struct size.
+    """
+    ...
+def calcsize(format: str | bytes, /) -> int:
+    """Return size in bytes of the struct described by the format string."""
+    ...
 
 class Struct:
+    """
+    Create a compiled struct object.
+
+    Return a new Struct object which writes and reads binary data according to
+    the format string.
+
+    See help(struct) for more on format strings.
+    """
     @property
-    def format(self) -> str: ...
+    def format(self) -> str:
+        """struct format string"""
+        ...
     @property
-    def size(self) -> int: ...
+    def size(self) -> int:
+        """struct size in bytes"""
+        ...
     def __init__(self, format: str | bytes) -> None: ...
-    def pack(self, *v: Any) -> bytes: ...
-    def pack_into(self, buffer: WriteableBuffer, offset: int, *v: Any) -> None: ...
-    def unpack(self, buffer: ReadableBuffer, /) -> tuple[Any, ...]: ...
-    def unpack_from(self, buffer: ReadableBuffer, offset: int = 0) -> tuple[Any, ...]: ...
-    def iter_unpack(self, buffer: ReadableBuffer, /) -> Iterator[tuple[Any, ...]]: ...
+    def pack(self, *v: Any) -> bytes:
+        """
+        S.pack(v1, v2, ...) -> bytes
+
+        Return a bytes object containing values v1, v2, ... packed according
+        to the format string S.format.  See help(struct) for more on format
+        strings.
+        """
+        ...
+    def pack_into(self, buffer: WriteableBuffer, offset: int, *v: Any) -> None:
+        """
+        S.pack_into(buffer, offset, v1, v2, ...)
+
+        Pack the values v1, v2, ... according to the format string S.format
+        and write the packed bytes into the writable buffer buf starting at
+        offset.  Note that the offset is a required argument.  See
+        help(struct) for more on format strings.
+        """
+        ...
+    def unpack(self, buffer: ReadableBuffer, /) -> tuple[Any, ...]:
+        """
+        Return a tuple containing unpacked values.
+
+        Unpack according to the format string Struct.format. The buffer's size
+        in bytes must be Struct.size.
+
+        See help(struct) for more on format strings.
+        """
+        ...
+    def unpack_from(self, buffer: ReadableBuffer, offset: int = 0) -> tuple[Any, ...]:
+        """
+        Return a tuple containing unpacked values.
+
+        Values are unpacked according to the format string Struct.format.
+
+        The buffer's size in bytes, starting at position offset, must be
+        at least Struct.size.
+
+        See help(struct) for more on format strings.
+        """
+        ...
+    def iter_unpack(self, buffer: ReadableBuffer, /) -> Iterator[tuple[Any, ...]]:
+        """
+        Return an iterator yielding tuples.
+
+        Tuples are unpacked from the given bytes source, like a repeated
+        invocation of unpack_from().
+
+        Requires that the bytes length be a multiple of the struct size.
+        """
+        ...

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

@@ -88,7 +88,13 @@ class CompletedProcess(Generic[_T]):
     def __init__(self, args: _CMD, returncode: int, stdout: _T | None = None, stderr: _T | None = None) -> None: ...
     def check_returncode(self) -> None: ...
     if sys.version_info >= (3, 9):
-        def __class_getitem__(cls, item: Any, /) -> GenericAlias: ...
+        def __class_getitem__(cls, item: Any, /) -> GenericAlias:
+            """
+            Represent a PEP 585 generic type
+
+            E.g. for t = list[int], t.__origin__ is list and t.__args__ is (int,).
+            """
+            ...
 
 if sys.version_info >= (3, 11):
     # 3.11 adds "process_group" argument
@@ -2568,7 +2574,13 @@ class Popen(Generic[AnyStr]):
     ) -> None: ...
     def __del__(self) -> None: ...
     if sys.version_info >= (3, 9):
-        def __class_getitem__(cls, item: Any, /) -> GenericAlias: ...
+        def __class_getitem__(cls, item: Any, /) -> GenericAlias:
+            """
+            Represent a PEP 585 generic type
+
+            E.g. for t = list[int], t.__origin__ is list and t.__args__ is (int,).
+            """
+            ...
 
 # The result really is always a str.
 if sys.version_info >= (3, 11):

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

@@ -1,93 +1,93 @@
-single_input: int
-file_input: int
-eval_input: int
-decorator: int
-decorators: int
-decorated: int
-async_funcdef: int
-funcdef: int
-parameters: int
-typedargslist: int
-tfpdef: int
-varargslist: int
-vfpdef: int
-stmt: int
-simple_stmt: int
-small_stmt: int
-expr_stmt: int
-annassign: int
-testlist_star_expr: int
-augassign: int
-del_stmt: int
-pass_stmt: int
-flow_stmt: int
-break_stmt: int
-continue_stmt: int
-return_stmt: int
-yield_stmt: int
-raise_stmt: int
-import_stmt: int
-import_name: int
-import_from: int
-import_as_name: int
-dotted_as_name: int
-import_as_names: int
-dotted_as_names: int
-dotted_name: int
-global_stmt: int
-nonlocal_stmt: int
-assert_stmt: int
-compound_stmt: int
-async_stmt: int
-if_stmt: int
-while_stmt: int
-for_stmt: int
-try_stmt: int
-with_stmt: int
-with_item: int
-except_clause: int
-suite: int
-test: int
-test_nocond: int
-lambdef: int
-lambdef_nocond: int
-or_test: int
-and_test: int
-not_test: int
-comparison: int
-comp_op: int
-star_expr: int
-expr: int
-xor_expr: int
-and_expr: int
-shift_expr: int
-arith_expr: int
-term: int
-factor: int
-power: int
-atom_expr: int
-atom: int
-testlist_comp: int
-trailer: int
-subscriptlist: int
-subscript: int
-sliceop: int
-exprlist: int
-testlist: int
-dictorsetmaker: int
-classdef: int
-arglist: int
-argument: int
-comp_iter: int
-comp_for: int
-comp_if: int
-encoding_decl: int
-yield_expr: int
-yield_arg: int
-sync_comp_for: int
-func_body_suite: int
-func_type: int
-func_type_input: int
-namedexpr_test: int
-typelist: int
-sym_name: dict[int, str]
+single_input: int
+file_input: int
+eval_input: int
+decorator: int
+decorators: int
+decorated: int
+async_funcdef: int
+funcdef: int
+parameters: int
+typedargslist: int
+tfpdef: int
+varargslist: int
+vfpdef: int
+stmt: int
+simple_stmt: int
+small_stmt: int
+expr_stmt: int
+annassign: int
+testlist_star_expr: int
+augassign: int
+del_stmt: int
+pass_stmt: int
+flow_stmt: int
+break_stmt: int
+continue_stmt: int
+return_stmt: int
+yield_stmt: int
+raise_stmt: int
+import_stmt: int
+import_name: int
+import_from: int
+import_as_name: int
+dotted_as_name: int
+import_as_names: int
+dotted_as_names: int
+dotted_name: int
+global_stmt: int
+nonlocal_stmt: int
+assert_stmt: int
+compound_stmt: int
+async_stmt: int
+if_stmt: int
+while_stmt: int
+for_stmt: int
+try_stmt: int
+with_stmt: int
+with_item: int
+except_clause: int
+suite: int
+test: int
+test_nocond: int
+lambdef: int
+lambdef_nocond: int
+or_test: int
+and_test: int
+not_test: int
+comparison: int
+comp_op: int
+star_expr: int
+expr: int
+xor_expr: int
+and_expr: int
+shift_expr: int
+arith_expr: int
+term: int
+factor: int
+power: int
+atom_expr: int
+atom: int
+testlist_comp: int
+trailer: int
+subscriptlist: int
+subscript: int
+sliceop: int
+exprlist: int
+testlist: int
+dictorsetmaker: int
+classdef: int
+arglist: int
+argument: int
+comp_iter: int
+comp_for: int
+comp_if: int
+encoding_decl: int
+yield_expr: int
+yield_arg: int
+sync_comp_for: int
+func_body_suite: int
+func_type: int
+func_type_input: int
+namedexpr_test: int
+typelist: int
+sym_name: dict[int, str]

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

@@ -5,11 +5,30 @@ from typing import Any
 
 __all__ = ["symtable", "SymbolTable", "Class", "Function", "Symbol"]
 
+if sys.version_info >= (3, 13):
+    __all__ += ["SymbolTableType"]
+
 def symtable(code: str, filename: str, compile_type: str) -> SymbolTable: ...
 
+if sys.version_info >= (3, 13):
+    from enum import StrEnum
+
+    class SymbolTableType(StrEnum):
+        MODULE = "module"
+        FUNCTION = "function"
+        CLASS = "class"
+        ANNOTATION = "annotation"
+        TYPE_ALIAS = "type alias"
+        TYPE_PARAMETERS = "type parameters"
+        TYPE_VARIABLE = "type variable"
+
 class SymbolTable:
     def __init__(self, raw_table: Any, filename: str) -> None: ...
-    def get_type(self) -> str: ...
+    if sys.version_info >= (3, 13):
+        def get_type(self) -> SymbolTableType: ...
+    else:
+        def get_type(self) -> str: ...
+
     def get_id(self) -> int: ...
     def get_name(self) -> str: ...
     def get_lineno(self) -> int: ...
@@ -42,13 +61,23 @@ class Symbol:
     def get_name(self) -> str: ...
     def is_referenced(self) -> bool: ...
     def is_parameter(self) -> bool: ...
+    if sys.version_info >= (3, 14):
+        def is_type_parameter(self) -> bool: ...
+
     def is_global(self) -> bool: ...
     def is_declared_global(self) -> bool: ...
     def is_local(self) -> bool: ...
     def is_annotated(self) -> bool: ...
     def is_free(self) -> bool: ...
+    if sys.version_info >= (3, 14):
+        def is_free_class(self) -> bool: ...
+
     def is_imported(self) -> bool: ...
     def is_assigned(self) -> bool: ...
+    if sys.version_info >= (3, 14):
+        def is_comp_iter(self) -> bool: ...
+        def is_comp_cell(self) -> bool: ...
+
     def is_namespace(self) -> bool: ...
     def get_namespaces(self) -> Sequence[SymbolTable]: ...
     def get_namespace(self) -> SymbolTable: ...

package/dist/typeshed-fallback/stdlib/sys/__init__.pyi

@@ -681,9 +681,13 @@ def get_int_max_str_digits() -> int:
     ...
 
 if sys.version_info >= (3, 12):
-    def getunicodeinternedsize() -> int:
-        """Return the number of elements of the unicode interned dictionary"""
-        ...
+    if sys.version_info >= (3, 13):
+        def getunicodeinternedsize(*, _only_immortal: bool = False) -> int: ...
+    else:
+        def getunicodeinternedsize() -> int:
+            """Return the number of elements of the unicode interned dictionary"""
+            ...
+
     def deactivate_stack_trampoline() -> None:
         """
         Deactivate the current stack profiler trampoline backend.