basedpyright 1.40.1 → 1.40.2

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

@@ -247,11 +247,6 @@ if sys.version_info >= (3, 12):
 
         You can use ":memory:" to open a database connection to a database that
         resides in RAM instead of on disk.
-
-        Note: Passing more than 1 positional argument to _sqlite3.connect() is
-        deprecated. Parameters 'timeout', 'detect_types', 'isolation_level',
-        'check_same_thread', 'factory', 'cached_statements' and 'uri' will
-        become keyword-only parameters in Python 3.15.
         """
         ...
     @overload
@@ -272,11 +267,6 @@ if sys.version_info >= (3, 12):
 
         You can use ":memory:" to open a database connection to a database that
         resides in RAM instead of on disk.
-
-        Note: Passing more than 1 positional argument to _sqlite3.connect() is
-        deprecated. Parameters 'timeout', 'detect_types', 'isolation_level',
-        'check_same_thread', 'factory', 'cached_statements' and 'uri' will
-        become keyword-only parameters in Python 3.15.
         """
         ...
     @overload
@@ -297,11 +287,6 @@ if sys.version_info >= (3, 12):
 
         You can use ":memory:" to open a database connection to a database that
         resides in RAM instead of on disk.
-
-        Note: Passing more than 1 positional argument to _sqlite3.connect() is
-        deprecated. Parameters 'timeout', 'detect_types', 'isolation_level',
-        'check_same_thread', 'factory', 'cached_statements' and 'uri' will
-        become keyword-only parameters in Python 3.15.
         """
         ...
 else:

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

@@ -35,49 +35,46 @@ from typing_extensions import disjoint_base
 
 def pack(fmt: str | bytes, /, *v: Any) -> bytes:
     """
-    pack(format, v1, v2, ...) -> bytes
+    Pack values and return the packed bytes.
 
-    Return a bytes object containing the values v1, v2, ... packed according
+    Return a bytes object containing the provided values 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 values and write the packed bytes into the buffer.
 
-    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.  A negative offset counts from
-    the end of the buffer.  See help(struct) for more on format strings.
+    Pack the provided values according to the format string and write the
+    packed bytes into the writable buffer starting at offset.  Note that the
+    offset is a required argument.  A negative offset counts from the end of
+    the buffer.  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.
+    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).
-    A negative offset counts from the end of the buffer.
-
-    See help(struct) for more on format strings.
+    The buffer must contain at least calcsize(format) bytes starting at
+    offset.  A negative offset counts from the end of the buffer.  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.
+    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 calcsize(format).
     """
     ...
 def calcsize(format: str | bytes, /) -> int:
@@ -86,7 +83,12 @@ def calcsize(format: str | bytes, /) -> int:
 
 @disjoint_base
 class Struct:
-    """Struct(fmt) --> compiled struct object"""
+    """
+    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:
         """struct format string"""
@@ -98,45 +100,41 @@ class Struct:
     def __init__(self, format: str | bytes) -> None: ...
     def pack(self, *v: Any) -> bytes:
         """
-        S.pack(v1, v2, ...) -> bytes
+        Pack values and return the packed 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.
+        Return a bytes object containing the provided values packed
+        according to the struct format string.  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 values and write the packed bytes into the buffer.
 
-        Pack the values v1, v2, ... according to the format string S.format
-        and write the packed bytes into the writable buffer buf starting at
+        Pack the provided values according to the struct format string
+        and write the packed bytes into the writable buffer starting at
         offset.  Note that the offset is a required argument.  A negative
-        offset counts from the end of the buffer.  See help(struct) for more
-        on format strings.
+        offset counts from the end of the buffer.  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.
+        Unpack according to the struct format string.  The buffer's
+        size in bytes must be the 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.  A negative offset counts from the end of the
-        buffer.
-
-        See help(struct) for more on format strings.
+        Values are unpacked according to the struct format string.  The
+        buffer's size in bytes, starting at position offset, must be at
+        least the struct size.  A negative offset counts from the end of
+        the buffer.  See help(struct) for more on format strings.
         """
         ...
     def iter_unpack(self, buffer: ReadableBuffer, /) -> Iterator[tuple[Any, ...]]:
