basedpyright 1.13.2 → 1.13.3

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

@@ -1,88 +1,88 @@
-from collections.abc import Iterable
-from typing import IO, Any
-from typing_extensions import TypeAlias
-
-AS_IS: None
-_FontType: TypeAlias = tuple[str, bool, bool, bool]
-_StylesType: TypeAlias = tuple[Any, ...]
-
-class NullFormatter:
-    writer: NullWriter | None
-    def __init__(self, writer: NullWriter | None = None) -> None: ...
-    def end_paragraph(self, blankline: int) -> None: ...
-    def add_line_break(self) -> None: ...
-    def add_hor_rule(self, *args: Any, **kw: Any) -> None: ...
-    def add_label_data(self, format: str, counter: int, blankline: int | None = None) -> None: ...
-    def add_flowing_data(self, data: str) -> None: ...
-    def add_literal_data(self, data: str) -> None: ...
-    def flush_softspace(self) -> None: ...
-    def push_alignment(self, align: str | None) -> None: ...
-    def pop_alignment(self) -> None: ...
-    def push_font(self, x: _FontType) -> None: ...
-    def pop_font(self) -> None: ...
-    def push_margin(self, margin: int) -> None: ...
-    def pop_margin(self) -> None: ...
-    def set_spacing(self, spacing: str | None) -> None: ...
-    def push_style(self, *styles: _StylesType) -> None: ...
-    def pop_style(self, n: int = 1) -> None: ...
-    def assert_line_data(self, flag: int = 1) -> None: ...
-
-class AbstractFormatter:
-    writer: NullWriter
-    align: str | None
-    align_stack: list[str | None]
-    font_stack: list[_FontType]
-    margin_stack: list[int]
-    spacing: str | None
-    style_stack: Any
-    nospace: int
-    softspace: int
-    para_end: int
-    parskip: int
-    hard_break: int
-    have_label: int
-    def __init__(self, writer: NullWriter) -> None: ...
-    def end_paragraph(self, blankline: int) -> None: ...
-    def add_line_break(self) -> None: ...
-    def add_hor_rule(self, *args: Any, **kw: Any) -> None: ...
-    def add_label_data(self, format: str, counter: int, blankline: int | None = None) -> None: ...
-    def format_counter(self, format: Iterable[str], counter: int) -> str: ...
-    def format_letter(self, case: str, counter: int) -> str: ...
-    def format_roman(self, case: str, counter: int) -> str: ...
-    def add_flowing_data(self, data: str) -> None: ...
-    def add_literal_data(self, data: str) -> None: ...
-    def flush_softspace(self) -> None: ...
-    def push_alignment(self, align: str | None) -> None: ...
-    def pop_alignment(self) -> None: ...
-    def push_font(self, font: _FontType) -> None: ...
-    def pop_font(self) -> None: ...
-    def push_margin(self, margin: int) -> None: ...
-    def pop_margin(self) -> None: ...
-    def set_spacing(self, spacing: str | None) -> None: ...
-    def push_style(self, *styles: _StylesType) -> None: ...
-    def pop_style(self, n: int = 1) -> None: ...
-    def assert_line_data(self, flag: int = 1) -> None: ...
-
-class NullWriter:
-    def flush(self) -> None: ...
-    def new_alignment(self, align: str | None) -> None: ...
-    def new_font(self, font: _FontType) -> None: ...
-    def new_margin(self, margin: int, level: int) -> None: ...
-    def new_spacing(self, spacing: str | None) -> None: ...
-    def new_styles(self, styles: tuple[Any, ...]) -> None: ...
-    def send_paragraph(self, blankline: int) -> None: ...
-    def send_line_break(self) -> None: ...
-    def send_hor_rule(self, *args: Any, **kw: Any) -> None: ...
-    def send_label_data(self, data: str) -> None: ...
-    def send_flowing_data(self, data: str) -> None: ...
-    def send_literal_data(self, data: str) -> None: ...
-
-class AbstractWriter(NullWriter): ...
-
-class DumbWriter(NullWriter):
-    file: IO[str]
-    maxcol: int
-    def __init__(self, file: IO[str] | None = None, maxcol: int = 72) -> None: ...
-    def reset(self) -> None: ...
-
-def test(file: str | None = None) -> None: ...
+from collections.abc import Iterable
+from typing import IO, Any
+from typing_extensions import TypeAlias
+
+AS_IS: None
+_FontType: TypeAlias = tuple[str, bool, bool, bool]
+_StylesType: TypeAlias = tuple[Any, ...]
+
+class NullFormatter:
+    writer: NullWriter | None
+    def __init__(self, writer: NullWriter | None = None) -> None: ...
+    def end_paragraph(self, blankline: int) -> None: ...
+    def add_line_break(self) -> None: ...
+    def add_hor_rule(self, *args: Any, **kw: Any) -> None: ...
+    def add_label_data(self, format: str, counter: int, blankline: int | None = None) -> None: ...
+    def add_flowing_data(self, data: str) -> None: ...
+    def add_literal_data(self, data: str) -> None: ...
+    def flush_softspace(self) -> None: ...
+    def push_alignment(self, align: str | None) -> None: ...
+    def pop_alignment(self) -> None: ...
+    def push_font(self, x: _FontType) -> None: ...
+    def pop_font(self) -> None: ...
+    def push_margin(self, margin: int) -> None: ...
+    def pop_margin(self) -> None: ...
+    def set_spacing(self, spacing: str | None) -> None: ...
+    def push_style(self, *styles: _StylesType) -> None: ...
+    def pop_style(self, n: int = 1) -> None: ...
+    def assert_line_data(self, flag: int = 1) -> None: ...
+
+class AbstractFormatter:
+    writer: NullWriter
+    align: str | None
+    align_stack: list[str | None]
+    font_stack: list[_FontType]
+    margin_stack: list[int]
+    spacing: str | None
+    style_stack: Any
+    nospace: int
+    softspace: int
+    para_end: int
+    parskip: int
+    hard_break: int
+    have_label: int
+    def __init__(self, writer: NullWriter) -> None: ...
+    def end_paragraph(self, blankline: int) -> None: ...
+    def add_line_break(self) -> None: ...
+    def add_hor_rule(self, *args: Any, **kw: Any) -> None: ...
+    def add_label_data(self, format: str, counter: int, blankline: int | None = None) -> None: ...
+    def format_counter(self, format: Iterable[str], counter: int) -> str: ...
+    def format_letter(self, case: str, counter: int) -> str: ...
+    def format_roman(self, case: str, counter: int) -> str: ...
+    def add_flowing_data(self, data: str) -> None: ...
+    def add_literal_data(self, data: str) -> None: ...
+    def flush_softspace(self) -> None: ...
+    def push_alignment(self, align: str | None) -> None: ...
+    def pop_alignment(self) -> None: ...
+    def push_font(self, font: _FontType) -> None: ...
+    def pop_font(self) -> None: ...
+    def push_margin(self, margin: int) -> None: ...
+    def pop_margin(self) -> None: ...
+    def set_spacing(self, spacing: str | None) -> None: ...
+    def push_style(self, *styles: _StylesType) -> None: ...
+    def pop_style(self, n: int = 1) -> None: ...
+    def assert_line_data(self, flag: int = 1) -> None: ...
+
+class NullWriter:
+    def flush(self) -> None: ...
+    def new_alignment(self, align: str | None) -> None: ...
+    def new_font(self, font: _FontType) -> None: ...
+    def new_margin(self, margin: int, level: int) -> None: ...
+    def new_spacing(self, spacing: str | None) -> None: ...
+    def new_styles(self, styles: tuple[Any, ...]) -> None: ...
+    def send_paragraph(self, blankline: int) -> None: ...
+    def send_line_break(self) -> None: ...
+    def send_hor_rule(self, *args: Any, **kw: Any) -> None: ...
+    def send_label_data(self, data: str) -> None: ...
+    def send_flowing_data(self, data: str) -> None: ...
+    def send_literal_data(self, data: str) -> None: ...
+
+class AbstractWriter(NullWriter): ...
+
+class DumbWriter(NullWriter):
+    file: IO[str]
+    maxcol: int
+    def __init__(self, file: IO[str] | None = None, maxcol: int = 72) -> None: ...
+    def reset(self) -> None: ...
+
+def test(file: str | None = None) -> None: ...

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

