Sync typeshed (#17458)

 Source commit: python/typeshed@dcab6e8

Author: github-actions[bot]

mypy/typeshed/stdlib/VERSIONS

@@ -34,6 +34,7 @@ _dummy_thread: 3.0-3.8
 _dummy_threading: 3.0-3.8
 _heapq: 3.0-
 _imp: 3.0-
+_interpchannels: 3.13-
 _json: 3.0-
 _locale: 3.0-
 _lsprof: 3.0-

mypy/typeshed/stdlib/_interpchannels.pyi

@@ -0,0 +1,84 @@
+from _typeshed import structseq
+from typing import Final, Literal, SupportsIndex, final
+from typing_extensions import Buffer, Self
+
+class ChannelError(RuntimeError): ...
+class ChannelClosedError(ChannelError): ...
+class ChannelEmptyError(ChannelError): ...
+class ChannelNotEmptyError(ChannelError): ...
+class ChannelNotFoundError(ChannelError): ...
+
+# Mark as final, since instantiating ChannelID is not supported.
+@final
+class ChannelID:
+ @property
+ def end(self) -> Literal["send", "recv", "both"]: ...
+ @property
+ def send(self) -> Self: ...
+ @property
+ def recv(self) -> Self: ...
+ def __eq__(self, other: object) -> bool: ...
+ def __ge__(self, other: ChannelID) -> bool: ...
+ def __gt__(self, other: ChannelID) -> bool: ...
+ def __hash__(self) -> int: ...
+ def __index__(self) -> int: ...
+ def __int__(self) -> int: ...
+ def __le__(self, other: ChannelID) -> bool: ...
+ def __lt__(self, other: ChannelID) -> bool: ...
+ def __ne__(self, other: object) -> bool: ...
+
+@final
+class ChannelInfo(structseq[int], tuple[bool, bool, bool, int, int, int, int, int]):
+ __match_args__: Final = (
+ "open",
+ "closing",
+ "closed",
+ "count",
+ "num_interp_send",
+ "num_interp_send_released",
+ "num_interp_recv",
+ "num_interp_recv_released",
+ )
+ @property
+ def open(self) -> bool: ...
+ @property
+ def closing(self) -> bool: ...
+ @property
+ def closed(self) -> bool: ...
+ @property
+ def count(self) -> int: ... # type: ignore[override]
+ @property
+ def num_interp_send(self) -> int: ...
+ @property
+ def num_interp_send_released(self) -> int: ...
+ @property
+ def num_interp_recv(self) -> int: ...
+ @property
+ def num_interp_recv_released(self) -> int: ...
+ @property
+ def num_interp_both(self) -> int: ...
+ @property
+ def num_interp_both_recv_released(self) -> int: ...
+ @property
+ def num_interp_both_send_released(self) -> int: ...
+ @property
+ def num_interp_both_released(self) -> int: ...
+ @property
+ def recv_associated(self) -> bool: ...
+ @property
+ def recv_released(self) -> bool: ...
+ @property
+ def send_associated(self) -> bool: ...
+ @property
+ def send_released(self) -> bool: ...
+
+def create() -> ChannelID: ...
+def destroy(cid: SupportsIndex) -> None: ...
+def list_all() -> list[ChannelID]: ...
+def list_interpreters(cid: SupportsIndex, *, send: bool) -> list[int]: ...
+def send(cid: SupportsIndex, obj: object, *, blocking: bool = True, timeout: float | None = None) -> None: ...
+def send_buffer(cid: SupportsIndex, obj: Buffer, *, blocking: bool = True, timeout: float | None = None) -> None: ...
+def recv(cid: SupportsIndex, default: object = ...) -> object: ...
+def close(cid: SupportsIndex, *, send: bool = False, recv: bool = False) -> None: ...
+def get_info(cid: SupportsIndex) -> ChannelInfo: ...
+def release(cid: SupportsIndex, *, send: bool = False, recv: bool = False, force: bool = False) -> None: ...

mypy/typeshed/stdlib/argparse.pyi

@@ -32,6 +32,7 @@ _T = TypeVar("_T")
 _ActionT = TypeVar("_ActionT", bound=Action)
 _ArgumentParserT = TypeVar("_ArgumentParserT", bound=ArgumentParser)
 _N = TypeVar("_N")
+_ActionType: TypeAlias = Callable[[str], Any] | FileType | str
 # more precisely, Literal["store", "store_const", "store_true",
 # "store_false", "append", "append_const", "count", "help", "version",
 # "extend"], but using this would make it hard to annotate callers
@@ -89,7 +90,7 @@ class _ActionsContainer:
  nargs: int | _NArgsStr | _SUPPRESS_T | None = None,
  const: Any = ...,
  default: Any = ...,
- type: Callable[[str], _T] | FileType = ...,
+ type: _ActionType = ...,
  choices: Iterable[_T] | None = ...,
  required: bool = ...,
  help: str | None = ...,
@@ -313,7 +314,7 @@ class Action(_AttributeHolder):
  nargs: int | str | None
  const: Any
  default: Any
- type: Callable[[str], Any] | FileType | None
+ type: _ActionType | None
  choices: Iterable[Any] | None
  required: bool
  help: str | None
@@ -699,6 +700,7 @@ class _SubParsersAction(Action, Generic[_ArgumentParserT]):
  add_help: bool = ...,
  allow_abbrev: bool = ...,
  exit_on_error: bool = ...,
+ **kwargs: Any, # Accepting any additional kwargs for custom parser classes
  ) -> _ArgumentParserT: ...
  elif sys.version_info >= (3, 9):
  def add_parser(
@@ -721,6 +723,7 @@ class _SubParsersAction(Action, Generic[_ArgumentParserT]):
  add_help: bool = ...,
  allow_abbrev: bool = ...,
  exit_on_error: bool = ...,
+ **kwargs: Any, # Accepting any additional kwargs for custom parser classes
  ) -> _ArgumentParserT: ...
  else:
  def add_parser(
@@ -742,6 +745,7 @@ class _SubParsersAction(Action, Generic[_ArgumentParserT]):
  conflict_handler: str = ...,
  add_help: bool = ...,
  allow_abbrev: bool = ...,
+ **kwargs: Any, # Accepting any additional kwargs for custom parser classes
  ) -> _ArgumentParserT: ...
 
  def _get_subactions(self) -> list[Action]: ...

