basedpyright 1.31.6 → 1.31.7

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

@@ -308,5 +308,9 @@ if sys.version_info >= (3, 12):
 
 if sys.version_info >= (3, 14):
     def future_discard_from_awaited_by(future: Future[Any], waiter: Future[Any], /) -> None: ...
-    def future_add_to_awaited_by(future: Future[Any], waiter: Future[Any], /) -> None: ...
-    def all_tasks(loop: AbstractEventLoop | None = None) -> set[Task[Any]]: ...
+    def future_add_to_awaited_by(future: Future[Any], waiter: Future[Any], /) -> None:
+        """Record that `fut` is awaited on by `waiter`."""
+        ...
+    def all_tasks(loop: AbstractEventLoop | None = None) -> set[Task[Any]]:
+        """Return a set of all tasks for the loop."""
+        ...

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

@@ -1,28 +1,28 @@
-# _compression is replaced by compression._common._streams on Python 3.14+ (PEP-784)
-
-from _typeshed import Incomplete, WriteableBuffer
-from collections.abc import Callable
-from io import DEFAULT_BUFFER_SIZE, BufferedIOBase, RawIOBase
-from typing import Any, Protocol, type_check_only
-
-BUFFER_SIZE = DEFAULT_BUFFER_SIZE
-
-@type_check_only
-class _Reader(Protocol):
-    def read(self, n: int, /) -> bytes: ...
-    def seekable(self) -> bool: ...
-    def seek(self, n: int, /) -> Any: ...
-
-class BaseStream(BufferedIOBase): ...
-
-class DecompressReader(RawIOBase):
-    def __init__(
-        self,
-        fp: _Reader,
-        decomp_factory: Callable[..., Incomplete],
-        trailing_error: type[Exception] | tuple[type[Exception], ...] = (),
-        **decomp_args: Any,  # These are passed to decomp_factory.
-    ) -> None: ...
-    def readinto(self, b: WriteableBuffer) -> int: ...
-    def read(self, size: int = -1) -> bytes: ...
-    def seek(self, offset: int, whence: int = 0) -> int: ...
+# _compression is replaced by compression._common._streams on Python 3.14+ (PEP-784)
+
+from _typeshed import Incomplete, WriteableBuffer
+from collections.abc import Callable
+from io import DEFAULT_BUFFER_SIZE, BufferedIOBase, RawIOBase
+from typing import Any, Protocol, type_check_only
+
+BUFFER_SIZE = DEFAULT_BUFFER_SIZE
+
+@type_check_only
+class _Reader(Protocol):
+    def read(self, n: int, /) -> bytes: ...
+    def seekable(self) -> bool: ...
+    def seek(self, n: int, /) -> Any: ...
+
+class BaseStream(BufferedIOBase): ...
+
+class DecompressReader(RawIOBase):
+    def __init__(
+        self,
+        fp: _Reader,
+        decomp_factory: Callable[..., Incomplete],
+        trailing_error: type[Exception] | tuple[type[Exception], ...] = (),
+        **decomp_args: Any,  # These are passed to decomp_factory.
+    ) -> None: ...
+    def readinto(self, b: WriteableBuffer) -> int: ...
+    def read(self, size: int = -1) -> bytes: ...
+    def seek(self, offset: int, whence: int = 0) -> int: ...

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

@@ -91,10 +91,14 @@ class Token(Generic[_T]):
         """See PEP 585"""
         ...
     if sys.version_info >= (3, 14):
-        def __enter__(self) -> Self: ...
+        def __enter__(self) -> Self:
+            """Enter into Token context manager."""
+            ...
         def __exit__(
             self, exc_type: type[BaseException] | None, exc_value: BaseException | None, traceback: TracebackType | None, /
-        ) -> None: ...
+        ) -> None:
+            """Exit from Token context manager, restore the linked ContextVar."""
+            ...
 
 def copy_context() -> Context: ...
 

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

@@ -154,38 +154,10 @@ class _Pointer(_PointerLike, _CData, Generic[_CT], metaclass=_PyCPointerType):
 
 if sys.version_info < (3, 14):
     @overload