@@ -144,7 +144,11 @@ class Fraction(Rational):
     # Not actually defined within fractions.py, but provides more useful
     # overrides
     @property
-    def real(self) -> Fraction: ...
+    def real(self) -> Fraction:
+        """Real numbers are their real component."""
+        ...
     @property
-    def imag(self) -> Literal[0]: ...
+    def imag(self) -> Literal[0]:
+        """Real numbers have no imaginary component."""
+        ...
     def conjugate(self) -> Fraction: ...

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

@@ -36,9 +36,31 @@ _PWrapper = ParamSpec("_PWrapper")
 _RWrapper = TypeVar("_RWrapper")
 
 @overload
-def reduce(function: Callable[[_T, _S], _T], sequence: Iterable[_S], initial: _T, /) -> _T: ...
+def reduce(function: Callable[[_T, _S], _T], sequence: Iterable[_S], initial: _T, /) -> _T:
+    """
+    reduce(function, sequence[, initial]) -> value
+
+    Apply a function of two arguments cumulatively to the items of a sequence,
+    from left to right, so as to reduce the sequence to a single value.
+    For example, reduce(lambda x, y: x+y, [1, 2, 3, 4, 5]) calculates
+    ((((1+2)+3)+4)+5).  If initial is present, it is placed before the items
+    of the sequence in the calculation, and serves as a default when the
+    sequence is empty.
+    """
+    ...
 @overload
