basedpyright 1.40.1 → 1.40.2

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

@@ -13,7 +13,14 @@ def disable() -> None:
 if sys.version_info >= (3, 15):
     def dump_traceback(
         file: FileDescriptorLike = sys.stderr, all_threads: bool = True, *, max_threads: int | None = None
-    ) -> None: ...
+    ) -> None:
+        """
+        Dump the traceback of the current thread into file.
+
+        Dump the traceback of all threads if all_threads is true. max_threads
+        caps the number of threads dumped.
+        """
+        ...
 
 else:
     def dump_traceback(file: FileDescriptorLike = sys.stderr, all_threads: bool = True) -> None:
@@ -33,7 +40,15 @@ if sys.version_info >= (3, 15):
         exit: bool = False,
         *,
         max_threads: int | None = None,
-    ) -> None: ...
+    ) -> None:
+        """
+        Dump the traceback of all threads in timeout seconds.
+
+        If repeat is true, the tracebacks of all threads are dumped every
+        timeout seconds.  If exit is true, call _exit(1) which is not safe.
+        max_threads caps the number of threads dumped.
+        """
+        ...
 
 else:
     def dump_traceback_later(
@@ -48,7 +63,9 @@ else:
 if sys.version_info >= (3, 15):
     def enable(
         file: FileDescriptorLike = sys.stderr, all_threads: bool = True, c_stack: bool = True, *, max_threads: int | None = None
-    ) -> None: ...
+    ) -> None:
+        """Enable the fault handler."""
+        ...
 
 elif sys.version_info >= (3, 14):
     def enable(file: FileDescriptorLike = sys.stderr, all_threads: bool = True, c_stack: bool = True) -> None:
@@ -73,7 +90,15 @@ if sys.platform != "win32":
             chain: bool = False,
             *,
             max_threads: int | None = None,