-    def POINTER(type: None, /) -> type[c_void_p]:
-        """
-        Create and return a new ctypes pointer type.
-
-          type
-            A ctypes type.
-
-        Pointer types are cached and reused internally,
-        so calling this function repeatedly is cheap.
-        """
-        ...
+    def POINTER(type: None, /) -> type[c_void_p]: ...
     @overload
-    def POINTER(type: type[_CT], /) -> type[_Pointer[_CT]]:
-        """
-        Create and return a new ctypes pointer type.
-
-          type
-            A ctypes type.
-
-        Pointer types are cached and reused internally,
-        so calling this function repeatedly is cheap.
-        """
-        ...
-    def pointer(obj: _CT, /) -> _Pointer[_CT]:
-        """
-        Create a new pointer instance, pointing to 'obj'.
-
-        The returned object is of the type POINTER(type(obj)). Note that if you
-        just want to pass a pointer to an object to a foreign function call, you
-        should use byref(obj) which is much faster.
-        """
-        ...
+    def POINTER(type: type[_CT], /) -> type[_Pointer[_CT]]: ...
+    def pointer(obj: _CT, /) -> _Pointer[_CT]: ...
 
 # This class is not exposed. It calls itself _ctypes.CArgObject.
 @final
@@ -193,16 +165,12 @@ if sys.version_info < (3, 14):
 class _CArgObject: ...
 
 if sys.version_info >= (3, 14):
-    def byref(obj: _CData | _CDataType, offset: int = 0, /) -> _CArgObject: ...
+    def byref(obj: _CData | _CDataType, offset: int = 0, /) -> _CArgObject:
+        """Return a pointer lookalike to a C instance, only usable as function argument."""
+        ...
 
 else:
-    def byref(obj: _CData | _CDataType, offset: int = 0) -> _CArgObject:
-        """
-        byref(C instance[, offset=0]) -> byref-object
-        Return a pointer lookalike to a C instance, only usable
-        as function argument
-        """
-        ...
+    def byref(obj: _CData | _CDataType, offset: int = 0) -> _CArgObject: ...
 
 _ECT: TypeAlias = Callable[[_CData | _CDataType | None, CFuncPtr, tuple[_CData | _CDataType, ...]], _CDataType]
 _PF: TypeAlias = tuple[int] | tuple[int, str | None] | tuple[int, str | None, Any]
@@ -408,10 +376,7 @@ class Array(_CData, Generic[_CT], metaclass=_PyCArrayType):
         ...
 
 def addressof(obj: _CData | _CDataType, /) -> int:
-    """
-    addressof(C instance) -> integer
-    Return the address of the C instance internal buffer
-    """
+    """Return the address of the C instance internal buffer"""
     ...
 def alignment(obj_or_type: _CData | _CDataType | type[_CData | _CDataType], /) -> int:
     """
@@ -421,16 +386,10 @@ def alignment(obj_or_type: _CData | _CDataType | type[_CData | _CDataType], /) -
     """
     ...
 def get_errno() -> int: ...
-def resize(obj: _CData | _CDataType, size: int, /) -> None:
-    """Resize the memory buffer of a ctypes instance"""
-    ...
+def resize(obj: _CData | _CDataType, size: int, /) -> None: ...
 def set_errno(value: int, /) -> int: ...
 def sizeof(obj_or_type: _CData | _CDataType | type[_CData | _CDataType], /) -> int:
-    """
-    sizeof(C type) -> integer
-    sizeof(C instance) -> integer
-    Return the size in bytes of a C instance
-    """
+    """Return the size in bytes of a C instance."""
     ...
 def PyObj_FromPtr(address: int, /) -> Any: ...
 def Py_DECREF(o: _T, /) -> _T: ...

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

@@ -460,7 +460,16 @@ if sys.version_info >= (3, 10):
         ...
 
 if sys.version_info >= (3, 14):