@@ -144,8 +142,7 @@ class Struct:
         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.
+        invocation of unpack_from().  Requires that the bytes length be
+        a multiple of the struct size.
         """
         ...

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

@@ -32,7 +32,9 @@ def _count() -> int:
 class RLock:
     def acquire(self, blocking: bool = True, timeout: float = -1) -> bool:
         """
-        Lock the lock.  `blocking` indicates whether we should wait
+        Lock the lock.
+
+        `blocking` indicates whether we should wait
         for the lock to be available or not.  If `blocking` is False
         and another thread holds the lock, the method will return False
         immediately.  If `blocking` is True and another thread holds
@@ -48,14 +50,16 @@ class RLock:
         ...
     def release(self) -> None:
         """
-        Release the lock, allowing another thread that is blocked waiting for
-        the lock to acquire the lock.  The lock must be in the locked state,
+        Release the lock.
+
+        Allows another thread that is blocked waiting for the lock
+        to acquire the lock.  The lock must be in the locked state,
         and must be locked by the same thread that unlocks it; otherwise a
         `RuntimeError` is raised.
 
-        Do note that if the lock was acquire()d several times in a row by the
-        current thread, release() needs to be called as many times for the lock
-        to be available for other threads.
+        Do note that if the lock was acquire()d several times in a row by
+        the current thread, release() needs to be called as many times for
+        the lock to be available for other threads.
         """
         ...
     __enter__ = acquire
@@ -64,11 +68,7 @@ class RLock:
         ...
     if sys.version_info >= (3, 14):
         def locked(self) -> bool:
-            """
-            locked()
-
-            Return a boolean indicating whether this object is locked right now.
-            """
+            """Return a boolean indicating whether this object is locked right now."""
             ...
 
 if sys.version_info >= (3, 13):
@@ -112,8 +112,10 @@ if sys.version_info >= (3, 13):
         """
         def acquire(self, blocking: bool = True, timeout: float = -1) -> bool:
             """
-            Lock the lock.  Without argument, this blocks if the lock is already
-            locked (even by the same thread), waiting for another thread to release
+            Lock the lock.
+
+            Without argument, this blocks if the lock is already locked
+            (even by the same thread), waiting for another thread to release
             the lock, and return True once the lock is acquired.
             With an argument, this will only block if the argument is true,
             and the return value reflects whether the lock is acquired.
@@ -122,7 +124,9 @@ if sys.version_info >= (3, 13):
             ...
         def release(self) -> None:
             """
-            Release the lock, allowing another thread that is blocked waiting for
+            Release the lock.
+
+            Allows another thread that is blocked waiting for
             the lock to acquire the lock.  The lock must be in the locked state,
             but it needn't be locked by the same thread that unlocks it.
             """

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

@@ -1,7 +1,7 @@
 """
 This module defines an object type which can efficiently represent
 an array of basic values: characters, integers, floating-point
-numbers.  Arrays are sequence types and behave very much like lists,
+numbers, complex numbers.  Arrays are sequence types and behave very much like lists,
 except that the type of objects stored in them is constrained.
 """
 
@@ -41,7 +41,7 @@ class array(MutableSequence[_T]):
 
     Arrays represent basic values and behave very much like lists, except
     the type of objects stored in them is constrained. The type is specified
-    at object creation time by using a type code, which is a single character.
+    at object creation time by using a type code, which is a string.
     The following type codes are defined:
 
         Type code   C Type             Minimum size in bytes
@@ -56,8 +56,11 @@ class array(MutableSequence[_T]):
         'L'         unsigned integer   4
         'q'         signed integer     8 (see note)
         'Q'         unsigned integer   8 (see note)
+        'e'         16-bit IEEE floats 2
         'f'         floating-point     4
         'd'         floating-point     8
+        'Zf'        float complex      8
+        'Zd'        double complex     16
 
     NOTE: The 'u' typecode corresponds to Python's unicode character. On
     narrow builds this is 2-bytes on wide builds this is 4-bytes.