-def reduce(function: Callable[[_T, _T], _T], sequence: Iterable[_T], /) -> _T: ...
+def reduce(function: Callable[[_T, _T], _T], sequence: Iterable[_T], /) -> _T:
+    """
+    reduce(function, sequence[, initial]) -> value
+
+    Apply a function of two arguments cumulatively to the items of a sequence,
+    from left to right, so as to reduce the sequence to a single value.
+    For example, reduce(lambda x, y: x+y, [1, 2, 3, 4, 5]) calculates
+    ((((1+2)+3)+4)+5).  If initial is present, it is placed before the items
+    of the sequence in the calculation, and serves as a default when the
+    sequence is empty.
+    """
+    ...
 
 class _CacheInfo(NamedTuple):
     hits: int
@@ -54,9 +76,15 @@ if sys.version_info >= (3, 9):
 @final
 class _lru_cache_wrapper(Generic[_T]):
     __wrapped__: Callable[..., _T]
-    def __call__(self, *args: Hashable, **kwargs: Hashable) -> _T: ...
-    def cache_info(self) -> _CacheInfo: ...
-    def cache_clear(self) -> None: ...
+    def __call__(self, *args: Hashable, **kwargs: Hashable) -> _T:
+        """Call self as a function."""
+        ...
+    def cache_info(self) -> _CacheInfo:
+        """Report cache statistics"""
+        ...
+    def cache_clear(self) -> None:
+        """Clear the cache and cache statistics"""
+        ...
     if sys.version_info >= (3, 9):
         def cache_parameters(self) -> _CacheParameters: ...
 
@@ -120,19 +148,31 @@ else:
     ) -> _Wrapper[_PWrapped, _RWrapped]: ...
 
 def total_ordering(cls: type[_T]) -> type[_T]: ...
-def cmp_to_key(mycmp: Callable[[_T, _T], int]) -> Callable[[_T], SupportsAllComparisons]: ...
+def cmp_to_key(mycmp: Callable[[_T, _T], int]) -> Callable[[_T], SupportsAllComparisons]:
+    """Convert a cmp= function into a key= function."""
+    ...
 
 class partial(Generic[_T]):
     @property
-    def func(self) -> Callable[..., _T]: ...
+    def func(self) -> Callable[..., _T]:
+        """function object to use in future partial calls"""
+        ...
     @property
-    def args(self) -> tuple[Any, ...]: ...
+    def args(self) -> tuple[Any, ...]:
+        """tuple of arguments to future partial calls"""
+        ...
     @property
-    def keywords(self) -> dict[str, Any]: ...
+    def keywords(self) -> dict[str, Any]:
+        """dictionary of keyword arguments to future partial calls"""
+        ...
     def __new__(cls, func: Callable[..., _T], /, *args: Any, **kwargs: Any) -> Self: ...
