basedpyright 1.13.2 → 1.13.3

package/dist/typeshed-fallback/stdlib/unittest/case.pyi

@@ -329,7 +329,13 @@ class _AssertRaisesContext(_AssertRaisesBaseContext, Generic[_E]):
         self, exc_type: type[BaseException] | None, exc_value: BaseException | None, tb: TracebackType | None
     ) -> 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 _AssertWarnsContext(_AssertRaisesBaseContext):
     warning: WarningMessage

package/dist/typeshed-fallback/stdlib/unittest/mock.pyi

@@ -65,7 +65,9 @@ class _Call(tuple[Any, ...]):
         from_kall: bool = True,
     ) -> None: ...
     def __eq__(self, other: object) -> bool: ...
-    def __ne__(self, value: object, /) -> bool: ...
+    def __ne__(self, value: object, /) -> bool:
+        """Return self!=value."""
+        ...
     def __call__(self, *args: Any, **kwargs: Any) -> _Call: ...
     def __getattr__(self, attr: str) -> Any: ...
     def __getattribute__(self, attr: str) -> Any: ...

package/dist/typeshed-fallback/stdlib/urllib/parse.pyi

@@ -56,7 +56,13 @@ class _NetlocResultMixinBase(Generic[AnyStr]):
     @property
     def port(self) -> int | 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 _NetlocResultMixinStr(_NetlocResultMixinBase[str], _ResultMixinStr): ...
 class _NetlocResultMixinBytes(_NetlocResultMixinBase[bytes], _ResultMixinBytes): ...
@@ -182,13 +188,55 @@ def urlparse(
     url: bytes | bytearray | None, scheme: bytes | bytearray | None | Literal[""] = "", allow_fragments: bool = True
 ) -> ParseResultBytes: ...
 @overload
-def urlsplit(url: str, scheme: str = "", allow_fragments: bool = True) -> SplitResult: ...
+def urlsplit(url: str, scheme: str = "", allow_fragments: bool = True) -> SplitResult:
+    """
+    Parse a URL into 5 components:
+    <scheme>://<netloc>/<path>?<query>#<fragment>
+
+    The result is a named 5-tuple with fields corresponding to the
+    above. It is either a SplitResult or SplitResultBytes object,
+    depending on the type of the url parameter.
+
+    The username, password, hostname, and port sub-components of netloc
+    can also be accessed as attributes of the returned object.
+
+    The scheme argument provides the default value of the scheme
+    component when no scheme is found in url.
+
+    If allow_fragments is False, no attempt is made to separate the
+    fragment component from the previous component, which can be either
+    path or query.
+
+    Note that % escapes are not expanded.
+    """
+    ...
 
 if sys.version_info >= (3, 11):
     @overload
     def urlsplit(
         url: bytes | None, scheme: bytes | None | Literal[""] = "", allow_fragments: bool = True
-    ) -> SplitResultBytes: ...
+    ) -> SplitResultBytes:
+        """
+        Parse a URL into 5 components:
+        <scheme>://<netloc>/<path>?<query>#<fragment>
+
+        The result is a named 5-tuple with fields corresponding to the
+        above. It is either a SplitResult or SplitResultBytes object,
+        depending on the type of the url parameter.
+
+        The username, password, hostname, and port sub-components of netloc
+        can also be accessed as attributes of the returned object.
+
+        The scheme argument provides the default value of the scheme
+        component when no scheme is found in url.
+
+        If allow_fragments is False, no attempt is made to separate the
+        fragment component from the previous component, which can be either
+        path or query.
+
+        Note that % escapes are not expanded.
+        """
+        ...
 
 else:
     @overload

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

@@ -48,7 +48,9 @@ class WeakMethod(ref[_CallableT]):
     def __call__(self) -> _CallableT | None: ...
     def __eq__(self, other: object) -> bool: ...
     def __ne__(self, other: object) -> bool: ...
-    def __hash__(self) -> int: ...
+    def __hash__(self) -> int:
+        """Return hash(self)."""
+        ...
 
 class WeakValueDictionary(MutableMapping[_KT, _VT]):
     @overload
@@ -155,5 +157,7 @@ class finalize:  # TODO: This is a good candidate for to be a `Generic[_P, _T]`
     def detach(self) -> tuple[Any, Any, tuple[Any, ...], dict[str, Any]] | None: ...
     def peek(self) -> tuple[Any, Any, tuple[Any, ...], dict[str, Any]] | None: ...
     @property
-    def alive(self) -> bool: ...
+    def alive(self) -> bool:
+        """Whether finalizer is alive"""
+        ...
     atexit: bool

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

@@ -1,28 +1,44 @@
-import sys
-from _typeshed import ReadableBuffer
-from typing import Literal, overload
-
-if sys.platform == "win32":
-    SND_APPLICATION: Literal[128]
-    SND_FILENAME: Literal[131072]
-    SND_ALIAS: Literal[65536]
-    SND_LOOP: Literal[8]
-    SND_MEMORY: Literal[4]
-    SND_PURGE: Literal[64]
-    SND_ASYNC: Literal[1]
-    SND_NODEFAULT: Literal[2]
-    SND_NOSTOP: Literal[16]
-    SND_NOWAIT: Literal[8192]
-
-    MB_ICONASTERISK: Literal[64]
-    MB_ICONEXCLAMATION: Literal[48]
-    MB_ICONHAND: Literal[16]
-    MB_ICONQUESTION: Literal[32]
-    MB_OK: Literal[0]
-    def Beep(frequency: int, duration: int) -> None: ...
-    # Can actually accept anything ORed with 4, and if not it's definitely str, but that's inexpressible
-    @overload
-    def PlaySound(sound: ReadableBuffer | None, flags: Literal[4]) -> None: ...
-    @overload
-    def PlaySound(sound: str | ReadableBuffer | None, flags: int) -> None: ...
-    def MessageBeep(type: int = 0) -> None: ...
+"""
+PlaySound(sound, flags) - play a sound
+SND_FILENAME - sound is a wav file name
+SND_ALIAS - sound is a registry sound association name
+SND_LOOP - Play the sound repeatedly; must also specify SND_ASYNC
+SND_MEMORY - sound is a memory image of a wav file
+SND_PURGE - stop all instances of the specified sound
+SND_ASYNC - PlaySound returns immediately
+SND_NODEFAULT - Do not play a default beep if the sound can not be found
+SND_NOSTOP - Do not interrupt any sounds currently playing
+SND_NOWAIT - Return immediately if the sound driver is busy
+
+Beep(frequency, duration) - Make a beep through the PC speaker.
+MessageBeep(type) - Call Windows MessageBeep.
+"""
+
+import sys
+from _typeshed import ReadableBuffer
+from typing import Literal, overload
+
+if sys.platform == "win32":
+    SND_APPLICATION: Literal[128]
+    SND_FILENAME: Literal[131072]
+    SND_ALIAS: Literal[65536]
+    SND_LOOP: Literal[8]
+    SND_MEMORY: Literal[4]
+    SND_PURGE: Literal[64]
+    SND_ASYNC: Literal[1]
+    SND_NODEFAULT: Literal[2]
+    SND_NOSTOP: Literal[16]
+    SND_NOWAIT: Literal[8192]
+
+    MB_ICONASTERISK: Literal[64]
+    MB_ICONEXCLAMATION: Literal[48]
+    MB_ICONHAND: Literal[16]
+    MB_ICONQUESTION: Literal[32]
+    MB_OK: Literal[0]
+    def Beep(frequency: int, duration: int) -> None: ...
+    # Can actually accept anything ORed with 4, and if not it's definitely str, but that's inexpressible
+    @overload
+    def PlaySound(sound: ReadableBuffer | None, flags: Literal[4]) -> None: ...
+    @overload
+    def PlaySound(sound: str | ReadableBuffer | None, flags: int) -> None: ...
+    def MessageBeep(type: int = 0) -> None: ...

package/dist/typeshed-fallback/stdlib/xml/dom/minicompat.pyi

@@ -9,12 +9,16 @@ StringTypes: tuple[type[str]]
 
 class NodeList(list[_T]):
     @property
-    def length(self) -> int: ...
+    def length(self) -> int:
+        """The number of nodes in the NodeList."""
+        ...
     def item(self, index: int) -> _T | None: ...
 
 class EmptyNodeList(tuple[()]):
     @property
-    def length(self) -> Literal[0]: ...
+    def length(self) -> Literal[0]:
+        """The number of nodes in the NodeList."""
+        ...
     def item(self, index: int) -> None: ...
     def __add__(self, other: Iterable[_T]) -> NodeList[_T]: ...  # type: ignore[override]
     def __radd__(self, other: Iterable[_T]) -> NodeList[_T]: ...

package/dist/typeshed-fallback/stdlib/xml/dom/minidom.pyi

@@ -23,11 +23,17 @@ class Node(xml.dom.Node):
     previousSibling: Incomplete
     prefix: Incomplete
     @property
-    def firstChild(self) -> Node | None: ...
+    def firstChild(self) -> Node | None:
+        """First child node, or None."""
+        ...
     @property
-    def lastChild(self) -> Node | None: ...
+    def lastChild(self) -> Node | None:
+        """Last child node, or None."""
+        ...
     @property
-    def localName(self) -> str | None: ...
+    def localName(self) -> str | None:
+        """Namespace-local name of this node."""
+        ...
     def __bool__(self) -> Literal[True]: ...
     if sys.version_info >= (3, 9):
         @overload
@@ -137,9 +143,13 @@ class Attr(Node):
     ) -> None: ...
     def unlink(self) -> None: ...
     @property
-    def isId(self) -> bool: ...
+    def isId(self) -> bool:
+        """True if this attribute is an ID."""
+        ...
     @property
-    def schemaType(self): ...
+    def schemaType(self):
+        """Schema type for this attribute."""
+        ...
 
 class NamedNodeMap:
     def __init__(self, attrs, attrsNS, ownerElement) -> None: ...
@@ -167,7 +177,9 @@ class NamedNodeMap:
     def setNamedItemNS(self, node: Attr) -> Attr: ...
     def __delitem__(self, attname_or_tuple: tuple[str, str | None] | str) -> None: ...
     @property
-    def length(self) -> int: ...
+    def length(self) -> int:
+        """Number of nodes in the NamedNodeMap."""
+        ...
 
 AttributeList = NamedNodeMap
 
@@ -213,7 +225,9 @@ class Element(Node):
     def setIdAttributeNS(self, namespaceURI: str, localName) -> None: ...
     def setIdAttributeNode(self, idAttr) -> None: ...
     @property
-    def attributes(self) -> NamedNodeMap: ...
+    def attributes(self) -> NamedNodeMap:
+        """NamedNodeMap of attributes on the element."""
+        ...
 
 class Childless:
     attributes: Incomplete
@@ -249,7 +263,9 @@ class CharacterData(Childless, Node):
     def deleteData(self, offset: int, count: int) -> None: ...
     def replaceData(self, offset: int, count: int, arg: str) -> None: ...
     @property
-    def length(self) -> int: ...
+    def length(self) -> int:
+        """Length of the string data."""
+        ...
 
 class Text(CharacterData):
     nodeType: int
@@ -260,9 +276,13 @@ class Text(CharacterData):
     def writexml(self, writer: SupportsWrite[str], indent: str = "", addindent: str = "", newl: str = "") -> None: ...
     def replaceWholeText(self, content) -> Self | None: ...
     @property
-    def isWhitespaceInElementContent(self) -> bool: ...
+    def isWhitespaceInElementContent(self) -> bool:
+        """True iff this text node contains only whitespace and is in element content."""
+        ...
     @property
-    def wholeText(self) -> str: ...
+    def wholeText(self) -> str:
+        """The text of all logically-adjacent text nodes."""
+        ...
 
 class Comment(CharacterData):
     nodeType: int
@@ -287,7 +307,9 @@ class ReadOnlySequentialNamedNodeMap:
     def setNamedItem(self, node) -> None: ...
     def setNamedItemNS(self, node) -> None: ...
     @property
-    def length(self) -> int: ...
+    def length(self) -> int:
+        """Number of entries in the NamedNodeMap."""
+        ...
 
 class Identified:
     publicId: Incomplete

package/dist/typeshed-fallback/stdlib/xml/etree/ElementTree.pyi

@@ -109,22 +109,36 @@ class Element:
     def set(self, key: str, value: str, /) -> None: ...
     def __copy__(self) -> Element: ...  # returns the type of self in Python impl, but not in C impl
     def __deepcopy__(self, memo: Any, /) -> Element: ...  # Only exists in C impl
-    def __delitem__(self, key: SupportsIndex | slice, /) -> None: ...
+    def __delitem__(self, key: SupportsIndex | slice, /) -> None:
+        """Delete self[key]."""
+        ...
     @overload
-    def __getitem__(self, key: SupportsIndex, /) -> Element: ...
+    def __getitem__(self, key: SupportsIndex, /) -> Element:
+        """Return self[key]."""
+        ...
     @overload
-    def __getitem__(self, key: slice, /) -> list[Element]: ...
-    def __len__(self) -> int: ...
+    def __getitem__(self, key: slice, /) -> list[Element]:
+        """Return self[key]."""
+        ...
+    def __len__(self) -> int:
+        """Return len(self)."""
+        ...
     # Doesn't actually exist at runtime, but instance of the class are indeed iterable due to __getitem__.
     def __iter__(self) -> Iterator[Element]: ...
     @overload
-    def __setitem__(self, key: SupportsIndex, value: Element, /) -> None: ...
+    def __setitem__(self, key: SupportsIndex, value: Element, /) -> None:
+        """Set self[key] to value."""
+        ...
     @overload
-    def __setitem__(self, key: slice, value: Iterable[Element], /) -> None: ...
+    def __setitem__(self, key: slice, value: Iterable[Element], /) -> None:
+        """Set self[key] to value."""
+        ...
 
     # Doesn't really exist in earlier versions, where __len__ is called implicitly instead
     @deprecated("Testing an element's truth value is deprecated.")