-    def assume_default_colors(fg: int, bg: int, /) -> None: ...
+    def assume_default_colors(fg: int, bg: int, /) -> None:
+        """
+        Allow use of default values for colors on terminals supporting this feature.
+
+        Assign terminal default foreground/background colors to color number -1.
+        Change the definition of the color-pair 0 to (fg, bg).
+
+        Use this to support transparency in your application.
+        """
+        ...
 
 def has_ic() -> bool:
     """Return True if the terminal has insert- and delete-character capabilities."""
@@ -900,12 +909,7 @@ def ungetmouse(id: int, x: int, y: int, z: int, bstate: int, /) -> None:
     ...
 def update_lines_cols() -> None: ...
 def use_default_colors() -> None:
-    """
-    Allow use of default values for colors on terminals supporting this feature.
-
-    Use this to support transparency in your application.  The default color
-    is assigned to the color number -1.
-    """
+    """Equivalent to assume_default_colors(-1, -1)."""
     ...
 def use_env(flag: bool, /) -> None:
     """
@@ -1154,13 +1158,97 @@ class window:  # undocumented
         """
         ...
     @overload
-    def chgat(self, attr: int) -> None: ...
+    def chgat(self, attr: int) -> None:
+        """
+        chgat([y, x,] [n=-1,] attr)
+        Set the attributes of characters.
+
+          y
+            Y-coordinate.
+          x
+            X-coordinate.
+          n
+            Number of characters.
+          attr
+            Attributes for characters.
+
+        Set the attributes of num characters at the current cursor position, or at
+        position (y, x) if supplied.  If no value of num is given or num = -1, the
+        attribute will be set on all the characters to the end of the line.  This
+        function does not move the cursor.  The changed line will be touched using
+        the touchline() method so that the contents will be redisplayed by the next
+        window refresh.
+        """
+        ...
     @overload
-    def chgat(self, num: int, attr: int) -> None: ...
+    def chgat(self, num: int, attr: int) -> None:
+        """
+        chgat([y, x,] [n=-1,] attr)
+        Set the attributes of characters.
+
+          y
+            Y-coordinate.
+          x
+            X-coordinate.
+          n
+            Number of characters.
+          attr
+            Attributes for characters.
+
+        Set the attributes of num characters at the current cursor position, or at
+        position (y, x) if supplied.  If no value of num is given or num = -1, the
+        attribute will be set on all the characters to the end of the line.  This
+        function does not move the cursor.  The changed line will be touched using
+        the touchline() method so that the contents will be redisplayed by the next
+        window refresh.
+        """
+        ...
     @overload
-    def chgat(self, y: int, x: int, attr: int) -> None: ...
+    def chgat(self, y: int, x: int, attr: int) -> None:
+        """
+        chgat([y, x,] [n=-1,] attr)
+        Set the attributes of characters.
+
+          y
+            Y-coordinate.
+          x
+            X-coordinate.
+          n
+            Number of characters.
+          attr
+            Attributes for characters.
+
+        Set the attributes of num characters at the current cursor position, or at
+        position (y, x) if supplied.  If no value of num is given or num = -1, the
+        attribute will be set on all the characters to the end of the line.  This
+        function does not move the cursor.  The changed line will be touched using
+        the touchline() method so that the contents will be redisplayed by the next
+        window refresh.
+        """
+        ...
     @overload
-    def chgat(self, y: int, x: int, num: int, attr: int) -> None: ...
+    def chgat(self, y: int, x: int, num: int, attr: int) -> None:
+        """
+        chgat([y, x,] [n=-1,] attr)
+        Set the attributes of characters.
+
+          y
+            Y-coordinate.
+          x
+            X-coordinate.
+          n
+            Number of characters.
+          attr
+            Attributes for characters.
+
+        Set the attributes of num characters at the current cursor position, or at
+        position (y, x) if supplied.  If no value of num is given or num = -1, the
+        attribute will be set on all the characters to the end of the line.  This
+        function does not move the cursor.  The changed line will be touched using
+        the touchline() method so that the contents will be redisplayed by the next
+        window refresh.
+        """
+        ...
     def clear(self) -> None: ...
     def clearok(self, yes: int) -> None: ...
     def clrtobot(self) -> None: ...