-    def __call__(self, /, *args: Any, **kwargs: Any) -> _T: ...
+    def __call__(self, /, *args: Any, **kwargs: Any) -> _T:
+        """Call self as a function."""
+        ...
     if sys.version_info >= (3, 9):
-        def __class_getitem__(cls, item: Any, /) -> GenericAlias: ...
+        def __class_getitem__(cls, item: Any, /) -> GenericAlias:
+            """See PEP 585"""
+            ...
 
 # With protocols, this could change into a generic protocol that defines __get__ and returns _T
 _Descriptor: TypeAlias = Any
@@ -149,7 +189,13 @@ class partialmethod(Generic[_T]):
     @property
     def __isabstractmethod__(self) -> bool: ...
     if sys.version_info >= (3, 9):
-        def __class_getitem__(cls, item: Any, /) -> GenericAlias: ...
+        def __class_getitem__(cls, item: Any, /) -> GenericAlias:
+            """
+            Represent a PEP 585 generic type
+
+            E.g. for t = list[int], t.__origin__ is list and t.__args__ is (int,).
+            """
+            ...
 
 class _SingleDispatchCallable(Generic[_T]):
     registry: types.MappingProxyType[Any, Callable[..., _T]]
@@ -196,7 +242,13 @@ class cached_property(Generic[_T_co]):
     # __set__ is not defined at runtime, but @cached_property is designed to be settable
     def __set__(self, instance: object, value: _T_co) -> None: ...  # type: ignore[misc]  # pyright: ignore[reportGeneralTypeIssues]
     if sys.version_info >= (3, 9):
-        def __class_getitem__(cls, item: Any, /) -> GenericAlias: ...
+        def __class_getitem__(cls, item: Any, /) -> GenericAlias:
+            """
+            Represent a PEP 585 generic type
+
+            E.g. for t = list[int], t.__origin__ is list and t.__args__ is (int,).
+            """
+            ...
 
 if sys.version_info >= (3, 9):
     def cache(user_function: Callable[..., _T], /) -> _lru_cache_wrapper[_T]: ...

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

@@ -23,6 +23,12 @@ class TopologicalSorter(Generic[_T]):
     def get_ready(self) -> tuple[_T, ...]: ...
     def static_order(self) -> Iterable[_T]: ...
     if sys.version_info >= (3, 11):
-        def __class_getitem__(cls, item: Any, /) -> GenericAlias: ...
+        def __class_getitem__(cls, item: Any, /) -> GenericAlias:
+            """
+            Represent a PEP 585 generic type
+
+            E.g. for t = list[int], t.__origin__ is list and t.__args__ is (int,).
+            """
+            ...
 
 class CycleError(ValueError): ...

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

@@ -140,7 +140,9 @@ class GzipFile(_compression.BaseStream):
         def filename(self) -> str: ...
 
     @property
-    def mtime(self) -> int | None: ...
+    def mtime(self) -> int | None:
+        """Last modification time read from stream, or None"""
+        ...
     crc: int
     def write(self, data: ReadableBuffer) -> int: ...
     def read(self, size: int | None = -1) -> bytes: ...

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

@@ -63,28 +63,54 @@ class _Hash:
 
 if sys.version_info >= (3, 9):
     def new(name: str, data: ReadableBuffer = b"", *, usedforsecurity: bool = ...) -> _Hash: ...
-    def md5(string: ReadableBuffer = b"", *, usedforsecurity: bool = True) -> _Hash: ...
-    def sha1(string: ReadableBuffer = b"", *, usedforsecurity: bool = True) -> _Hash: ...
-    def sha224(string: ReadableBuffer = b"", *, usedforsecurity: bool = True) -> _Hash: ...
-    def sha256(string: ReadableBuffer = b"", *, usedforsecurity: bool = True) -> _Hash: ...
-    def sha384(string: ReadableBuffer = b"", *, usedforsecurity: bool = True) -> _Hash: ...
-    def sha512(string: ReadableBuffer = b"", *, usedforsecurity: bool = True) -> _Hash: ...
+    def md5(string: ReadableBuffer = b"", *, usedforsecurity: bool = True) -> _Hash:
+        """Returns a md5 hash object; optionally initialized with a string"""
+        ...
+    def sha1(string: ReadableBuffer = b"", *, usedforsecurity: bool = True) -> _Hash:
+        """Returns a sha1 hash object; optionally initialized with a string"""
+        ...
+    def sha224(string: ReadableBuffer = b"", *, usedforsecurity: bool = True) -> _Hash:
+        """Returns a sha224 hash object; optionally initialized with a string"""
+        ...
+    def sha256(string: ReadableBuffer = b"", *, usedforsecurity: bool = True) -> _Hash:
+        """Returns a sha256 hash object; optionally initialized with a string"""
+        ...
+    def sha384(string: ReadableBuffer = b"", *, usedforsecurity: bool = True) -> _Hash:
+        """Returns a sha384 hash object; optionally initialized with a string"""
+        ...
+    def sha512(string: ReadableBuffer = b"", *, usedforsecurity: bool = True) -> _Hash:
+        """Returns a sha512 hash object; optionally initialized with a string"""
+        ...
 
 else:
     def new(name: str, data: ReadableBuffer = b"") -> _Hash: ...
-    def md5(string: ReadableBuffer = b"") -> _Hash: ...
-    def sha1(string: ReadableBuffer = b"") -> _Hash: ...
-    def sha224(string: ReadableBuffer = b"") -> _Hash: ...
-    def sha256(string: ReadableBuffer = b"") -> _Hash: ...
-    def sha384(string: ReadableBuffer = b"") -> _Hash: ...
-    def sha512(string: ReadableBuffer = b"") -> _Hash: ...
+    def md5(string: ReadableBuffer = b"") -> _Hash:
+        """Returns a md5 hash object; optionally initialized with a string"""
+        ...
+    def sha1(string: ReadableBuffer = b"") -> _Hash:
+        """Returns a sha1 hash object; optionally initialized with a string"""
+        ...
+    def sha224(string: ReadableBuffer = b"") -> _Hash:
+        """Returns a sha224 hash object; optionally initialized with a string"""
+        ...
+    def sha256(string: ReadableBuffer = b"") -> _Hash:
+        """Returns a sha256 hash object; optionally initialized with a string"""
+        ...
+    def sha384(string: ReadableBuffer = b"") -> _Hash:
+        """Returns a sha384 hash object; optionally initialized with a string"""
+        ...
+    def sha512(string: ReadableBuffer = b"") -> _Hash:
+        """Returns a sha512 hash object; optionally initialized with a string"""
+        ...
 
 algorithms_guaranteed: AbstractSet[str]
 algorithms_available: AbstractSet[str]
 
 def pbkdf2_hmac(
     hash_name: str, password: ReadableBuffer, salt: ReadableBuffer, iterations: int, dklen: int | None = None
-) -> bytes: ...
+) -> bytes:
+    """Password based key derivation function 2 (PKCS #5 v2.0) with HMAC as pseudorandom function."""
+    ...
 
 class _VarLenHash:
     digest_size: int
@@ -105,7 +131,9 @@ shake_256 = _VarLenHash
 
 def scrypt(
     password: ReadableBuffer, *, salt: ReadableBuffer, n: int, r: int, p: int, maxmem: int = 0, dklen: int = 64
-) -> bytes: ...
+) -> bytes:
+    """scrypt password-based key derivation function."""
+    ...
 @final
 class _BlakeHash(_Hash):
     MAX_DIGEST_SIZE: int

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

@@ -14,4 +14,6 @@ def merge(
 ) -> Iterable[_S]: ...
 def nlargest(n: int, iterable: Iterable[_S], key: Callable[[_S], SupportsRichComparison] | None = None) -> list[_S]: ...
 def nsmallest(n: int, iterable: Iterable[_S], key: Callable[[_S], SupportsRichComparison] | None = None) -> list[_S]: ...
-def _heapify_max(heap: list[Any], /) -> None: ...  # undocumented
+def _heapify_max(heap: list[Any], /) -> None:
+    """Maxheap variant of heapify."""
+    ...

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

@@ -32,7 +32,35 @@ class HMAC:
     def copy(self) -> HMAC: ...
 
 @overload
-def compare_digest(a: ReadableBuffer, b: ReadableBuffer, /) -> bool: ...
+def compare_digest(a: ReadableBuffer, b: ReadableBuffer, /) -> bool:
+    """
+    Return 'a == b'.
+
+    This function uses an approach designed to prevent
+    timing analysis, making it appropriate for cryptography.
+
+    a and b must both be of the same type: either str (ASCII only),
+    or any bytes-like object.
+
+    Note: If a and b are of different lengths, or if an error occurs,
+    a timing attack could theoretically reveal information about the
+    types and lengths of a and b--but not their values.
+    """
+    ...
 @overload
-def compare_digest(a: AnyStr, b: AnyStr, /) -> bool: ...
+def compare_digest(a: AnyStr, b: AnyStr, /) -> bool:
+    """
+    Return 'a == b'.
+
+    This function uses an approach designed to prevent
+    timing analysis, making it appropriate for cryptography.
+
+    a and b must both be of the same type: either str (ASCII only),
+    or any bytes-like object.
+
+    Note: If a and b are of different lengths, or if an error occurs,
+    a timing attack could theoretically reveal information about the
+    types and lengths of a and b--but not their values.
+    """
+    ...
 def digest(key: SizedBuffer, msg: ReadableBuffer, digest: _DigestMod) -> bytes: ...

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

@@ -45,7 +45,13 @@ class Morsel(dict[str, Any], Generic[_T]):
     def __eq__(self, morsel: object) -> bool: ...
     def __setitem__(self, K: str, V: Any) -> None: ...
     if sys.version_info >= (3, 9):
-        def __class_getitem__(cls, item: Any, /) -> GenericAlias: ...
+        def __class_getitem__(cls, item: Any, /) -> GenericAlias:
+            """
+            Represent a PEP 585 generic type
+
+            E.g. for t = list[int], t.__origin__ is list and t.__args__ is (int,).
+            """
+            ...
 
 class BaseCookie(dict[str, Morsel[_T]], Generic[_T]):
     def __init__(self, input: _DataType | None = None) -> None: ...

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

@@ -1,62 +1,62 @@
-import types
-from _imp import (
-    acquire_lock as acquire_lock,
-    create_dynamic as create_dynamic,
-    get_frozen_object as get_frozen_object,
-    init_frozen as init_frozen,
-    is_builtin as is_builtin,
-    is_frozen as is_frozen,
-    is_frozen_package as is_frozen_package,
-    lock_held as lock_held,
-    release_lock as release_lock,
-)
-from _typeshed import StrPath
-from os import PathLike
-from types import TracebackType
-from typing import IO, Any, Protocol
-
-SEARCH_ERROR: int
-PY_SOURCE: int
-PY_COMPILED: int
-C_EXTENSION: int
-PY_RESOURCE: int
-PKG_DIRECTORY: int
-C_BUILTIN: int
-PY_FROZEN: int
-PY_CODERESOURCE: int
-IMP_HOOK: int
-
-def new_module(name: str) -> types.ModuleType: ...
-def get_magic() -> bytes: ...
-def get_tag() -> str: ...
-def cache_from_source(path: StrPath, debug_override: bool | None = None) -> str: ...
-def source_from_cache(path: StrPath) -> str: ...
-def get_suffixes() -> list[tuple[str, str, int]]: ...
-
-class NullImporter:
-    def __init__(self, path: StrPath) -> None: ...
-    def find_module(self, fullname: Any) -> None: ...
-
-# Technically, a text file has to support a slightly different set of operations than a binary file,
-# but we ignore that here.
-class _FileLike(Protocol):
-    closed: bool
-    mode: str
-    def read(self) -> str | bytes: ...
-    def close(self) -> Any: ...
-    def __enter__(self) -> Any: ...
-    def __exit__(self, typ: type[BaseException] | None, exc: BaseException | None, tb: TracebackType | None, /) -> Any: ...
-
-# PathLike doesn't work for the pathname argument here
-def load_source(name: str, pathname: str, file: _FileLike | None = None) -> types.ModuleType: ...
-def load_compiled(name: str, pathname: str, file: _FileLike | None = None) -> types.ModuleType: ...
-def load_package(name: str, path: StrPath) -> types.ModuleType: ...
-def load_module(name: str, file: _FileLike | None, filename: str, details: tuple[str, str, int]) -> types.ModuleType: ...
-
-# IO[Any] is a TextIOWrapper if name is a .py file, and a FileIO otherwise.
-def find_module(
-    name: str, path: None | list[str] | list[PathLike[str]] | list[StrPath] = None
-) -> tuple[IO[Any], str, tuple[str, str, int]]: ...
-def reload(module: types.ModuleType) -> types.ModuleType: ...
-def init_builtin(name: str) -> types.ModuleType | None: ...
-def load_dynamic(name: str, path: str, file: Any = None) -> types.ModuleType: ...  # file argument is ignored
+import types
+from _imp import (
+    acquire_lock as acquire_lock,
+    create_dynamic as create_dynamic,
+    get_frozen_object as get_frozen_object,
+    init_frozen as init_frozen,
+    is_builtin as is_builtin,
+    is_frozen as is_frozen,
+    is_frozen_package as is_frozen_package,
+    lock_held as lock_held,
+    release_lock as release_lock,
+)
+from _typeshed import StrPath
+from os import PathLike
+from types import TracebackType
+from typing import IO, Any, Protocol
+
+SEARCH_ERROR: int
+PY_SOURCE: int
+PY_COMPILED: int
+C_EXTENSION: int
+PY_RESOURCE: int
+PKG_DIRECTORY: int
+C_BUILTIN: int
+PY_FROZEN: int
+PY_CODERESOURCE: int
+IMP_HOOK: int
+
+def new_module(name: str) -> types.ModuleType: ...
+def get_magic() -> bytes: ...
+def get_tag() -> str: ...
+def cache_from_source(path: StrPath, debug_override: bool | None = None) -> str: ...
+def source_from_cache(path: StrPath) -> str: ...
+def get_suffixes() -> list[tuple[str, str, int]]: ...
+
+class NullImporter:
+    def __init__(self, path: StrPath) -> None: ...
+    def find_module(self, fullname: Any) -> None: ...
+
+# Technically, a text file has to support a slightly different set of operations than a binary file,
+# but we ignore that here.
+class _FileLike(Protocol):
+    closed: bool
+    mode: str
+    def read(self) -> str | bytes: ...
+    def close(self) -> Any: ...
+    def __enter__(self) -> Any: ...
+    def __exit__(self, typ: type[BaseException] | None, exc: BaseException | None, tb: TracebackType | None, /) -> Any: ...
+
+# PathLike doesn't work for the pathname argument here
+def load_source(name: str, pathname: str, file: _FileLike | None = None) -> types.ModuleType: ...
+def load_compiled(name: str, pathname: str, file: _FileLike | None = None) -> types.ModuleType: ...
+def load_package(name: str, path: StrPath) -> types.ModuleType: ...
+def load_module(name: str, file: _FileLike | None, filename: str, details: tuple[str, str, int]) -> types.ModuleType: ...
+
+# IO[Any] is a TextIOWrapper if name is a .py file, and a FileIO otherwise.
+def find_module(
+    name: str, path: None | list[str] | list[PathLike[str]] | list[StrPath] = None
+) -> tuple[IO[Any], str, tuple[str, str, int]]: ...
+def reload(module: types.ModuleType) -> types.ModuleType: ...
+def init_builtin(name: str) -> types.ModuleType | None: ...
+def load_dynamic(name: str, path: str, file: Any = None) -> types.ModuleType: ...  # file argument is ignored

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

@@ -151,7 +151,9 @@ if sys.version_info >= (3, 9):
         def open(self, mode: Literal["rb"], /) -> IO[bytes]: ...
         @property
         @abstractmethod
-        def name(self) -> str: ...
+        def name(self) -> str:
+            """The base name of this object without any parent references."""
+            ...
         if sys.version_info >= (3, 10):
             def __truediv__(self, child: str, /) -> Traversable: ...
         else:

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

@@ -24,7 +24,9 @@ class ModuleSpec:
     loader_state: Any
     cached: str | None
     @property
-    def parent(self) -> str | None: ...
+    def parent(self) -> str | None:
+        """The name of the module's parent."""
+        ...
     has_location: bool
     def __eq__(self, other: object) -> bool: ...