mypy/typeshed/stdlib/asyncio/events.pyi

@@ -16,23 +16,40 @@ from .tasks import Task
 from .transports import BaseTransport, DatagramTransport, ReadTransport, SubprocessTransport, Transport, WriteTransport
 from .unix_events import AbstractChildWatcher
 
-__all__ = (
- "AbstractEventLoopPolicy",
- "AbstractEventLoop",
- "AbstractServer",
- "Handle",
- "TimerHandle",
- "get_event_loop_policy",
- "set_event_loop_policy",
- "get_event_loop",
- "set_event_loop",
- "new_event_loop",
- "get_child_watcher",
- "set_child_watcher",
- "_set_running_loop",
- "get_running_loop",
- "_get_running_loop",
-)
+if sys.version_info >= (3, 14):
+ __all__ = (
+ "AbstractEventLoopPolicy",
+ "AbstractEventLoop",
+ "AbstractServer",
+ "Handle",
+ "TimerHandle",
+ "get_event_loop_policy",
+ "set_event_loop_policy",
+ "get_event_loop",
+ "set_event_loop",
+ "new_event_loop",
+ "_set_running_loop",
+ "get_running_loop",
+ "_get_running_loop",
+ )
+else:
+ __all__ = (
+ "AbstractEventLoopPolicy",
+ "AbstractEventLoop",
+ "AbstractServer",
+ "Handle",
+ "TimerHandle",
+ "get_event_loop_policy",
+ "set_event_loop_policy",
+ "get_event_loop",
+ "set_event_loop",
+ "new_event_loop",
+ "get_child_watcher",
+ "set_child_watcher",
+ "_set_running_loop",
+ "get_running_loop",
+ "_get_running_loop",
+ )
 
 _T = TypeVar("_T")
 _Ts = TypeVarTuple("_Ts")