@@ -1353,13 +1441,61 @@ class window:  # undocumented
     def getmaxyx(self) -> tuple[int, int]: ...
     def getparyx(self) -> tuple[int, int]: ...
     @overload
-    def getstr(self) -> bytes: ...
+    def getstr(self) -> bytes:
+        """
+        getstr([[y, x,] n=2047])
+        Read a string from the user, with primitive line editing capacity.
+
+          y
+            Y-coordinate.
+          x
+            X-coordinate.
+          n
+            Maximal number of characters.
+        """
+        ...
     @overload
-    def getstr(self, n: int) -> bytes: ...
+    def getstr(self, n: int) -> bytes:
+        """
+        getstr([[y, x,] n=2047])
+        Read a string from the user, with primitive line editing capacity.
+
+          y
+            Y-coordinate.
+          x
+            X-coordinate.
+          n
+            Maximal number of characters.
+        """
+        ...
     @overload
-    def getstr(self, y: int, x: int) -> bytes: ...
+    def getstr(self, y: int, x: int) -> bytes:
+        """
+        getstr([[y, x,] n=2047])
+        Read a string from the user, with primitive line editing capacity.
+
+          y
+            Y-coordinate.
+          x
+            X-coordinate.
+          n
+            Maximal number of characters.
+        """
+        ...
     @overload
-    def getstr(self, y: int, x: int, n: int) -> bytes: ...
+    def getstr(self, y: int, x: int, n: int) -> bytes:
+        """
+        getstr([[y, x,] n=2047])
+        Read a string from the user, with primitive line editing capacity.
+
+          y
+            Y-coordinate.
+          x
+            X-coordinate.
+          n
+            Maximal number of characters.
+        """
+        ...
     def getyx(self) -> tuple[int, int]: ...
     @overload
     def hline(self, ch: _ChType, n: int) -> None:
@@ -1563,9 +1699,43 @@ class window:  # undocumented
         """
         ...
     @overload
-    def instr(self, n: int = 2047) -> bytes: ...
+    def instr(self, n: int = 2047) -> bytes:
+        """
+        instr([y, x,] n=2047)
+        Return a string of characters, extracted from the window.
+
+          y
+            Y-coordinate.
+          x
+            X-coordinate.
+          n
+            Maximal number of characters.
+
+        Return a string of characters, extracted from the window starting at the
+        current cursor position, or at y, x if specified.  Attributes are stripped
+        from the characters.  If n is specified, instr() returns a string at most
+        n characters long (exclusive of the trailing NUL).
+        """
+        ...
     @overload
-    def instr(self, y: int, x: int, n: int = 2047) -> bytes: ...
+    def instr(self, y: int, x: int, n: int = 2047) -> bytes:
+        """
+        instr([y, x,] n=2047)
+        Return a string of characters, extracted from the window.
+
+          y
+            Y-coordinate.
+          x
+            X-coordinate.
+          n
+            Maximal number of characters.
+
+        Return a string of characters, extracted from the window starting at the
+        current cursor position, or at y, x if specified.  Attributes are stripped
+        from the characters.  If n is specified, instr() returns a string at most
+        n characters long (exclusive of the trailing NUL).
+        """
+        ...
     def is_linetouched(self, line: int, /) -> bool:
         """
         Return True if the specified line was modified, otherwise return False.

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

@@ -78,7 +78,13 @@ else:
     def localcontext(ctx: Context | None = None) -> _ContextManager: ...
 
 if sys.version_info >= (3, 14):
-    def IEEEContext(bits: int, /) -> Context: ...
+    def IEEEContext(bits: int, /) -> Context:
+        """
+        Return a context object initialized to the proper values for one of the
+        IEEE interchange formats.  The argument must be a multiple of 32 and less
+        than IEEE_CONTEXT_MAX_BITS.
+        """
+        ...
 
 DefaultContext: Context
 BasicContext: Context

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

@@ -67,8 +67,23 @@ def heapreplace(heap: list[_T], item: _T, /) -> _T:
     ...
 
 if sys.version_info >= (3, 14):