@@ -144,8 +147,9 @@ class array(MutableSequence[_T]):
         """
         Byteswap all items of the array.
 
-        If the items in the array are not 1, 2, 4, or 8 bytes in size,
-        RuntimeError is raised.
+        If the items in the array are not 1, 2, 4, 8 or 16 bytes in size,
+        RuntimeError is raised.  Note, that for complex types the order of
+        components (the real part, followed by imaginary part) is preserved.
         """
         ...
     def count(self, v: _T, /) -> int:

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

@@ -777,7 +777,9 @@ class Import(stmt):
         def __init__(self, names: list[alias], **kwargs: Unpack[_Attributes]) -> None: ...
 
     if sys.version_info >= (3, 15):
-        def __replace__(self, *, names: list[alias] = ..., is_lazy: bool | None = ..., **kwargs: Unpack[_Attributes]) -> Self: ...
+        def __replace__(self, *, names: list[alias] = ..., is_lazy: bool | None = ..., **kwargs: Unpack[_Attributes]) -> Self:
+            """Return a copy of the AST node with new values for the specified fields."""
+            ...
 
     elif sys.version_info >= (3, 14):
         def __replace__(self, *, names: list[alias] = ..., **kwargs: Unpack[_Attributes]) -> Self:
@@ -833,7 +835,9 @@ class ImportFrom(stmt):
             level: int = ...,
             is_lazy: bool | None = ...,
             **kwargs: Unpack[_Attributes],