@@ -541,18 +558,19 @@ class AbstractEventLoopPolicy:
  @abstractmethod
  def new_event_loop(self) -> AbstractEventLoop: ...
  # Child processes handling (Unix only).
- if sys.version_info >= (3, 12):
- @abstractmethod
- @deprecated("Deprecated as of Python 3.12; will be removed in Python 3.14")
- def get_child_watcher(self) -> AbstractChildWatcher: ...
- @abstractmethod
- @deprecated("Deprecated as of Python 3.12; will be removed in Python 3.14")
- def set_child_watcher(self, watcher: AbstractChildWatcher) -> None: ...
- else:
- @abstractmethod
- def get_child_watcher(self) -> AbstractChildWatcher: ...
- @abstractmethod
- def set_child_watcher(self, watcher: AbstractChildWatcher) -> None: ...
+ if sys.version_info < (3, 14):
+ if sys.version_info >= (3, 12):
+ @abstractmethod
+ @deprecated("Deprecated as of Python 3.12; will be removed in Python 3.14")
+ def get_child_watcher(self) -> AbstractChildWatcher: ...
+ @abstractmethod
+ @deprecated("Deprecated as of Python 3.12; will be removed in Python 3.14")
+ def set_child_watcher(self, watcher: AbstractChildWatcher) -> None: ...
+ else:
+ @abstractmethod
+ def get_child_watcher(self) -> AbstractChildWatcher: ...
+ @abstractmethod
+ def set_child_watcher(self, watcher: AbstractChildWatcher) -> None: ...
 
 class BaseDefaultEventLoopPolicy(AbstractEventLoopPolicy, metaclass=ABCMeta):
  def get_event_loop(self) -> AbstractEventLoop: ...
@@ -565,15 +583,16 @@ def get_event_loop() -> AbstractEventLoop: ...
 def set_event_loop(loop: AbstractEventLoop | None) -> None: ...
 def new_event_loop() -> AbstractEventLoop: ...
 
-if sys.version_info >= (3, 12):
- @deprecated("Deprecated as of Python 3.12; will be removed in Python 3.14")
- def get_child_watcher() -> AbstractChildWatcher: ...
- @deprecated("Deprecated as of Python 3.12; will be removed in Python 3.14")
- def set_child_watcher(watcher: AbstractChildWatcher) -> None: ...
+if sys.version_info < (3, 14):
+ if sys.version_info >= (3, 12):
+ @deprecated("Deprecated as of Python 3.12; will be removed in Python 3.14")
+ def get_child_watcher() -> AbstractChildWatcher: ...
+ @deprecated("Deprecated as of Python 3.12; will be removed in Python 3.14")
+ def set_child_watcher(watcher: AbstractChildWatcher) -> None: ...
 
-else:
- def get_child_watcher() -> AbstractChildWatcher: ...
- def set_child_watcher(watcher: AbstractChildWatcher) -> None: ...
+ else:
+  def get_child_watcher() -> AbstractChildWatcher: ...
+  def set_child_watcher(watcher: AbstractChildWatcher) -> None: ...
 
 def _set_running_loop(loop: AbstractEventLoop | None, /) -> None: ...
 def _get_running_loop() -> AbstractEventLoop: ...

mypy/typeshed/stdlib/asyncio/tasks.pyi

@@ -70,7 +70,10 @@ _T4 = TypeVar("_T4")
 _T5 = TypeVar("_T5")
 _T6 = TypeVar("_T6")
 _FT = TypeVar("_FT", bound=Future[Any])
-_FutureLike: TypeAlias = Future[_T] | Generator[Any, None, _T] | Awaitable[_T]
+if sys.version_info >= (3, 12):
+ _FutureLike: TypeAlias = Future[_T] | Awaitable[_T]
+else:
+ _FutureLike: TypeAlias = Future[_T] | Generator[Any, None, _T] | Awaitable[_T]
 _TaskYieldType: TypeAlias = Future[object] | None
 
 FIRST_COMPLETED = concurrent.futures.FIRST_COMPLETED