-    def heapify_max(heap: list[_T], /) -> None: ...
-    def heappop_max(heap: list[_T], /) -> _T: ...
-    def heappush_max(heap: list[_T], item: _T, /) -> None: ...
-    def heappushpop_max(heap: list[_T], item: _T, /) -> _T: ...
-    def heapreplace_max(heap: list[_T], item: _T, /) -> _T: ...
+    def heapify_max(heap: list[_T], /) -> None:
+        """Maxheap variant of heapify."""
+        ...
+    def heappop_max(heap: list[_T], /) -> _T:
+        """Maxheap variant of heappop."""
+        ...
+    def heappush_max(heap: list[_T], item: _T, /) -> None:
+        """Push item onto max heap, maintaining the heap invariant."""
+        ...
+    def heappushpop_max(heap: list[_T], item: _T, /) -> _T:
+        """
+        Maxheap variant of heappushpop.
+
+        The combined action runs more efficiently than heappush_max() followed by
+        a separate call to heappop_max().
+        """
+        ...
+    def heapreplace_max(heap: list[_T], item: _T, /) -> _T:
+        """Maxheap variant of heapreplace."""
+        ...

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

@@ -23,7 +23,7 @@ def bind(qid: SupportsIndex) -> None:
     ...
 def create(maxsize: SupportsIndex, fmt: SupportsIndex, unboundop: _UnboundOp) -> int:
     """
-    create(maxsize, fmt, unboundop) -> qid
+    create(maxsize, unboundop, fallback) -> qid
 
     Create a new cross-interpreter queue and return its unique generated ID.
     It is a new reference as though bind() had been called on the queue.
@@ -42,10 +42,10 @@ def destroy(qid: SupportsIndex) -> None:
     ...
 def get(qid: SupportsIndex) -> tuple[Any, int, _UnboundOp | None]:
     """
-    get(qid) -> (obj, fmt)
+    get(qid) -> (obj, unboundop)
 
     Return a new object from the data at the front of the queue.
-    The object's format is also returned.
+    The unbound op is also returned.
 
     If there is nothing to receive then raise QueueEmpty.
     """
@@ -80,15 +80,15 @@ def is_full(qid: SupportsIndex) -> bool:
     ...
 def list_all() -> list[tuple[int, int, _UnboundOp]]:
     """
-    list_all() -> [(qid, fmt)]
+    list_all() -> [(qid, unboundop, fallback)]
 
     Return the list of IDs for all queues.
-    Each corresponding default format is also included.
+    Each corresponding default unbound op and fallback is also included.
     """
     ...
 def put(qid: SupportsIndex, obj: Any, fmt: SupportsIndex, unboundop: _UnboundOp) -> None:
     """
