basedpyright 1.36.2 → 1.37.0-961d59bacff1958014fe4e9ed2ef3116fe2266e2

package/dist/typeshed-fallback/stdlib/compression/zstd/_zstdfile.pyi

@@ -36,7 +36,7 @@ class ZstdFile(_streams.BaseStream):
         *,
         level: None = None,
         options: Mapping[int, int] | None = None,
-        zstd_dict: ZstdDict | None = None,
+        zstd_dict: ZstdDict | tuple[ZstdDict, int] | None = None,
     ) -> None: ...
     @overload
     def __init__(
@@ -47,7 +47,7 @@ class ZstdFile(_streams.BaseStream):
         *,
         level: int | None = None,
         options: Mapping[int, int] | None = None,
-        zstd_dict: ZstdDict | None = None,
+        zstd_dict: ZstdDict | tuple[ZstdDict, int] | None = None,
     ) -> None: ...
     def write(self, data: ReadableBuffer, /) -> int: ...
     def flush(self, mode: _ZstdCompressorFlushBlock | _ZstdCompressorFlushFrame = 1) -> bytes: ...  # type: ignore[override]
@@ -71,7 +71,7 @@ def open(
     *,
     level: None = None,
     options: Mapping[int, int] | None = None,
-    zstd_dict: ZstdDict | None = None,
+    zstd_dict: ZstdDict | tuple[ZstdDict, int] | None = None,
     encoding: str | None = None,
     errors: str | None = None,
     newline: str | None = None,
@@ -84,7 +84,7 @@ def open(
     *,
     level: int | None = None,
     options: Mapping[int, int] | None = None,
-    zstd_dict: ZstdDict | None = None,
+    zstd_dict: ZstdDict | tuple[ZstdDict, int] | None = None,
     encoding: str | None = None,
     errors: str | None = None,
     newline: str | None = None,
@@ -97,7 +97,7 @@ def open(
     *,
     level: None = None,
     options: Mapping[int, int] | None = None,
-    zstd_dict: ZstdDict | None = None,
+    zstd_dict: ZstdDict | tuple[ZstdDict, int] | None = None,
     encoding: str | None = None,
     errors: str | None = None,
     newline: str | None = None,
@@ -110,7 +110,7 @@ def open(
     *,
     level: int | None = None,
     options: Mapping[int, int] | None = None,
-    zstd_dict: ZstdDict | None = None,
+    zstd_dict: ZstdDict | tuple[ZstdDict, int] | None = None,
     encoding: str | None = None,
     errors: str | None = None,
     newline: str | None = None,

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

@@ -4,7 +4,7 @@ from _typeshed import FileDescriptorOrPath, Unused
 from abc import ABC, abstractmethod
 from collections.abc import AsyncGenerator, AsyncIterator, Awaitable, Callable, Generator, Iterator
 from types import TracebackType
-from typing import IO, Any, Generic, Protocol, TypeVar, overload, runtime_checkable, type_check_only
+from typing import Any, Generic, Protocol, TypeVar, overload, runtime_checkable, type_check_only
 from typing_extensions import ParamSpec, Self, TypeAlias
 
 __all__ = [
@@ -30,7 +30,6 @@ if sys.version_info >= (3, 11):
 
 _T = TypeVar("_T")
 _T_co = TypeVar("_T_co", covariant=True)
-_T_io = TypeVar("_T_io", bound=IO[str] | None)
 _ExitT_co = TypeVar("_ExitT_co", covariant=True, bound=bool | None, default=bool | None)
 _F = TypeVar("_F", bound=Callable[..., Any])
 _G_co = TypeVar("_G_co", bound=Generator[Any, Any, Any] | AsyncGenerator[Any, Any], covariant=True)
@@ -141,14 +140,24 @@ class suppress(AbstractContextManager[None, bool]):
         self, exctype: type[BaseException] | None, excinst: BaseException | None, exctb: TracebackType | None
     ) -> bool: ...
 
-class _RedirectStream(AbstractContextManager[_T_io, None]):
-    def __init__(self, new_target: _T_io) -> None: ...
+# This is trying to describe what is needed for (most?) uses
+# of `redirect_stdout` and `redirect_stderr`.
+# https://github.com/python/typeshed/issues/14903
+@type_check_only
+class _SupportsRedirect(Protocol):
+    def write(self, s: str, /) -> int: ...
+    def flush(self) -> None: ...
+
+_SupportsRedirectT = TypeVar("_SupportsRedirectT", bound=_SupportsRedirect | None)
+
+class _RedirectStream(AbstractContextManager[_SupportsRedirectT, None]):
+    def __init__(self, new_target: _SupportsRedirectT) -> None: ...
     def __exit__(
         self, exctype: type[BaseException] | None, excinst: BaseException | None, exctb: TracebackType | None
     ) -> None: ...
 
-class redirect_stdout(_RedirectStream[_T_io]): ...
-class redirect_stderr(_RedirectStream[_T_io]): ...
+class redirect_stdout(_RedirectStream[_SupportsRedirectT]): ...
+class redirect_stderr(_RedirectStream[_SupportsRedirectT]): ...
 
 class _BaseExitStack(Generic[_ExitT_co]):
     def enter_context(self, cm: AbstractContextManager[_T, _ExitT_co]) -> _T: ...

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

@@ -55,6 +55,9 @@ if sys.version_info >= (3, 14):
 else:
     from _ctypes import POINTER as POINTER, pointer as pointer
 
+if sys.version_info >= (3, 14):
+    CField = _CField
+
 DEFAULT_MODE: Final[int]
 
 class ArgumentError(Exception): ...

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

@@ -262,6 +262,7 @@ _auto_null: Any
 class Flag(Enum):
     _name_: str | None  # type: ignore[assignment]
     _value_: int
+    _numeric_repr_: Callable[[int], str]
     @_magic_enum_attr
     def name(self) -> str | None: ...  # type: ignore[override]
     @_magic_enum_attr
@@ -316,6 +317,7 @@ if sys.version_info >= (3, 11):
     def global_enum(cls: _EnumerationT, update_str: bool = False) -> _EnumerationT: ...
     def global_enum_repr(self: Enum) -> str: ...
     def global_flag_repr(self: Flag) -> str: ...
+    def show_flag_values(value: int) -> list[int]: ...
 
 if sys.version_info >= (3, 12):
     # The body of the class is the same, but the base classes are different.

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

@@ -1,3 +1,4 @@
+import sys
 from _heapq import *
 from _typeshed import SupportsRichComparison
 from collections.abc import Callable, Generator, Iterable
@@ -5,6 +6,10 @@ from typing import Any, Final, TypeVar
 
 __all__ = ["heappush", "heappop", "heapify", "heapreplace", "merge", "nlargest", "nsmallest", "heappushpop"]
 
+if sys.version_info >= (3, 14):
+    # Added to __all__ in 3.14.1
+    __all__ += ["heapify_max", "heappop_max", "heappush_max", "heappushpop_max", "heapreplace_max"]
+
 _S = TypeVar("_S")
 
 __about__: Final[str]

package/dist/typeshed-fallback/stdlib/html/parser.pyi

@@ -9,7 +9,8 @@ class HTMLParser(ParserBase):
     # Added in Python 3.9.23, 3.10.18, 3.11.13, 3.12.11, 3.13.6
     RCDATA_CONTENT_ELEMENTS: Final[tuple[str, ...]]
 
-    def __init__(self, *, convert_charrefs: bool = True) -> None: ...
+    # `scripting` parameter added in Python 3.9.25, 3.10.20, 3.11.15, 3.12.13, 3.13.10, 3.14.1
+    def __init__(self, *, convert_charrefs: bool = True, scripting: bool = False) -> None: ...
     def feed(self, data: str) -> None: ...
     def close(self) -> None: ...
     def get_starttag_text(self) -> str | None: ...

package/dist/typeshed-fallback/stdlib/http/client.pyi

@@ -166,6 +166,7 @@ class HTTPResponse(io.BufferedIOBase, BinaryIO):  # type: ignore[misc]  # incomp
     def begin(self) -> None: ...
 
 class HTTPConnection:
+    blocksize: int
     auto_open: int  # undocumented
     debuglevel: int
     default_port: int  # undocumented

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

@@ -26,6 +26,7 @@ class IMAP4:
     class error(Exception): ...
     class abort(error): ...
     class readonly(abort): ...
+    utf8_enabled: bool
     mustquote: Pattern[str]
     debug: int
     state: str
@@ -60,7 +61,7 @@ class IMAP4:
     def socket(self) -> _socket: ...
     def recent(self) -> _CommandResults: ...
     def response(self, code: str) -> _CommandResults: ...
-    def append(self, mailbox: str, flags: str, date_time: str, message: ReadableBuffer) -> str: ...
+    def append(self, mailbox: str, flags: str, date_time: str, message: ReadableBuffer) -> tuple[str, _list[bytes]]: ...
     def authenticate(self, mechanism: str, authobject: Callable[[bytes], bytes | None]) -> tuple[str, str]: ...
     def capability(self) -> _CommandResults: ...
     def check(self) -> _CommandResults: ...

package/dist/typeshed-fallback/stdlib/importlib/readers.pyi

@@ -52,9 +52,9 @@ if sys.version_info >= (3, 10):
         def is_file(self) -> Literal[False]: ...
 
         if sys.version_info >= (3, 12):
-            def joinpath(self, *descendants: str) -> abc.Traversable: ...
+            def joinpath(self, *descendants: StrPath) -> abc.Traversable: ...
         elif sys.version_info >= (3, 11):
-            def joinpath(self, child: str) -> abc.Traversable: ...  # type: ignore[override]
+            def joinpath(self, child: StrPath) -> abc.Traversable: ...  # type: ignore[override]
         else:
             def joinpath(self, child: str) -> abc.Traversable: ...
 

package/dist/typeshed-fallback/stdlib/importlib/resources/abc.pyi

@@ -1,4 +1,5 @@
 import sys
+from _typeshed import StrPath
 from abc import ABCMeta, abstractmethod
 from collections.abc import Iterator
 from io import BufferedReader
@@ -24,7 +25,7 @@ if sys.version_info >= (3, 11):
         @abstractmethod
         def iterdir(self) -> Iterator[Traversable]: ...
         @abstractmethod
-        def joinpath(self, *descendants: str) -> Traversable: ...
+        def joinpath(self, *descendants: StrPath) -> Traversable: ...
 
         # The documentation and runtime protocol allows *args, **kwargs arguments,
         # but this would mean that all implementers would have to support them,
@@ -40,7 +41,7 @@ if sys.version_info >= (3, 11):
         def name(self) -> str:
             """The base name of this object without any parent references."""
             ...
-        def __truediv__(self, child: str, /) -> Traversable: ...
+        def __truediv__(self, child: StrPath, /) -> Traversable: ...
         @abstractmethod
         def read_bytes(self) -> bytes: ...
         @abstractmethod

package/dist/typeshed-fallback/stdlib/importlib/resources/simple.pyi

@@ -1,5 +1,6 @@
 import abc
 import sys
+from _typeshed import StrPath
 from collections.abc import Iterator
 from io import TextIOWrapper
 from typing import IO, Any, BinaryIO, Literal, NoReturn, overload
@@ -52,7 +53,7 @@ if sys.version_info >= (3, 11):
         def iterdir(self) -> Iterator[ResourceHandle | ResourceContainer]: ...
         def open(self, *args: Never, **kwargs: Never) -> NoReturn: ...  # type: ignore[override]
         if sys.version_info < (3, 12):
-            def joinpath(self, *descendants: str) -> Traversable: ...
+            def joinpath(self, *descendants: StrPath) -> Traversable: ...
 
     class TraversableReader(TraversableResources, SimpleReader, metaclass=abc.ABCMeta):
         def files(self) -> ResourceContainer: ...

package/dist/typeshed-fallback/stdlib/importlib/util.pyi

@@ -12,7 +12,9 @@ from importlib._bootstrap_external import (
     spec_from_file_location as spec_from_file_location,
 )
 from importlib.abc import Loader
-from typing_extensions import ParamSpec, deprecated
+from types import TracebackType
+from typing import Literal
+from typing_extensions import ParamSpec, Self, deprecated
 
 _P = ParamSpec("_P")
 
@@ -44,6 +46,18 @@ class LazyLoader(Loader):
 
 def source_hash(source_bytes: ReadableBuffer) -> bytes: ...
 
+if sys.version_info >= (3, 12):
+    class _incompatible_extension_module_restrictions:
+        def __init__(self, *, disable_check: bool) -> None: ...
+        disable_check: bool
+        old: Literal[-1, 0, 1]  # exists only while entered
+        def __enter__(self) -> Self: ...
+        def __exit__(
+            self, exc_type: type[BaseException] | None, exc_val: BaseException | None, exc_tb: TracebackType | None
+        ) -> None: ...
+        @property
+        def override(self) -> Literal[-1, 1]: ...  # undocumented
+
 if sys.version_info >= (3, 14):
     __all__ = [
         "LazyLoader",

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

@@ -85,7 +85,7 @@ class _BaseNetwork(_IPAddressBase, Generic[_A]):
     @property
     def broadcast_address(self) -> _A: ...
     def compare_networks(self, other: Self) -> int: ...
-    def hosts(self) -> Iterator[_A] | list[_A]: ...
+    def hosts(self) -> Iterator[_A]: ...
     @property
     def is_global(self) -> bool:
         """

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

@@ -153,6 +153,10 @@ if sys.version_info < (3, 12):
 def format_string(f: _str, val: Any, grouping: bool = False, monetary: bool = False) -> _str: ...
 def currency(val: float | Decimal, symbol: bool = True, grouping: bool = False, international: bool = False) -> _str: ...
 def delocalize(string: _str) -> _str: ...
+
+if sys.version_info >= (3, 10):
+    def localize(string: _str, grouping: bool = False, monetary: bool = False) -> _str: ...
+
 def atof(string: _str, func: Callable[[_str], float] = ...) -> float: ...
 def atoi(string: _str) -> int: ...
 def str(val: float) -> _str: ...

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

@@ -1,6 +1,6 @@
 import sys
 from _typeshed import StrPath
-from collections.abc import Sequence
+from collections.abc import Iterable
 from typing import IO
 
 __all__ = [
@@ -25,15 +25,15 @@ if sys.version_info >= (3, 13):
 def guess_type(url: StrPath, strict: bool = True) -> tuple[str | None, str | None]: ...
 def guess_all_extensions(type: str, strict: bool = True) -> list[str]: ...
 def guess_extension(type: str, strict: bool = True) -> str | None: ...
-def init(files: Sequence[str] | None = None) -> None: ...
-def read_mime_types(file: str) -> dict[str, str] | None: ...
+def init(files: Iterable[StrPath] | None = None) -> None: ...
+def read_mime_types(file: StrPath) -> dict[str, str] | None: ...
 def add_type(type: str, ext: str, strict: bool = True) -> None: ...
 
 if sys.version_info >= (3, 13):
     def guess_file_type(path: StrPath, *, strict: bool = True) -> tuple[str | None, str | None]: ...
 
 inited: bool
-knownfiles: list[str]
+knownfiles: list[StrPath]
 suffix_map: dict[str, str]
 encodings_map: dict[str, str]
 types_map: dict[str, str]
@@ -44,12 +44,12 @@ class MimeTypes:
     encodings_map: dict[str, str]
     types_map: tuple[dict[str, str], dict[str, str]]
     types_map_inv: tuple[dict[str, str], dict[str, str]]
-    def __init__(self, filenames: tuple[str, ...] = (), strict: bool = True) -> None: ...
+    def __init__(self, filenames: Iterable[StrPath] = (), strict: bool = True) -> None: ...
     def add_type(self, type: str, ext: str, strict: bool = True) -> None: ...
     def guess_extension(self, type: str, strict: bool = True) -> str | None: ...
     def guess_type(self, url: StrPath, strict: bool = True) -> tuple[str | None, str | None]: ...
     def guess_all_extensions(self, type: str, strict: bool = True) -> list[str]: ...
-    def read(self, filename: str, strict: bool = True) -> None: ...
+    def read(self, filename: StrPath, strict: bool = True) -> None: ...
     def readfp(self, fp: IO[str], strict: bool = True) -> None: ...
     def read_windows_registry(self, strict: bool = True) -> None: ...
     if sys.version_info >= (3, 13):

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

@@ -77,30 +77,30 @@ class mmap:
             ) -> Self: ...
 
     def close(self) -> None: ...
-    def flush(self, offset: int = 0, size: int = ...) -> None: ...
-    def move(self, dest: int, src: int, count: int) -> None: ...
+    def flush(self, offset: int = 0, size: int = ..., /) -> None: ...
+    def move(self, dest: int, src: int, count: int, /) -> None: ...
     def read_byte(self) -> int: ...
     def readline(self) -> bytes: ...
-    def resize(self, newsize: int) -> None: ...
+    def resize(self, newsize: int, /) -> None: ...
     if sys.platform != "win32":
-        def seek(self, pos: int, whence: Literal[0, 1, 2, 3, 4] = os.SEEK_SET) -> None: ...
+        def seek(self, pos: int, whence: Literal[0, 1, 2, 3, 4] = os.SEEK_SET, /) -> None: ...
     else:
-        def seek(self, pos: int, whence: Literal[0, 1, 2] = os.SEEK_SET) -> None: ...
+        def seek(self, pos: int, whence: Literal[0, 1, 2] = os.SEEK_SET, /) -> None: ...
 
     def size(self) -> int: ...
     def tell(self) -> int: ...
-    def write_byte(self, byte: int) -> None: ...
+    def write_byte(self, byte: int, /) -> None: ...
     def __len__(self) -> int:
         """Return len(self)."""
         ...
     closed: bool
     if sys.platform != "win32":
-        def madvise(self, option: int, start: int = 0, length: int = ...) -> None: ...
+        def madvise(self, option: int, start: int = 0, length: int = ..., /) -> None: ...
 
-    def find(self, sub: ReadableBuffer, start: int = ..., stop: int = ...) -> int: ...
-    def rfind(self, sub: ReadableBuffer, start: int = ..., stop: int = ...) -> int: ...
-    def read(self, n: int | None = None) -> bytes: ...
-    def write(self, bytes: ReadableBuffer) -> int: ...
+    def find(self, view: ReadableBuffer, start: int = ..., end: int = ..., /) -> int: ...
+    def rfind(self, view: ReadableBuffer, start: int = ..., end: int = ..., /) -> int: ...
+    def read(self, n: int | None = None, /) -> bytes: ...
+    def write(self, bytes: ReadableBuffer, /) -> int: ...
     @overload
     def __getitem__(self, key: int, /) -> int:
         """Return self[key]."""
@@ -127,7 +127,7 @@ class mmap:
     # so we claim that there is also an __iter__ to help type checkers.
     def __iter__(self) -> Iterator[int]: ...
     def __enter__(self) -> Self: ...
-    def __exit__(self, *args: Unused) -> None: ...
+    def __exit__(self, exc_type: Unused, exc_value: Unused, traceback: Unused, /) -> None: ...
     def __buffer__(self, flags: int, /) -> memoryview:
         """Return a buffer object that exposes the underlying memory of the object."""
         ...

package/dist/typeshed-fallback/stdlib/multiprocessing/dummy/__init__.pyi

@@ -1,4 +1,5 @@
 import array
+import sys
 import threading
 import weakref
 from collections.abc import Callable, Iterable, Mapping, Sequence
@@ -44,14 +45,25 @@ class DummyProcess(threading.Thread):
     _start_called: int
     @property
     def exitcode(self) -> Literal[0] | None: ...
-    def __init__(
-        self,
-        group: Any = None,
-        target: Callable[..., object] | None = None,
-        name: str | None = None,
-        args: Iterable[Any] = (),
-        kwargs: Mapping[str, Any] = {},
-    ) -> None: ...
+    if sys.version_info >= (3, 14):
+        # Default changed in Python 3.14.1
+        def __init__(
+            self,
+            group: Any = None,
+            target: Callable[..., object] | None = None,
+            name: str | None = None,
+            args: Iterable[Any] = (),
+            kwargs: Mapping[str, Any] | None = None,
+        ) -> None: ...
+    else:
+        def __init__(
+            self,
+            group: Any = None,
+            target: Callable[..., object] | None = None,
+            name: str | None = None,
+            args: Iterable[Any] = (),
+            kwargs: Mapping[str, Any] | None = {},
+        ) -> None: ...
 
 Process = DummyProcess
 

package/dist/typeshed-fallback/stdlib/multiprocessing/managers.pyi

@@ -208,6 +208,8 @@ class BaseListProxy(BaseProxy, MutableSequence[_T]):
     def count(self, value: _T, /) -> int: ...
     def insert(self, index: SupportsIndex, object: _T, /) -> None: ...
     def remove(self, value: _T, /) -> None: ...
+    if sys.version_info >= (3, 14):
+        def copy(self) -> list[_T]: ...
     # Use BaseListProxy[SupportsRichComparisonT] for the first overload rather than [SupportsRichComparison]
     # to work around invariance
     @overload
@@ -348,8 +350,9 @@ class SyncManager(BaseManager):
     def dict(self, iterable: Iterable[list[str]], /) -> DictProxy[str, str]: ...
     @overload
     def dict(self, iterable: Iterable[list[bytes]], /) -> DictProxy[bytes, bytes]: ...
+    # Overloads are copied from builtins.list.__init__
     @overload
-    def list(self, sequence: Sequence[_T], /) -> ListProxy[_T]: ...
+    def list(self, iterable: Iterable[_T], /) -> ListProxy[_T]: ...
     @overload
     def list(self) -> ListProxy[Any]: ...
     if sys.version_info >= (3, 14):

package/dist/typeshed-fallback/stdlib/multiprocessing/process.pyi

@@ -1,3 +1,4 @@
+import sys
 from collections.abc import Callable, Iterable, Mapping
 from typing import Any
 
@@ -20,6 +21,9 @@ class BaseProcess:
     ) -> None: ...
     def run(self) -> None: ...
     def start(self) -> None: ...
+    if sys.version_info >= (3, 14):
+        def interrupt(self) -> None: ...
+
     def terminate(self) -> None: ...
     def kill(self) -> None: ...
     def close(self) -> None: ...

package/dist/typeshed-fallback/stdlib/multiprocessing/synchronize.pyi

@@ -1,3 +1,4 @@
+import sys
 import threading
 from collections.abc import Callable
 from multiprocessing.context import BaseContext
@@ -45,6 +46,8 @@ class SemLock:
     # These methods are copied from the wrapped _multiprocessing.SemLock object
     def acquire(self, block: bool = True, timeout: float | None = None) -> bool: ...
     def release(self) -> None: ...
+    if sys.version_info >= (3, 14):
+        def locked(self) -> bool: ...
 
 class Lock(SemLock):
     def __init__(self, *, ctx: BaseContext) -> None: ...

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

@@ -204,7 +204,7 @@ class OptionContainer:
         callback_kwargs: dict[str, Any] | None = None,
         help: str | None = None,
         metavar: str | None = None,
-        **kwargs,  # Allow arbitrary keyword arguments for user defined option_class
+        **kwargs: Any,  # Allow arbitrary keyword arguments for user defined option_class
     ) -> Option: ...
     def add_options(self, option_list: Iterable[Option]) -> None: ...
     def destroy(self) -> None: ...