Sync typeshed (#16493)

Source commit: python/typeshed@643d911

Author: github-actions[bot]

mypy/typeshed/stdlib/_ast.pyi

@@ -553,7 +553,7 @@ if sys.version_info >= (3, 10):
 
  class MatchSingleton(pattern):
  __match_args__ = ("value",)
- value: Literal[True, False, None]
+ value: Literal[True, False] | None
 
  class MatchSequence(pattern):
  __match_args__ = ("patterns",)

mypy/typeshed/stdlib/_locale.pyi

@@ -1,6 +1,6 @@
 import sys
 from _typeshed import StrPath
-from collections.abc import Iterable, Mapping
+from collections.abc import Mapping
 
 LC_CTYPE: int
 LC_COLLATE: int
@@ -10,7 +10,7 @@ LC_NUMERIC: int
 LC_ALL: int
 CHAR_MAX: int
 
-def setlocale(category: int, locale: str | Iterable[str | None] | None = None) -> str: ...
+def setlocale(__category: int, __locale: str | None = None) -> str: ...
 def localeconv() -> Mapping[str, int | str | list[int]]: ...
 
 if sys.version_info >= (3, 11):

mypy/typeshed/stdlib/_typeshed/__init__.pyi

@@ -236,6 +236,10 @@ class SupportsNoArgReadline(Protocol[_T_co]):
 class SupportsWrite(Protocol[_T_contra]):
  def write(self, __s: _T_contra) -> object: ...
 
+# stable
+class SupportsFlush(Protocol):
+ def flush(self) -> object: ...
+
 # Unfortunately PEP 688 does not allow us to distinguish read-only
 # from writable buffers. We use these aliases for readability for now.
 # Perhaps a future extension of the buffer protocol will allow us to

mypy/typeshed/stdlib/_typeshed/wsgi.pyi

@@ -11,7 +11,7 @@ from typing import Any, Protocol
 from typing_extensions import TypeAlias
 
 class _Readable(Protocol):
- def read(self, size: int = ...) -> bytes: ...
+ def read(self, __size: int = ...) -> bytes: ...
  # Optional: def close(self) -> object: ...
 
 if sys.version_info >= (3, 11):

mypy/typeshed/stdlib/_typeshed/xml.pyi

@@ -4,6 +4,6 @@ from typing import Any, Protocol
 
 # As defined https://docs.python.org/3/library/xml.dom.html#domimplementation-objects
 class DOMImplementation(Protocol):
- def hasFeature(self, feature: str, version: str | None) -> bool: ...
- def createDocument(self, namespaceUri: str, qualifiedName: str, doctype: Any | None) -> Any: ...
- def createDocumentType(self, qualifiedName: str, publicId: str, systemId: str) -> Any: ...
+ def hasFeature(self, __feature: str, __version: str | None) -> bool: ...
+ def createDocument(self, __namespaceUri: str, __qualifiedName: str, __doctype: Any | None) -> Any: ...
+ def createDocumentType(self, __qualifiedName: str, __publicId: str, __systemId: str) -> Any: ...

mypy/typeshed/stdlib/_warnings.pyi

@@ -1,13 +1,36 @@
+import sys
 from typing import Any, overload
 
 _defaultaction: str
 _onceregistry: dict[Any, Any]
 filters: list[tuple[str, str | None, type[Warning], str | None, int]]
 
-@overload
-def warn(message: str, category: type[Warning] | None = None, stacklevel: int = 1, source: Any | None = None) -> None: ...
-@overload
-def warn(message: Warning, category: Any = None, stacklevel: int = 1, source: Any | None = None) -> None: ...
+if sys.version_info >= (3, 12):
+ @overload
+ def warn(
+ message: str,
+ category: type[Warning] | None = None,
+ stacklevel: int = 1,
+ source: Any | None = None,
+ *,
+ skip_file_prefixes: tuple[str, ...] = (),
+ ) -> None: ...
+ @overload
+ def warn(
+ message: Warning,
+ category: Any = None,
+ stacklevel: int = 1,
+ source: Any | None = None,
+ *,
+ skip_file_prefixes: tuple[str, ...] = (),
+ ) -> None: ...
+
+else:
+ @overload
+ def warn(message: str, category: type[Warning] | None = None, stacklevel: int = 1, source: Any | None = None) -> None: ...
+ @overload
+ def warn(message: Warning, category: Any = None, stacklevel: int = 1, source: Any | None = None) -> None: ...
+
 @overload
 def warn_explicit(
  message: str,

mypy/typeshed/stdlib/argparse.pyi

@@ -120,7 +120,7 @@ class _ActionsContainer:
  def _handle_conflict_resolve(self, action: Action, conflicting_actions: Iterable[tuple[str, Action]]) -> None: ...
 
 class _FormatterClass(Protocol):
- def __call__(self, prog: str) -> HelpFormatter: ...
+ def __call__(self, *, prog: str) -> HelpFormatter: ...
 
 class ArgumentParser(_AttributeHolder, _ActionsContainer):
  prog: str

mypy/typeshed/stdlib/ast.pyi

@@ -4,27 +4,30 @@ from _ast import *
 from _typeshed import ReadableBuffer, Unused
 from collections.abc import Iterator
 from typing import Any, TypeVar as _TypeVar, overload
-from typing_extensions import Literal
+from typing_extensions import Literal, deprecated
 
 if sys.version_info >= (3, 8):
  class _ABC(type):
  if sys.version_info >= (3, 9):
  def __init__(cls, *args: Unused) -> None: ...
 
+ @deprecated("Replaced by ast.Constant; removal scheduled for Python 3.14")
  class Num(Constant, metaclass=_ABC):
  value: int | float | complex
-
+ @deprecated("Replaced by ast.Constant; removal scheduled for Python 3.14")
  class Str(Constant, metaclass=_ABC):
  value: str
  # Aliases for value, for backwards compatibility
  s: str
-
+ @deprecated("Replaced by ast.Constant; removal scheduled for Python 3.14")
  class Bytes(Constant, metaclass=_ABC):
  value: bytes
  # Aliases for value, for backwards compatibility
  s: bytes
-
+ @deprecated("Replaced by ast.Constant; removal scheduled for Python 3.14")
  class NameConstant(Constant, metaclass=_ABC): ...
+
+ @deprecated("Replaced by ast.Constant; removal scheduled for Python 3.14")
  class Ellipsis(Constant, metaclass=_ABC): ...
 
 if sys.version_info >= (3, 9):

mypy/typeshed/stdlib/asyncio/base_events.pyi

@@ -423,7 +423,7 @@ class BaseEventLoop(AbstractEventLoop):
  bufsize: Literal[0] = 0,
  encoding: None = None,
  errors: None = None,
- text: Literal[False, None] = None,
+ text: Literal[False] | None = None,
  **kwargs: Any,
  ) -> tuple[SubprocessTransport, _ProtocolT]: ...
  async def subprocess_exec(

mypy/typeshed/stdlib/asyncio/events.pyi

@@ -522,7 +522,7 @@ class AbstractEventLoop:
  bufsize: Literal[0] = 0,
  encoding: None = None,
  errors: None = None,
- text: Literal[False, None] = ...,
+ text: Literal[False] | None = ...,
  **kwargs: Any,
  ) -> tuple[SubprocessTransport, _ProtocolT]: ...
  @abstractmethod