Sync typeshed (#17619)

 Source commit: python/typeshed@4ef2d66

Author: github-actions[bot]

mypy/typeshed/stdlib/_curses.pyi

@@ -368,11 +368,7 @@ def tparm(
 ) -> bytes: ...
 def typeahead(fd: int, /) -> None: ...
 def unctrl(ch: _ChType, /) -> bytes: ...
-
-if sys.version_info < (3, 12) or sys.platform != "darwin":
- # The support for macos was dropped in 3.12
- def unget_wch(ch: int | str, /) -> None: ...
-
+def unget_wch(ch: int | str, /) -> None: ...
 def ungetch(ch: _ChType, /) -> None: ...
 def ungetmouse(id: int, x: int, y: int, z: int, bstate: int, /) -> None: ...
 def update_lines_cols() -> None: ...
@@ -447,13 +443,10 @@ class _CursesWindow:
  def getch(self) -> int: ...
  @overload
  def getch(self, y: int, x: int) -> int: ...
- if sys.version_info < (3, 12) or sys.platform != "darwin":
- # The support for macos was dropped in 3.12
- @overload
- def get_wch(self) -> int | str: ...
- @overload
- def get_wch(self, y: int, x: int) -> int | str: ...
-
+ @overload
+ def get_wch(self) -> int | str: ...
+ @overload
+ def get_wch(self, y: int, x: int) -> int | str: ...
  @overload
  def getkey(self) -> str: ...
  @overload

mypy/typeshed/stdlib/_decimal.pyi

@@ -17,20 +17,20 @@ class DecimalTuple(NamedTuple):
  digits: tuple[int, ...]
  exponent: int | Literal["n", "N", "F"]
 
-ROUND_DOWN: str
-ROUND_HALF_UP: str
-ROUND_HALF_EVEN: str
-ROUND_CEILING: str
-ROUND_FLOOR: str
-ROUND_UP: str
-ROUND_HALF_DOWN: str
-ROUND_05UP: str
-HAVE_CONTEXTVAR: bool
-HAVE_THREADS: bool
-MAX_EMAX: int
-MAX_PREC: int
-MIN_EMIN: int
-MIN_ETINY: int
+ROUND_DOWN: Final[str]
+ROUND_HALF_UP: Final[str]
+ROUND_HALF_EVEN: Final[str]
+ROUND_CEILING: Final[str]
+ROUND_FLOOR: Final[str]
+ROUND_UP: Final[str]
+ROUND_HALF_DOWN: Final[str]
+ROUND_05UP: Final[str]
+HAVE_CONTEXTVAR: Final[bool]
+HAVE_THREADS: Final[bool]
+MAX_EMAX: Final[int]
+MAX_PREC: Final[int]
+MIN_EMIN: Final[int]
+MIN_ETINY: Final[int]
 
 class DecimalException(ArithmeticError): ...
 class Clamped(DecimalException): ...

mypy/typeshed/stdlib/_osx_support.pyi

@@ -1,21 +1,21 @@
 from collections.abc import Iterable, Sequence
-from typing import TypeVar
+from typing import Final, TypeVar
 
 _T = TypeVar("_T")
 _K = TypeVar("_K")
 _V = TypeVar("_V")
 
 __all__ = ["compiler_fixup", "customize_config_vars", "customize_compiler", "get_platform_osx"]
 
-_UNIVERSAL_CONFIG_VARS: tuple[str, ...] # undocumented
-_COMPILER_CONFIG_VARS: tuple[str, ...] # undocumented
-_INITPRE: str # undocumented
+_UNIVERSAL_CONFIG_VARS: Final[tuple[str, ...]] # undocumented
+_COMPILER_CONFIG_VARS: Final[tuple[str, ...]] # undocumented
+_INITPRE: Final[str] # undocumented
 
 def _find_executable(executable: str, path: str | None = None) -> str | None: ... # undocumented
 def _read_output(commandstring: str, capture_stderr: bool = False) -> str | None: ... # undocumented
 def _find_build_tool(toolname: str) -> str: ... # undocumented
 
-_SYSTEM_VERSION: str | None # undocumented
+_SYSTEM_VERSION: Final[str | None] # undocumented
 
 def _get_system_version() -> str: ... # undocumented
 def _remove_original_values(_config_vars: dict[str, str]) -> None: ... # undocumented

mypy/typeshed/stdlib/argparse.pyi

@@ -51,7 +51,7 @@ _SUPPRESS_T = NewType("_SUPPRESS_T", str)
 SUPPRESS: _SUPPRESS_T | str # not using Literal because argparse sometimes compares SUPPRESS with is
 # the | str is there so that foo = argparse.SUPPRESS; foo = "test" checks out in mypy
 ZERO_OR_MORE: Final = "*"
-_UNRECOGNIZED_ARGS_ATTR: str # undocumented
+_UNRECOGNIZED_ARGS_ATTR: Final[str] # undocumented
 
 class ArgumentError(Exception):
  argument_name: str | None

mypy/typeshed/stdlib/asyncio/tasks.pyi

@@ -429,7 +429,11 @@ class Task(Future[_T_co]): # type: ignore[type-var] # pyright: ignore[reportIn
  self, coro: _TaskCompatibleCoro[_T_co], *, loop: AbstractEventLoop = ..., name: str | None = ...
  ) -> None: ...
 
- def get_coro(self) -> _TaskCompatibleCoro[_T_co]: ...
+ if sys.version_info >= (3, 12):
+ def get_coro(self) -> _TaskCompatibleCoro[_T_co] | None: ...
+ else:
+ def get_coro(self) -> _TaskCompatibleCoro[_T_co]: ...
+
  def get_name(self) -> str: ...
  def set_name(self, value: object, /) -> None: ...
  if sys.version_info >= (3, 12):

mypy/typeshed/stdlib/email/charset.pyi

@@ -1,12 +1,12 @@
 from collections.abc import Callable, Iterator
 from email.message import Message
-from typing import overload
+from typing import Final, overload
 
 __all__ = ["Charset", "add_alias", "add_charset", "add_codec"]
 
-QP: int # undocumented
-BASE64: int # undocumented
-SHORTEST: int # undocumented
+QP: Final[int] # undocumented
+BASE64: Final[int] # undocumented
+SHORTEST: Final[int] # undocumented
 
 class Charset:
  input_charset: str

mypy/typeshed/stdlib/gzip.pyi

@@ -3,7 +3,7 @@ import sys
 import zlib
 from _typeshed import ReadableBuffer, SizedBuffer, StrOrBytesPath
 from io import FileIO
-from typing import Literal, Protocol, TextIO, overload
+from typing import Final, Literal, Protocol, TextIO, overload
 from typing_extensions import TypeAlias
 
 __all__ = ["BadGzipFile", "GzipFile", "open", "compress", "decompress"]
@@ -12,14 +12,14 @@ _ReadBinaryMode: TypeAlias = Literal["r", "rb"]
 _WriteBinaryMode: TypeAlias = Literal["a", "ab", "w", "wb", "x", "xb"]
 _OpenTextMode: TypeAlias = Literal["rt", "at", "wt", "xt"]
 
-READ: object # undocumented
-WRITE: object # undocumented
+READ: Final[object] # undocumented
+WRITE: Final[object] # undocumented
 
-FTEXT: int # actually Literal[1] # undocumented
-FHCRC: int # actually Literal[2] # undocumented
-FEXTRA: int # actually Literal[4] # undocumented
-FNAME: int # actually Literal[8] # undocumented
-FCOMMENT: int # actually Literal[16] # undocumented
+FTEXT: Final[int] # actually Literal[1] # undocumented
+FHCRC: Final[int] # actually Literal[2] # undocumented
+FEXTRA: Final[int] # actually Literal[4] # undocumented
+FNAME: Final[int] # actually Literal[8] # undocumented
+FCOMMENT: Final[int] # actually Literal[16] # undocumented
 
 class _ReadableFileobj(Protocol):
  def read(self, n: int, /) -> bytes: ...

mypy/typeshed/stdlib/io.pyi

@@ -168,7 +168,7 @@ class _WrappedBuffer(Protocol):
  def writable(self) -> bool: ...
  def truncate(self, size: int, /) -> int: ...
  def fileno(self) -> int: ...
- def isatty(self) -> int: ...
+ def isatty(self) -> bool: ...
  # Optional: Only needs to be present if seekable() returns True.
  # def seek(self, offset: Literal[0], whence: Literal[2]) -> int: ...
  # def tell(self) -> int: ...

mypy/typeshed/stdlib/lib2to3/fixes/fix_asserts.pyi

@@ -1,8 +1,8 @@
-from typing import ClassVar, Literal
+from typing import ClassVar, Final, Literal
 
 from ..fixer_base import BaseFix
 
-NAMES: dict[str, str]
+NAMES: Final[dict[str, str]]
 
 class FixAsserts(BaseFix):
  BM_compatible: ClassVar[Literal[False]]

mypy/typeshed/stdlib/lib2to3/fixes/fix_idioms.pyi

@@ -1,9 +1,9 @@
-from typing import ClassVar, Literal
+from typing import ClassVar, Final, Literal
 
 from .. import fixer_base
 
-CMP: str
-TYPE: str
+CMP: Final[str]
+TYPE: Final[str]
 
 class FixIdioms(fixer_base.BaseFix):
  BM_compatible: ClassVar[Literal[False]]