-        ) -> Self: ...
+        ) -> Self:
+            """Return a copy of the AST node with new values for the specified fields."""
+            ...
 
     elif sys.version_info >= (3, 14):
         def __replace__(
@@ -1057,7 +1061,9 @@ class DictComp(expr):
             value: expr | None = ...,
             generators: list[comprehension] = ...,
             **kwargs: Unpack[_Attributes],
-        ) -> Self: ...
+        ) -> Self:
+            """Return a copy of the AST node with new values for the specified fields."""
+            ...
     elif sys.version_info >= (3, 14):
         def __replace__(
             self, *, key: expr = ..., value: expr = ..., generators: list[comprehension] = ..., **kwargs: Unpack[_Attributes]

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

@@ -36,13 +36,43 @@ if sys.version_info >= (3, 15):
         padded: bool = True,
         ignorechars: ReadableBuffer = ...,
         canonical: bool = False,
-    ) -> bytes: ...
+    ) -> bytes:
+        """
+        Decode a line of base64 data.
+
+        strict_mode
+          When set to true, bytes that are not part of the base64 standard are
+          not allowed.  The same applies to excess data after padding (= / ==).
+          Set to True by default if ignorechars is specified, False otherwise.
+        padded
+          When set to false, padding in input is not required.
+        ignorechars
+          A byte string containing characters to ignore from the input when
+          strict_mode is true.
+        canonical
+          When set to true, reject non-zero padding bits per RFC 4648 section 3.5.
+        """
+        ...
     def b2a_base64(
         data: ReadableBuffer, /, *, newline: bool = True, alphabet: ReadableBuffer = ..., padded: bool = True, wrapcol: int = 0
-    ) -> bytes: ...
+    ) -> bytes:
+        """
+        Base64-code line of data.
+
+        padded
+          When set to false, omit padding in the output.
+        """
+        ...
     def b2a_base32(
         data: ReadableBuffer, /, *, alphabet: ReadableBuffer = ..., padded: bool = True, wrapcol: int = 0
-    ) -> bytes: ...
+    ) -> bytes:
+        """
+        Base32-code line of data.
+
+        padded
+          When set to false, omit padding in the output.
+        """
+        ...
     def a2b_base32(
         data: _AsciiBuffer,
         /,
@@ -51,10 +81,34 @@ if sys.version_info >= (3, 15):
         padded: bool = True,
         ignorechars: ReadableBuffer = b"",
         canonical: bool = False,
-    ) -> bytes: ...
+    ) -> bytes:
+        """
+        Decode a line of base32 data.
+
+        padded
+          When set to false, padding in input is not required.
+        ignorechars
+          A byte string containing characters to ignore from the input.
+        canonical
+          When set to true, reject non-zero padding bits per RFC 4648 section 3.5.
+        """
+        ...
     def b2a_ascii85(
         data: ReadableBuffer, /, *, foldspaces: bool = False, wrapcol: int = 0, pad: bool = False, adobe: bool = False
-    ) -> bytes: ...
+    ) -> bytes:
+        """
+        Ascii85-encode data.
+
+        foldspaces
+          Emit 'y' as a short form encoding four spaces.
+        wrapcol
+          Split result into lines of provided width.
+        pad
+          Retain zero-padding bytes at end of output.
+        adobe
+          Wrap result in '<~' and '~>' as in Adobe Ascii85.
+        """
+        ...
     def a2b_ascii85(
         data: _AsciiBuffer,
         /,
@@ -63,11 +117,41 @@ if sys.version_info >= (3, 15):
         adobe: bool = False,
         ignorechars: ReadableBuffer = b"",
         canonical: bool = False,
-    ) -> bytes: ...
-    def b2a_base85(data: ReadableBuffer, /, *, alphabet: ReadableBuffer = ..., pad: bool = False, wrapcol: int = 0) -> bytes: ...
+    ) -> bytes:
+        """
+        Decode Ascii85 data.
+
+        foldspaces
+          Allow 'y' as a short form encoding four spaces.
+        adobe
+          Expect data to be terminated with '~>' as in Adobe Ascii85, and
+          optionally accept leading '<~'.
+        ignorechars
+          A byte string containing characters to ignore from the input.
+        canonical
+          When set to true, reject non-canonical encodings.
+        """
+        ...
+    def b2a_base85(data: ReadableBuffer, /, *, alphabet: ReadableBuffer = ..., pad: bool = False, wrapcol: int = 0) -> bytes:
+        """
+        Base85-code line of data.
+
+        pad
+          Retain zero-padding bytes at end of output.
+        """
+        ...
     def a2b_base85(
         data: _AsciiBuffer, /, *, alphabet: bytes = ..., ignorechars: ReadableBuffer = b"", canonical: bool = False
-    ) -> bytes: ...
+    ) -> bytes:
+        """
+        Decode a line of Base85 data.
+
+        ignorechars
+          A byte string containing characters to ignore from the input.
+        canonical
+          When set to true, reject non-canonical encodings.
+        """
+        ...
 
 elif sys.version_info >= (3, 11):
     def a2b_base64(data: _AsciiBuffer, /, *, strict_mode: bool = False) -> bytes:
@@ -165,8 +249,27 @@ def hexlify(data: ReadableBuffer, sep: str | bytes = ..., bytes_per_sep: int = 1
     ...
 
 if sys.version_info >= (3, 15):
-    def a2b_hex(hexstr: _AsciiBuffer, /, *, ignorechars: ReadableBuffer = b"") -> bytes: ...
-    def unhexlify(hexstr: _AsciiBuffer, /, *, ignorechars: ReadableBuffer = b"") -> bytes: ...
+    def a2b_hex(hexstr: _AsciiBuffer, /, *, ignorechars: ReadableBuffer = b"") -> bytes:
+        """
+        Binary data of hexadecimal representation.
+
+          ignorechars
+            A byte string containing characters to ignore from the input.
+
+        hexstr must contain an even number of hex digits (upper or lower case).
+        This function is also available as "unhexlify()".
+        """
+        ...
+    def unhexlify(hexstr: _AsciiBuffer, /, *, ignorechars: ReadableBuffer = b"") -> bytes:
+        """
+        Binary data of hexadecimal representation.
+
+          ignorechars
+            A byte string containing characters to ignore from the input.
+
+        hexstr must contain an even number of hex digits (upper or lower case).
+        """
+        ...
 
 else:
     def a2b_hex(hexstr: _AsciiBuffer, /) -> bytes: