basedpyright 1.15.2 → 1.16.0

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

@@ -33,6 +33,8 @@ if sys.version_info >= (3, 10):
 
         Optional args lo (default 0) and hi (default len(a)) bound the
         slice of a to be searched.
+
+        A custom key function can be supplied to customize the sort order.
         """
         ...
     @overload
@@ -53,6 +55,8 @@ if sys.version_info >= (3, 10):
 
         Optional args lo (default 0) and hi (default len(a)) bound the
         slice of a to be searched.
+
+        A custom key function can be supplied to customize the sort order.
         """
         ...
     @overload
@@ -73,6 +77,8 @@ if sys.version_info >= (3, 10):
 
         Optional args lo (default 0) and hi (default len(a)) bound the
         slice of a to be searched.
+
+        A custom key function can be supplied to customize the sort order.
         """
         ...
     @overload
@@ -93,6 +99,8 @@ if sys.version_info >= (3, 10):
 
         Optional args lo (default 0) and hi (default len(a)) bound the
         slice of a to be searched.
+
+        A custom key function can be supplied to customize the sort order.
         """
         ...
     @overload
@@ -111,6 +119,8 @@ if sys.version_info >= (3, 10):
 
         Optional args lo (default 0) and hi (default len(a)) bound the
         slice of a to be searched.
+
+        A custom key function can be supplied to customize the sort order.
         """
         ...
     @overload
@@ -124,6 +134,8 @@ if sys.version_info >= (3, 10):
 
         Optional args lo (default 0) and hi (default len(a)) bound the
         slice of a to be searched.
+
+        A custom key function can be supplied to customize the sort order.
         """
         ...
     @overload
@@ -142,6 +154,8 @@ if sys.version_info >= (3, 10):
 
         Optional args lo (default 0) and hi (default len(a)) bound the
         slice of a to be searched.
+
+        A custom key function can be supplied to customize the sort order.
         """
         ...
     @overload
@@ -155,6 +169,8 @@ if sys.version_info >= (3, 10):
 
         Optional args lo (default 0) and hi (default len(a)) bound the
         slice of a to be searched.
+
+        A custom key function can be supplied to customize the sort order.
         """
         ...
 
@@ -163,8 +179,6 @@ else:
         a: SupportsLenAndGetItem[SupportsRichComparisonT], x: SupportsRichComparisonT, lo: int = 0, hi: int | None = None
     ) -> int:
         """
-        bisect_left(a, x[, lo[, hi]]) -> index
-
         Return the index where to insert item x in list a, assuming a is sorted.
 
         The return value i is such that all e in a[:i] have e < x, and all e in
@@ -179,8 +193,6 @@ else:
         a: SupportsLenAndGetItem[SupportsRichComparisonT], x: SupportsRichComparisonT, lo: int = 0, hi: int | None = None
     ) -> int:
         """
-        bisect_right(a, x[, lo[, hi]]) -> index
-
         Return the index where to insert item x in list a, assuming a is sorted.
 
         The return value i is such that all e in a[:i] have e <= x, and all e in
@@ -195,8 +207,6 @@ else:
         a: MutableSequence[SupportsRichComparisonT], x: SupportsRichComparisonT, lo: int = 0, hi: int | None = None
     ) -> None:
         """
-        insort_left(a, x[, lo[, hi]])
-
         Insert item x in list a, and keep it sorted assuming a is sorted.
 
         If x is already in a, insert it to the left of the leftmost x.
@@ -209,8 +219,6 @@ else:
         a: MutableSequence[SupportsRichComparisonT], x: SupportsRichComparisonT, lo: int = 0, hi: int | None = None
     ) -> None:
         """
-        insort_right(a, x[, lo[, hi]])
-
         Insert item x in list a, and keep it sorted assuming a is sorted.
 
         If x is already in a, insert it to the right of the rightmost x.

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

@@ -33,9 +33,9 @@ SETTINGS:
         quoting character.  It defaults to '"'.
     * delimiter - specifies a one-character string to use as the
         field separator.  It defaults to ','.
-    * skipinitialspace - specifies how to interpret whitespace which
-        immediately follows a delimiter.  It defaults to False, which
-        means that whitespace immediately following a delimiter is part
+    * skipinitialspace - specifies how to interpret spaces which
+        immediately follow a delimiter.  It defaults to False, which
+        means that spaces immediately following a delimiter is part
         of the following field.
     * lineterminator -  specifies the character sequence which should
         terminate rows.
@@ -48,6 +48,11 @@ SETTINGS:
         csv.QUOTE_NONNUMERIC means that quotes are always placed around
             fields which do not parse as integers or floating point
             numbers.