-    def __bool__(self) -> bool: ...
+    def __bool__(self) -> bool:
+        """True if self else False"""
+        ...
     if sys.version_info < (3, 9):
         def getchildren(self) -> list[Element]: ...
         def getiterator(self, tag: str | None = None) -> list[Element]: ...
@@ -239,9 +253,15 @@ if sys.version_info >= (3, 9):
     def indent(tree: Element | ElementTree, space: str = "  ", level: int = 0) -> None: ...
 
 def parse(source: _FileRead, parser: XMLParser | None = None) -> ElementTree: ...
-def iterparse(
-    source: _FileRead, events: Sequence[str] | None = None, parser: XMLParser | None = None
-) -> Iterator[tuple[str, Any]]: ...
+
+class _IterParseIterator(Iterator[tuple[str, Any]]):
+    def __next__(self) -> tuple[str, Any]: ...
+    if sys.version_info >= (3, 13):
+        def close(self) -> None: ...
+    if sys.version_info >= (3, 11):
+        def __del__(self) -> None: ...
+
+def iterparse(source: _FileRead, events: Sequence[str] | None = None, parser: XMLParser | None = None) -> _IterParseIterator: ...
 
 class XMLPullParser:
     def __init__(self, events: Sequence[str] | None = None, *, _parser: XMLParser | None = None) -> None: ...

package/dist/typeshed-fallback/stdlib/xml/parsers/expat/errors.pyi

@@ -1 +1,3 @@
+"""Constants used to describe error conditions."""
+
 from pyexpat.errors import *

package/dist/typeshed-fallback/stdlib/xml/parsers/expat/model.pyi

@@ -1 +1,3 @@
+"""Constants used to interpret content model information."""
+
 from pyexpat.model import *

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

@@ -1,3 +1,5 @@
+"""This is a template module just for instruction."""
+
 import sys
 from typing import Any, final
 
@@ -5,12 +7,23 @@ class Str(str): ...
 
 @final
 class Xxo:
-    def demo(self) -> None: ...
+    """A class that explicitly stores attributes in an internal dict"""
+    def demo(self) -> None:
+        """demo(o) -> o"""
+        ...
     if sys.version_info >= (3, 11) and sys.platform != "win32":
         x_exports: int
 
-def foo(i: int, j: int, /) -> Any: ...
-def new() -> Xxo: ...
+def foo(i: int, j: int, /) -> Any:
+    """
+    foo(i,j)
+
+    Return the sum of i and j.
+    """
+    ...
+def new() -> Xxo:
+    """new() -> new Xx object"""
+    ...
 
 if sys.version_info >= (3, 10):
     class Error(Exception): ...
@@ -19,4 +32,6 @@ else:
     class error(Exception): ...
     class Null: ...
 
-    def roj(b: Any, /) -> None: ...
+    def roj(b: Any, /) -> None:
+        """roj(a,b) -> None"""
+        ...

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

@@ -1,3 +1,18 @@
+"""
+zipimport provides support for importing Python modules from Zip archives.
+
+This module exports three objects:
+- zipimporter: a class; its constructor takes a path to a Zip archive.
+- ZipImportError: exception raised by zipimporter objects. It's a
+  subclass of ImportError, so it can be caught as ImportError, too.
+- _zip_directory_cache: a dict, mapping archive paths to zip directory
+  info dicts, as used in zipimporter._files.
+
+It is usually not needed to use the zipimport module explicitly; it is
+used by the builtin import mechanism for sys.path items that are paths
+to Zip archives.
+"""
+
 import sys
 from _typeshed import StrOrBytesPath
 from importlib.abc import ResourceReader
@@ -9,6 +24,20 @@ __all__ = ["ZipImportError", "zipimporter"]
 class ZipImportError(ImportError): ...
 
 class zipimporter:
+    """
+    zipimporter(archivepath) -> zipimporter object
+
+    Create a new zipimporter instance. 'archivepath' must be a path to
+    a zipfile, or to a specific path inside a zipfile. For example, it can be
+    '/tmp/myimport.zip', or '/tmp/myimport.zip/mydirectory', if mydirectory is a
+    valid directory inside the archive.
+
+    'ZipImportError is raised if 'archivepath' doesn't point to a valid Zip
+    archive.
+
+    The 'archive' attribute of zipimporter objects contains the name of the
+    zipfile targeted.
+    """
     archive: str
     prefix: str
     if sys.version_info >= (3, 11):
@@ -28,5 +57,7 @@ class zipimporter:
     def is_package(self, fullname: str) -> bool: ...
     def load_module(self, fullname: str) -> ModuleType: ...
     if sys.version_info >= (3, 10):
+        def exec_module(self, module: ModuleType) -> None: ...
+        def create_module(self, spec: ModuleSpec) -> None: ...
         def find_spec(self, fullname: str, target: ModuleType | None = None) -> ModuleSpec | None: ...
         def invalidate_caches(self) -> None: ...