-        ) -> None: ...
+        ) -> None:
+            """
+            Register a handler for the signal 'signum'.
+
+            Dump the traceback of the current thread, or of all threads if
+            all_threads is True, into file. max_threads caps the number of threads
+            dumped.
+            """
+            ...
     else:
         def register(
             signum: int, file: FileDescriptorLike = sys.stderr, all_threads: bool = True, chain: bool = False

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

@@ -158,8 +158,7 @@ if sys.platform != "win32":
 
         If arg is given as a bytes-like object, the return value of fcntl() is a
         bytes object of that length, containing the resulting value put in the
-        arg buffer by the operating system.  The length of the arg buffer is not
-        allowed to exceed 1024 bytes.
+        arg buffer by the operating system.
         """
         ...
     @overload
@@ -180,8 +179,7 @@ if sys.platform != "win32":
 
         If arg is given as a bytes-like object, the return value of fcntl() is a
         bytes object of that length, containing the resulting value put in the
-        arg buffer by the operating system.  The length of the arg buffer is not
-        allowed to exceed 1024 bytes.
+        arg buffer by the operating system.
         """
         ...
 
@@ -215,8 +213,7 @@ if sys.platform != "win32":
         If the argument is an immutable buffer then a copy of the buffer is
         passed to the operating system and the return value is a bytes object of
         the same length containing whatever the operating system put in the
-        buffer.  The length of the arg buffer in this case is not allowed to
-        exceed 1024 bytes.
+        buffer.
         """
         ...
     # The return type works as follows:
@@ -253,8 +250,7 @@ if sys.platform != "win32":
         If the argument is an immutable buffer then a copy of the buffer is
         passed to the operating system and the return value is a bytes object of
         the same length containing whatever the operating system put in the
-        buffer.  The length of the arg buffer in this case is not allowed to
-        exceed 1024 bytes.
+        buffer.
         """
         ...
     @overload
@@ -286,8 +282,7 @@ if sys.platform != "win32":
         If the argument is an immutable buffer then a copy of the buffer is
         passed to the operating system and the return value is a bytes object of
         the same length containing whatever the operating system put in the
-        buffer.  The length of the arg buffer in this case is not allowed to
-        exceed 1024 bytes.
+        buffer.
         """
         ...
     @overload
@@ -319,8 +314,7 @@ if sys.platform != "win32":
         If the argument is an immutable buffer then a copy of the buffer is
         passed to the operating system and the return value is a bytes object of
         the same length containing whatever the operating system put in the
-        buffer.  The length of the arg buffer in this case is not allowed to
-        exceed 1024 bytes.
+        buffer.
         """
         ...
 

package/dist/typeshed-fallback/stdlib/importlib/metadata/__init__.pyi

@@ -272,6 +272,8 @@ class Distribution(_distribution_parent):
 
         Custom providers may provide the METADATA file or override this
         property.
+
+        :raises MetadataNotFound: If no metadata file is present.
         """
         ...
     @property

package/dist/typeshed-fallback/stdlib/json/encoder.pyi

@@ -11,18 +11,10 @@ INFINITY: Final[float]  # undocumented
 def py_encode_basestring(s: str) -> str: ...  # undocumented
 def py_encode_basestring_ascii(s: str) -> str: ...  # undocumented
 def encode_basestring(s: str, /) -> str:
-    """
-    encode_basestring(string) -> string
-
-    Return a JSON representation of a Python string
-    """
+    """Return a JSON representation of a Python string"""
     ...
 def encode_basestring_ascii(s: str, /) -> str:
-    """
-    encode_basestring_ascii(string) -> string
-
-    Return an ASCII-only JSON representation of a Python string
-    """
+    """Return an ASCII-only JSON representation of a Python string"""
     ...
 
 class JSONEncoder:

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

@@ -58,8 +58,39 @@ _Marshallable: TypeAlias = (
 )
 
 if sys.version_info >= (3, 15):
-    def dump(value: _Marshallable, file: SupportsWrite[bytes], version: int = 6, /, *, allow_code: bool = True) -> None: ...
-    def dumps(value: _Marshallable, version: int = 6, /, *, allow_code: bool = True) -> bytes: ...
+    def dump(value: _Marshallable, file: SupportsWrite[bytes], version: int = 6, /, *, allow_code: bool = True) -> None:
+        """
+        Write the value on the open file.
+
+          value
+            Must be a supported type.
+          file
+            Must be a writeable binary file.
+          version
+            Indicates the data format that dump should use.
+          allow_code
+            Allow to write code objects.
+
+        If the value has (or contains an object that has) an unsupported type, a
+        ValueError exception is raised - but garbage data will also be written
+        to the file. The object will not be properly read back by load().
+        """
+        ...
+    def dumps(value: _Marshallable, version: int = 6, /, *, allow_code: bool = True) -> bytes:
+        """
+        Return the bytes object that would be written to a file by dump(value, file).
+
+          value
+            Must be a supported type.
+          version
+            Indicates the data format that dumps should use.
+          allow_code
+            Allow to write code objects.
+
+        Raise a ValueError exception if value has (or contains an object that
+        has) an unsupported type.
+        """
+        ...
 
 elif sys.version_info >= (3, 14):
     def dump(value: _Marshallable, file: SupportsWrite[bytes], version: int = 5, /, *, allow_code: bool = True) -> None:

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

@@ -94,7 +94,6 @@ def comb(n: SupportsIndex, k: SupportsIndex, /) -> int:
     to the coefficient of k-th term in polynomial expansion of the
     expression (1 + x)**n.
 
-    Raises TypeError if either of the arguments are not integers.
     Raises ValueError if either of the arguments are negative.
     """
     ...
@@ -185,8 +184,12 @@ def fmod(x: _SupportsFloatOrIndex, y: _SupportsFloatOrIndex, /) -> float:
     ...
 
 if sys.version_info >= (3, 15):
-    def fmax(x: _SupportsFloatOrIndex, y: _SupportsFloatOrIndex, /) -> float: ...
-    def fmin(x: _SupportsFloatOrIndex, y: _SupportsFloatOrIndex, /) -> float: ...
+    def fmax(x: _SupportsFloatOrIndex, y: _SupportsFloatOrIndex, /) -> float:
+        """Return the larger of two floating-point arguments."""
+        ...
+    def fmin(x: _SupportsFloatOrIndex, y: _SupportsFloatOrIndex, /) -> float:
+        """Return the smaller of two floating-point arguments."""
+        ...
 
 def frexp(x: _SupportsFloatOrIndex, /) -> tuple[float, int]:
     """
@@ -264,8 +267,12 @@ def isnan(x: _SupportsFloatOrIndex, /) -> bool:
     ...
 
 if sys.version_info >= (3, 15):
-    def isnormal(x: _SupportsFloatOrIndex, /) -> bool: ...
-    def issubnormal(x: _SupportsFloatOrIndex, /) -> bool: ...
+    def isnormal(x: _SupportsFloatOrIndex, /) -> bool:
+        """Return True if x is normal, and False otherwise."""
+        ...
+    def issubnormal(x: _SupportsFloatOrIndex, /) -> bool:
+        """Return True if x is subnormal, and False otherwise."""
+        ...
 
 def isqrt(n: SupportsIndex, /) -> int:
     """Return the integer part of the square root of the input."""
@@ -339,7 +346,6 @@ def perm(n: SupportsIndex, k: SupportsIndex | None = None, /) -> int:
     If k is not specified or is None, then k defaults to n
     and the function returns n!.
 
-    Raises TypeError if either of the arguments are not integers.
     Raises ValueError if either of the arguments are negative.
     """
     ...
@@ -418,7 +424,9 @@ def sin(x: _SupportsFloatOrIndex, /) -> float:
     ...
 
 if sys.version_info >= (3, 15):
-    def signbit(x: _SupportsFloatOrIndex, /) -> bool: ...
+    def signbit(x: _SupportsFloatOrIndex, /) -> bool:
+        """Return True if the sign of x is negative and False otherwise."""
+        ...
 
 def sinh(x: _SupportsFloatOrIndex, /) -> float:
     """Return the hyperbolic sine of x."""

package/dist/typeshed-fallback/stdlib/math/integer.pyi

@@ -1,8 +1,43 @@
-from typing import SupportsIndex
-
-def comb(n: SupportsIndex, k: SupportsIndex, /) -> int: ...
-def factorial(n: SupportsIndex, /) -> int: ...
-def gcd(*integers: SupportsIndex) -> int: ...
-def isqrt(n: SupportsIndex, /) -> int: ...
-def lcm(*integers: SupportsIndex) -> int: ...
-def perm(n: SupportsIndex, k: SupportsIndex | None = None, /) -> int: ...
+"""This module provides access to integer related mathematical functions."""
+
+from typing import SupportsIndex
+
+def comb(n: SupportsIndex, k: SupportsIndex, /) -> int:
+    """
+    Number of ways to choose k items from n items without repetition and without order.
+
+    Evaluates to n! / (k! * (n - k)!) when k <= n and evaluates
+    to zero when k > n.
+
+    Also called the binomial coefficient because it is equivalent
+    to the coefficient of k-th term in polynomial expansion of the
+    expression (1 + x)**n.
+
+    Raises ValueError if either of the arguments are negative.
+    """
+    ...
+def factorial(n: SupportsIndex, /) -> int:
+    """Find n!."""
+    ...
+def gcd(*integers: SupportsIndex) -> int:
+    """Greatest Common Divisor."""
+    ...
+def isqrt(n: SupportsIndex, /) -> int:
+    """Return the integer part of the square root of the input."""
+    ...
+def lcm(*integers: SupportsIndex) -> int:
+    """Least Common Multiple."""
+    ...
+def perm(n: SupportsIndex, k: SupportsIndex | None = None, /) -> int:
+    """
+    Number of ways to choose k items from n items without repetition and with order.
+
+    Evaluates to n! / (n - k)! when k <= n and evaluates
+    to zero when k > n.
+
+    If k is not specified or is None, then k defaults to n
+    and the function returns n!.
+
+    Raises ValueError if either of the arguments are negative.
+    """
+    ...

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

@@ -37,7 +37,7 @@ PAGESIZE: Final[int]
 @disjoint_base
 class mmap:
     """
-    Windows: mmap(fileno, length[, tagname[, access[, offset]]])
+    Windows: mmap(fileno, length[, tagname[, access[, offset[, trackfd]]]])
 
     Maps length bytes from the file specified by the file handle fileno,
     and returns a mmap object.  If length is larger than the current size

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

@@ -1653,6 +1653,7 @@ if sys.platform != "win32":
 
         - RWF_HIPRI
         - RWF_NOWAIT
+        - RWF_DONTCACHE
 
         Using non-zero flags requires Linux 4.6 or newer.
         """
@@ -1675,6 +1676,8 @@ if sys.platform != "win32":
         - RWF_DSYNC
         - RWF_SYNC
         - RWF_APPEND
+        - RWF_DONTCACHE
+        - RWF_ATOMIC
 
         Using non-zero flags requires Linux 4.7 or newer.
         """
@@ -1829,8 +1832,8 @@ def access(
       NotImplementedError.
 
     Note that most operations will use the effective uid/gid, therefore this
-      routine can be used in a suid/sgid environment to test if the invoking user
-      has the specified access to the path.
+      routine can be used in a suid/sgid environment to test if the invoking
+      user has the specified access to the path.
     """
     ...
 def chdir(path: FileDescriptorOrPath) -> None:
@@ -2480,6 +2483,7 @@ if sys.platform != "win32":
         Like fork(), return pid of 0 to the child process,
         and pid of child to the parent process.
         To both, return fd of newly opened pseudo-terminal.
+        The master_fd is non-inheritable.
         """
         ...
     def killpg(pgid: int, signal: int, /) -> None:
@@ -2740,7 +2744,33 @@ else:
             setsigmask: Iterable[int] = (),
             setsigdef: Iterable[int] = (),
             scheduler: tuple[Any, sched_param] | None = None,  # None allowed starting in 3.15
-        ) -> int: ...
+        ) -> int:
+            """
+            Execute the program specified by path in a new process.
+
+            path
+              Path of executable file.
+            argv
+              Tuple or list of strings.
+            env
+              Dictionary of strings mapping to strings.
+            file_actions
+              A sequence of file action tuples.
+            setpgroup
+              The pgroup to use with the POSIX_SPAWN_SETPGROUP flag.
+            resetids
+              If the value is `true` the POSIX_SPAWN_RESETIDS will be activated.
+            setsid
+              If the value is `true` the POSIX_SPAWN_SETSID or POSIX_SPAWN_SETSID_NP
+              will be activated.
+            setsigmask
+              The sigmask to use with the POSIX_SPAWN_SETSIGMASK flag.
+            setsigdef
+              The sigmask to use with the POSIX_SPAWN_SETSIGDEF flag.
+            scheduler
+              A tuple with the scheduler policy (optional) and parameters.
+            """
+            ...
         def posix_spawnp(
             path: StrOrBytesPath,
             argv: _ExecVArgs,
@@ -2754,7 +2784,33 @@ else:
             setsigmask: Iterable[int] = (),
             setsigdef: Iterable[int] = (),
             scheduler: tuple[Any, sched_param] | None = None,  # None allowed starting in 3.15
-        ) -> int: ...
+        ) -> int:
+            """
+            Execute the program specified by path in a new process.
+
+            path
+              Path of executable file.
+            argv
+              Tuple or list of strings.
+            env
+              Dictionary of strings mapping to strings.
+            file_actions
+              A sequence of file action tuples.
+            setpgroup
+              The pgroup to use with the POSIX_SPAWN_SETPGROUP flag.
+            resetids
+              If the value is `True` the POSIX_SPAWN_RESETIDS will be activated.
+            setsid
+              If the value is `True` the POSIX_SPAWN_SETSID or POSIX_SPAWN_SETSID_NP
+              will be activated.
+            setsigmask
+              The sigmask to use with the POSIX_SPAWN_SETSIGMASK flag.
+            setsigdef
+              The sigmask to use with the POSIX_SPAWN_SETSIGDEF flag.
+            scheduler
+              A tuple with the scheduler policy (optional) and parameters.
+            """
+            ...
     elif sys.version_info >= (3, 13):
         def posix_spawn(
             path: StrOrBytesPath,

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

@@ -224,9 +224,21 @@ if sys.version_info >= (3, 12):
 
     if sys.version_info >= (3, 15):
         @overload
-        def splitroot(path: AnyOrLiteralStr, /) -> tuple[AnyOrLiteralStr, AnyOrLiteralStr, AnyOrLiteralStr]: ...
+        def splitroot(path: AnyOrLiteralStr, /) -> tuple[AnyOrLiteralStr, AnyOrLiteralStr, AnyOrLiteralStr]:
+            """
+            Split a pathname into drive, root and tail.
+
+            The tail contains anything after the root.
+            """
+            ...
         @overload
-        def splitroot(path: PathLike[AnyStr], /) -> tuple[AnyStr, AnyStr, AnyStr]: ...
+        def splitroot(path: PathLike[AnyStr], /) -> tuple[AnyStr, AnyStr, AnyStr]:
+            """
+            Split a pathname into drive, root and tail.
+
+            The tail contains anything after the root.
+            """
+            ...
     else:
         @overload
         def splitroot(p: AnyOrLiteralStr) -> tuple[AnyOrLiteralStr, AnyOrLiteralStr, AnyOrLiteralStr]:

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

@@ -1,3 +1,3 @@
-from . import sampling as sampling, tracing as tracing
-
-__all__ = ("tracing", "sampling")
+from . import sampling as sampling, tracing as tracing
+
+__all__ = ("tracing", "sampling")

package/dist/typeshed-fallback/stdlib/profiling/sampling/__init__.pyi

@@ -1,17 +1,17 @@
-from .collector import Collector as Collector
-from .gecko_collector import GeckoCollector as GeckoCollector
-from .heatmap_collector import HeatmapCollector as HeatmapCollector
-from .jsonl_collector import JsonlCollector as JsonlCollector
-from .pstats_collector import PstatsCollector as PstatsCollector
-from .stack_collector import CollapsedStackCollector as CollapsedStackCollector
-from .string_table import StringTable as StringTable
-
-__all__ = (
-    "Collector",
-    "PstatsCollector",
-    "CollapsedStackCollector",
-    "HeatmapCollector",
-    "GeckoCollector",
-    "JsonlCollector",
-    "StringTable",
-)
+from .collector import Collector as Collector
+from .gecko_collector import GeckoCollector as GeckoCollector
+from .heatmap_collector import HeatmapCollector as HeatmapCollector
+from .jsonl_collector import JsonlCollector as JsonlCollector
+from .pstats_collector import PstatsCollector as PstatsCollector
+from .stack_collector import CollapsedStackCollector as CollapsedStackCollector
+from .string_table import StringTable as StringTable
+
+__all__ = (
+    "Collector",
+    "PstatsCollector",
+    "CollapsedStackCollector",
+    "HeatmapCollector",
+    "GeckoCollector",
+    "JsonlCollector",
+    "StringTable",
+)

package/dist/typeshed-fallback/stdlib/profiling/sampling/collector.pyi

@@ -1,25 +1,25 @@
-from _typeshed import StrOrBytesPath
-from abc import ABC, abstractmethod
-from collections.abc import Sequence
-from typing import ClassVar, TypeAlias
-
-from _remote_debugging import AwaitedInfo, FrameInfo, InterpreterInfo, LocationInfo
-
-_Location: TypeAlias = int | tuple[int, int, int, int] | LocationInfo | None
-_Frame: TypeAlias = FrameInfo | tuple[str, _Location, str, int | None]
-_Timestamps: TypeAlias = Sequence[int] | None
-
-def normalize_location(location: _Location) -> tuple[int, int, int, int]: ...
-def extract_lineno(location: _Location) -> int: ...
-def filter_internal_frames(frames: Sequence[_Frame]) -> list[_Frame]: ...
-def iter_async_frames(awaited_info_list: Sequence[AwaitedInfo]) -> object: ...
-
-class Collector(ABC):
-    aggregating: ClassVar[bool]  # undocumented
-    @abstractmethod
-    def collect(
-        self, stack_frames: Sequence[InterpreterInfo] | Sequence[AwaitedInfo], timestamps_us: _Timestamps = None
-    ) -> None: ...
-    def collect_failed_sample(self) -> None: ...
-    @abstractmethod
-    def export(self, filename: StrOrBytesPath) -> None: ...
+from _typeshed import StrOrBytesPath
+from abc import ABC, abstractmethod
+from collections.abc import Sequence
+from typing import ClassVar, TypeAlias
+
+from _remote_debugging import AwaitedInfo, FrameInfo, InterpreterInfo, LocationInfo
+
+_Location: TypeAlias = int | tuple[int, int, int, int] | LocationInfo | None
+_Frame: TypeAlias = FrameInfo | tuple[str, _Location, str, int | None]
+_Timestamps: TypeAlias = Sequence[int] | None
+
+def normalize_location(location: _Location) -> tuple[int, int, int, int]: ...
+def extract_lineno(location: _Location) -> int: ...
+def filter_internal_frames(frames: Sequence[_Frame]) -> list[_Frame]: ...
+def iter_async_frames(awaited_info_list: Sequence[AwaitedInfo]) -> object: ...
+
+class Collector(ABC):
+    aggregating: ClassVar[bool]  # undocumented
+    @abstractmethod
+    def collect(
+        self, stack_frames: Sequence[InterpreterInfo] | Sequence[AwaitedInfo], timestamps_us: _Timestamps = None
+    ) -> None: ...
+    def collect_failed_sample(self) -> None: ...
+    @abstractmethod
+    def export(self, filename: StrOrBytesPath) -> None: ...