+        csv.QUOTE_STRINGS means that quotes are always placed around
+            fields which are strings.  Note that the Python value None
+            is not a string.
+        csv.QUOTE_NOTNULL means that quotes are only placed around fields
+            that are not the Python value None.
         csv.QUOTE_NONE means that quotes are never placed around fields.
     * escapechar - specifies a one-character string used to escape
         the delimiter when quoting is set to QUOTE_NONE.
@@ -187,24 +192,28 @@ def register_dialect(
 def unregister_dialect(name: str) -> None:
     """
     Delete the name/dialect mapping associated with a string name.
+
     csv.unregister_dialect(name)
     """
     ...
 def get_dialect(name: str) -> Dialect:
     """
     Return the dialect instance associated with name.
+
     dialect = csv.get_dialect(name)
     """
     ...
 def list_dialects() -> list[str]:
     """
-    Return a list of all know dialect names.
+    Return a list of all known dialect names.
+
     names = csv.list_dialects()
     """
     ...
 def field_size_limit(new_limit: int = ...) -> int:
     """
     Sets an upper limit on parsed fields.
+
         csv.field_size_limit([limit])
 
     Returns old limit. If limit is not given, no new limit is set and

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

@@ -666,7 +666,7 @@ def pair_content(pair_number: int, /) -> tuple[int, int]:
     Return a tuple (fg, bg) containing the colors for the requested color pair.
 
     pair_number
-      The number of the color pair (1 - (COLOR_PAIRS-1)).
+      The number of the color pair (0 - (COLOR_PAIRS-1)).
     """
     ...
 def pair_number(attr: int, /) -> int:

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

@@ -15,6 +15,7 @@ __version__: Final[str]
 __libmpdec_version__: Final[str]
 
 class DecimalTuple(NamedTuple):
+    """DecimalTuple(sign, digits, exponent)"""
     sign: int
     digits: tuple[int, ...]
     exponent: int | Literal["n", "N", "F"]
@@ -88,6 +89,12 @@ else:
         ...
 
 class Decimal:
+    """
+    Construct a new Decimal object. 'value' can be an integer, string, tuple,
+    or another Decimal object. If no value is given, return Decimal('0'). The
+    context does not affect the conversion and is only passed to determine if
+    the InvalidOperation trap is active.
+    """
     def __new__(cls, value: _DecimalNew = ..., context: Context | None = ...) -> Self: ...
     @classmethod
     def from_float(cls, f: float, /) -> Self:
@@ -107,7 +114,7 @@ class Decimal:
         """
         ...
     def __bool__(self) -> bool:
-        """self != 0"""
+        """True if self else False"""
         ...
     def compare(self, other: _Decimal, context: Context | None = None) -> Decimal:
         """
@@ -607,6 +614,17 @@ class _ContextManager:
 _TrapType: TypeAlias = type[DecimalException]
 
 class Context:
+    """
+    The context affects almost all operations and controls rounding,
+    Over/Underflow, raising of exceptions and much more.  A new context
+    can be constructed as follows:
+
+        >>> c = Context(prec=28, Emin=-425000000, Emax=425000000,
+        ...             rounding=ROUND_HALF_EVEN, capitals=1, clamp=1,
+        ...             traps=[InvalidOperation, DivisionByZero, Overflow],
+        ...             flags=[])
+        >>>
+    """
     # TODO: Context doesn't allow you to delete *any* attributes from instances of the class at runtime,
     # even settable attributes like `prec` and `rounding`,
     # but that's inexpressable in the stub.

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

@@ -1,4 +1,4 @@
-"""(Extremely) low-level import machinery bits as used by importlib and imp."""
+"""(Extremely) low-level import machinery bits as used by importlib."""
 
 import sys
 import types

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

@@ -13,10 +13,10 @@ LC_ALL: int
 CHAR_MAX: int
 
 def setlocale(category: int, locale: str | None = None, /) -> str:
-    """(integer,string=None) -> string. Activates/queries locale processing."""
+    """Activates/queries locale processing."""
     ...
 def localeconv() -> Mapping[str, int | str | list[int]]:
-    """() -> dict. Returns numeric and monetary locale-specific parameters."""
+    """Returns numeric and monetary locale-specific parameters."""
     ...
 
 if sys.version_info >= (3, 11):
@@ -25,14 +25,10 @@ if sys.version_info >= (3, 11):
         ...
 
 def strcoll(os1: str, os2: str, /) -> int:
-    """string,string -> int. Compares two strings according to the locale."""
+    """Compares two strings according to the locale."""
     ...
 def strxfrm(string: str, /) -> str:
-    """
-    strxfrm(string) -> string.
-
-    Return a string that can be used as a key for locale-aware comparisons.
-    """
+    """Return a string that can be used as a key for locale-aware comparisons."""
     ...
 
 # native gettext functions
@@ -104,10 +100,7 @@ if sys.platform != "win32":
     ALT_DIGITS: int
 
     def nl_langinfo(key: int, /) -> str:
-        """
-        nl_langinfo(key) -> string
-        Return the value for the locale information associated with key.
-        """
+        """Return the value for the locale information associated with key."""
         ...
 
     # This is dependent on `libintl.h` which is a part of `gettext`
@@ -116,36 +109,26 @@ if sys.platform != "win32":
     def gettext(msg: str, /) -> str:
         """
         gettext(msg) -> string
+
         Return translation of msg.
         """
         ...
     def dgettext(domain: str | None, msg: str, /) -> str:
         """
         dgettext(domain, msg) -> string
+
         Return translation of msg in domain.
         """
         ...
     def dcgettext(domain: str | None, msg: str, category: int, /) -> str:
-        """
-        dcgettext(domain, msg, category) -> string
-        Return translation of msg in domain and category.
-        """
+        """Return translation of msg in domain and category."""
         ...
     def textdomain(domain: str | None, /) -> str:
-        """
-        textdomain(domain) -> string
-        Set the C library's textdmain to domain, returning the new domain.
-        """
+        """Set the C library's textdmain to domain, returning the new domain."""
         ...
     def bindtextdomain(domain: str, dir: StrPath | None, /) -> str:
-        """
-        bindtextdomain(domain, dir) -> string
-        Bind the C library's domain to dir.
-        """
+        """Bind the C library's domain to dir."""
         ...
     def bind_textdomain_codeset(domain: str, codeset: str | None, /) -> str | None:
-        """
-        bind_textdomain_codeset(domain, codeset) -> string
-        Bind the C library's domain to codeset.
-        """
+        """Bind the C library's domain to codeset."""
         ...

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

@@ -21,6 +21,8 @@ class Profiler:
     ) -> None: ...
     def getstats(self) -> list[profiler_entry]:
         """
+        list of profiler_entry objects.
+
         getstats() -> list of profiler_entry objects
 
         Return all information collected by the profiler.

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

@@ -146,7 +146,7 @@ def contains(a: Container[object], b: object, /) -> bool:
     """Same as b in a (note reversed operands)."""
     ...
 def countOf(a: Iterable[object], b: object, /) -> int:
-    """Return the number of times b occurs in a."""
+    """Return the number of items in a which are, or which equal, b."""
     ...
 @overload
 def delitem(a: MutableSequence[Any], b: SupportsIndex, /) -> None:

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

@@ -34,16 +34,18 @@ if sys.platform != "win32":
         /,
     ) -> int:
         """