-    put(qid, obj, fmt)
+    put(qid, obj)
 
     Add the object's data to the queue.
     """

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

@@ -49,7 +49,7 @@ def create(config: types.SimpleNamespace | _Configs | None = "isolated", *, reqr
     The caller is responsible for destroying the interpreter before exiting,
     typically by using _interpreters.destroy().  This can be managed 
     automatically by passing "reqrefs=True" and then using _incref() and
-    _decref()` appropriately.
+    _decref() appropriately.
 
     "config" must be a valid interpreter config or the name of a
     predefined config ("isolated" or "legacy").  The default
@@ -143,12 +143,6 @@ def call(
 
     Call the provided object in the identified interpreter.
     Pass the given args and kwargs, if possible.
-
-    "callable" may be a plain function with no free vars that takes
-    no arguments.
-
-    The function's code object is used and all its state
-    is ignored, including its __globals__ dict.
     """
     ...
 def run_string(

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

@@ -30,8 +30,7 @@ data:
 DEFAULT_BUFFER_SIZE
 
    An int containing the default buffer size used by the module's buffered
-   I/O classes. open() uses the file's blksize (as obtained by os.stat) if
-   possible.
+   I/O classes.
 """
 
 import builtins
@@ -377,9 +376,14 @@ class FileIO(RawIOBase, _RawIOBase, BinaryIO):  # type: ignore[misc]  # incompat
         """
         Read at most size bytes, returned as bytes.
 
-        Only makes one system call, so less data may be returned than requested.
-        In non-blocking mode, returns None if no data is available.
-        Return an empty bytes object at EOF.
+        If size is less than 0, read all bytes in the file making multiple read calls.
+        See ``FileIO.readall``.
+
+        Attempts to make only one system call, retrying only per PEP 475 (EINTR). This
+        means less data may be returned than requested.
+
+        In non-blocking mode, returns None if no data is available. Return an empty
+        bytes object at EOF.
         """
         ...
 

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

@@ -10,12 +10,11 @@ from typing_extensions import disjoint_base
 @disjoint_base
 class Profiler:
     """
-    Profiler(timer=None, timeunit=None, subcalls=True, builtins=True)
+    Build a profiler object using the specified timer function.
 
-    Builds a profiler object using the specified timer function.
     The default timer is a fast built-in one based on real time.
-    For custom timer functions returning integers, timeunit can
-    be a float specifying a scale (i.e. how long each integer unit
+    For custom timer functions returning integers, 'timeunit' can
+    be a float specifying a scale (that is, how long each integer unit
     is, in seconds).
     """
     def __init__(
@@ -50,28 +49,21 @@ class Profiler:
         ...
     def enable(self, subcalls: bool = True, builtins: bool = True) -> None:
         """
-        enable(subcalls=True, builtins=True)
-
         Start collecting profiling information.
-        If 'subcalls' is True, also records for each function
-        statistics separated according to its current caller.
-        If 'builtins' is True, records the time spent in
-        built-in functions separately from their caller.
+
+        subcalls
+          If True, also records for each function
+          statistics separated according to its current caller.
+        builtins
+          If True, records the time spent in
+          built-in functions separately from their caller.
         """
         ...
     def disable(self) -> None:
-        """
-        disable()
-
-        Stop collecting profiling information.
-        """
+        """Stop collecting profiling information."""
         ...
     def clear(self) -> None:
-        """
-        clear()
-
-        Clear all profiling information collected so far.
-        """
+        """Clear all profiling information collected so far."""
         ...
 
 @final

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

@@ -264,5 +264,9 @@ def _compare_digest(a: AnyStr, b: AnyStr, /) -> bool:
     ...
 
 if sys.version_info >= (3, 14):
-    def is_none(a: object, /) -> TypeIs[None]: ...
-    def is_not_none(a: _T | None, /) -> TypeIs[_T]: ...
+    def is_none(a: object, /) -> TypeIs[None]:
+        """Same as a is None."""
+        ...
+    def is_not_none(a: _T | None, /) -> TypeIs[_T]:
+        """Same as a is not None."""
+        ...

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

@@ -37,7 +37,7 @@ def dump(
 
     The optional *protocol* argument tells the pickler to use the given
     protocol; supported protocols are 0, 1, 2, 3, 4 and 5.  The default
-    protocol is 4. It was introduced in Python 3.4, and is incompatible
+    protocol is 5. It was introduced in Python 3.8, and is incompatible
     with previous versions.
 
     Specifying a negative protocol version selects the highest protocol
@@ -66,7 +66,7 @@ def dumps(
 
     The optional *protocol* argument tells the pickler to use the given
     protocol; supported protocols are 0, 1, 2, 3, 4 and 5.  The default
-    protocol is 4. It was introduced in Python 3.4, and is incompatible
+    protocol is 5. It was introduced in Python 3.8, and is incompatible
     with previous versions.
 
     Specifying a negative protocol version selects the highest protocol
@@ -159,7 +159,7 @@ class Pickler:
 
     The optional *protocol* argument tells the pickler to use the given
     protocol; supported protocols are 0, 1, 2, 3, 4 and 5.  The default
-    protocol is 4. It was introduced in Python 3.4, and is incompatible
+    protocol is 5. It was introduced in Python 3.8, and is incompatible
     with previous versions.
 
     Specifying a negative protocol version selects the highest protocol