-        fork_exec(args, executable_list, close_fds, cwd, env,
-                  p2cread, p2cwrite, c2pread, c2pwrite,
-                  errread, errwrite, errpipe_read, errpipe_write,
-                  restore_signals, call_setsid, preexec_fn)
+        Spawn a fresh new child process.
 
-        Forks a child process, closes parent file descriptors as appropriate in the
-        child and dups the few that are needed before calling exec() in the child
-        process.
+        Fork a child process, close parent file descriptors as appropriate in the
+        child and duplicate the few that are needed before calling exec() in the
+        child process.
+
+        If close_fds is True, close file descriptors 3 and higher, except those listed
+        in the sorted tuple pass_fds.
+
+        The preexec_fn, if supplied, will be called immediately before closing file
+        descriptors and exec.
 
-        The preexec_fn, if supplied, will be called immediately before exec.
         WARNING: preexec_fn is NOT SAFE if your application uses threads.
                  It may trigger infrequent, difficult to debug deadlocks.
 

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

@@ -725,14 +725,11 @@ class socket:
     sendall(data[, flags]) -- send all data
     send(data[, flags]) -- send data, may not send all of it
     sendto(data[, flags], addr) -- send data to a given address
-    setblocking(0 | 1) -- set or clear the blocking I/O flag
+    setblocking(bool) -- set or clear the blocking I/O flag
     getblocking() -- return True if socket is blocking, False if non-blocking
     setsockopt(level, optname, value[, optlen]) -- set socket options
     settimeout(None | float) -- set or clear the timeout
     shutdown(how) -- shut down traffic in one or both directions
-    if_nameindex() -- return all network interface indices and names
-    if_nametoindex(name) -- return the corresponding interface index
-    if_indextoname(index) -- return the corresponding interface name
 
      [*] not available on all platforms!
     """
@@ -821,7 +818,8 @@ class socket:
 
         Return the address of the local endpoint. The format depends on the
         address family. For IPv4 sockets, the address info is a pair
-        (hostaddr, port).
+        (hostaddr, port). For IPv6 sockets, the address info is a 4-tuple
+        (hostaddr, port, flowinfo, scope_id).
         """
         ...
     @overload
@@ -1214,11 +1212,6 @@ def ntohs(x: int, /) -> int:
     ntohs(integer) -> integer
 
     Convert a 16-bit unsigned integer from network to host byte order.
-    Note that in case the received integer does not fit in 16-bit unsigned
-    integer, but does fit in a positive C int, it is silently truncated to
-    16-bit unsigned integer.
-    However, this silent truncation feature is deprecated, and will raise an
-    exception in future versions of Python.
     """
     ...
 def htonl(x: int, /) -> int:
@@ -1233,11 +1226,6 @@ def htons(x: int, /) -> int:
     htons(integer) -> integer
 
     Convert a 16-bit unsigned integer from host to network byte order.
-    Note that in case the received integer does not fit in 16-bit unsigned
-    integer, but does fit in a positive C int, it is silently truncated to
-    16-bit unsigned integer.
-    However, this silent truncation feature is deprecated, and will raise an
-    exception in future versions of Python.
     """
     ...
 def inet_aton(ip_addr: str, /) -> bytes:

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

@@ -129,10 +129,14 @@ def start_new_thread(function: Callable[..., object], args: tuple[Any, ...], kwa
     ...
 def interrupt_main() -> None:
     """
-    interrupt_main()
+    interrupt_main(signum=signal.SIGINT, /)
 
-    Raise a KeyboardInterrupt in the main thread.
+    Simulate the arrival of the given signal in the main thread,
+    where the corresponding signal handler will be executed.
+    If *signum* is omitted, SIGINT is assumed.
     A subthread can use this function to interrupt the main thread.
+
+    Note: the default signal handler for SIGINT raises ``KeyboardInterrupt``.
     """
     ...
 def exit() -> NoReturn:

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

@@ -85,7 +85,7 @@ def warn_explicit(
     module_globals: dict[str, Any] | None = ...,
     source: Any | None = ...,
 ) -> None:
-    """Low-level interface to warnings functionality."""
+    """Issue a warning, or maybe ignore it or raise an exception."""
     ...
 @overload
 def warn_explicit(
@@ -98,5 +98,5 @@ def warn_explicit(
     module_globals: dict[str, Any] | None = ...,
     source: Any | None = ...,
 ) -> None:
-    """Low-level interface to warnings functionality."""
+    """Issue a warning, or maybe ignore it or raise an exception."""
     ...

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

@@ -50,26 +50,25 @@ def getweakrefcount(object: Any, /) -> int:
     """Return the number of weak references to 'object'."""
     ...
 def getweakrefs(object: Any, /) -> list[Any]:
-    """
-    getweakrefs(object) -- return a list of all weak reference objects
-    that point to 'object'.
-    """
+    """Return a list of all weak reference objects pointing to 'object'."""
     ...
 
 # Return CallableProxyType if object is callable, ProxyType otherwise
 @overload
 def proxy(object: _C, callback: Callable[[_C], Any] | None = None, /) -> CallableProxyType[_C]:
     """
-    proxy(object[, callback]) -- create a proxy object that weakly
-    references 'object'.  'callback', if given, is called with a
-    reference to the proxy when 'object' is about to be finalized.
+    Create a proxy object that weakly references 'object'.
+
+    'callback', if given, is called with a reference to the
+    proxy when 'object' is about to be finalized.
     """
     ...
 @overload
 def proxy(object: _T, callback: Callable[[_T], Any] | None = None, /) -> Any:
     """
-    proxy(object[, callback]) -- create a proxy object that weakly
-    references 'object'.  'callback', if given, is called with a
-    reference to the proxy when 'object' is about to be finalized.
+    Create a proxy object that weakly references 'object'.
+
+    'callback', if given, is called with a reference to the
+    proxy when 'object' is about to be finalized.
     """
     ...

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

@@ -132,7 +132,7 @@ class array(MutableSequence[_T]):
         """Append items to the end of the array."""
         ...
     def frombytes(self, buffer: ReadableBuffer, /) -> None:
-        """Appends items from the string, interpreting it as an array of machine values, as if it had been read from a file using the fromfile() method)."""
+        """Appends items from the string, interpreting it as an array of machine values, as if it had been read from a file using the fromfile() method."""
         ...
     def fromfile(self, f: SupportsRead[bytes], n: int, /) -> None:
         """Read n objects from the file object f and append them to the end of the array."""

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

@@ -1,5 +1,6 @@
 """
-allow programmer to define multiple exit functions to be executedupon normal program termination.
+allow programmer to define multiple exit functions to be executed
+upon normal program termination.
 
 Two public functions, register and unregister, are defined.
 """
@@ -30,6 +31,8 @@ def _run_exitfuncs() -> None:
     _run_exitfuncs() -> None
 
     Run all registered exit functions.
+
+    If a callback raises an exception, it is logged with sys.unraisablehook.
     """
     ...
 def register(func: Callable[_P, _T], /, *args: _P.args, **kwargs: _P.kwargs) -> Callable[_P, _T]: