Big diff: Use new "|" union syntax (#5872)

stdlib/mailbox.pyi

@@ -13,7 +13,6 @@ from typing import (
     Iterator,
     List,
     Mapping,
-    Optional,
     Protocol,
     Sequence,
     Tuple,
@@ -41,10 +40,10 @@ linesep: bytes
 
 class Mailbox(Generic[_MessageT]):
 
-    _path: Union[bytes, str]  # undocumented
-    _factory: Optional[Callable[[IO[Any]], _MessageT]]  # undocumented
+    _path: bytes | str  # undocumented
+    _factory: Callable[[IO[Any]], _MessageT] | None  # undocumented
     def __init__(
-        self, path: StrOrBytesPath, factory: Optional[Callable[[IO[Any]], _MessageT]] = ..., create: bool = ...
+        self, path: StrOrBytesPath, factory: Callable[[IO[Any]], _MessageT] | None = ..., create: bool = ...
     ) -> None: ...
     def add(self, message: _MessageData) -> str: ...
     def remove(self, key: str) -> None: ...
@@ -52,9 +51,9 @@ class Mailbox(Generic[_MessageT]):
     def discard(self, key: str) -> None: ...
     def __setitem__(self, key: str, message: _MessageData) -> None: ...
     @overload
-    def get(self, key: str, default: None = ...) -> Optional[_MessageT]: ...
+    def get(self, key: str, default: None = ...) -> _MessageT | None: ...
     @overload
-    def get(self, key: str, default: _T) -> Union[_MessageT, _T]: ...
+    def get(self, key: str, default: _T) -> _MessageT | _T: ...
     def __getitem__(self, key: str) -> _MessageT: ...
     def get_message(self, key: str) -> _MessageT: ...
     def get_string(self, key: str) -> str: ...
@@ -72,11 +71,11 @@ class Mailbox(Generic[_MessageT]):
     def __len__(self) -> int: ...
     def clear(self) -> None: ...
     @overload
-    def pop(self, key: str, default: None = ...) -> Optional[_MessageT]: ...
+    def pop(self, key: str, default: None = ...) -> _MessageT | None: ...
     @overload
-    def pop(self, key: str, default: _T = ...) -> Union[_MessageT, _T]: ...
+    def pop(self, key: str, default: _T = ...) -> _MessageT | _T: ...
     def popitem(self) -> Tuple[str, _MessageT]: ...
-    def update(self, arg: Optional[Union[_HasIteritems, _HasItems, Iterable[Tuple[str, _MessageData]]]] = ...) -> None: ...
+    def update(self, arg: _HasIteritems | _HasItems | Iterable[Tuple[str, _MessageData]] | None = ...) -> None: ...
     def flush(self) -> None: ...
     def lock(self) -> None: ...
     def unlock(self) -> None: ...
@@ -88,7 +87,7 @@ class Maildir(Mailbox[MaildirMessage]):
 
     colon: str
     def __init__(
-        self, dirname: StrOrBytesPath, factory: Optional[Callable[[IO[Any]], MaildirMessage]] = ..., create: bool = ...
+        self, dirname: StrOrBytesPath, factory: Callable[[IO[Any]], MaildirMessage] | None = ..., create: bool = ...
     ) -> None: ...
     def get_file(self, key: str) -> _ProxyFile[bytes]: ...
     def list_folders(self) -> List[str]: ...
@@ -96,7 +95,7 @@ class Maildir(Mailbox[MaildirMessage]):
     def add_folder(self, folder: str) -> Maildir: ...
     def remove_folder(self, folder: str) -> None: ...
     def clean(self) -> None: ...
-    def next(self) -> Optional[str]: ...
+    def next(self) -> str | None: ...
 
 class _singlefileMailbox(Mailbox[_MessageT]): ...
 
@@ -107,17 +106,17 @@ class _mboxMMDF(_singlefileMailbox[_MessageT]):
 
 class mbox(_mboxMMDF[mboxMessage]):
     def __init__(
-        self, path: StrOrBytesPath, factory: Optional[Callable[[IO[Any]], mboxMessage]] = ..., create: bool = ...
+        self, path: StrOrBytesPath, factory: Callable[[IO[Any]], mboxMessage] | None = ..., create: bool = ...
     ) -> None: ...
 
 class MMDF(_mboxMMDF[MMDFMessage]):
     def __init__(
-        self, path: StrOrBytesPath, factory: Optional[Callable[[IO[Any]], MMDFMessage]] = ..., create: bool = ...
+        self, path: StrOrBytesPath, factory: Callable[[IO[Any]], MMDFMessage] | None = ..., create: bool = ...
     ) -> None: ...
 
 class MH(Mailbox[MHMessage]):
     def __init__(
-        self, path: StrOrBytesPath, factory: Optional[Callable[[IO[Any]], MHMessage]] = ..., create: bool = ...
+        self, path: StrOrBytesPath, factory: Callable[[IO[Any]], MHMessage] | None = ..., create: bool = ...
     ) -> None: ...
     def get_file(self, key: str) -> _ProxyFile[bytes]: ...
     def list_folders(self) -> List[str]: ...
@@ -130,13 +129,13 @@ class MH(Mailbox[MHMessage]):
 
 class Babyl(_singlefileMailbox[BabylMessage]):
     def __init__(
-        self, path: StrOrBytesPath, factory: Optional[Callable[[IO[Any]], BabylMessage]] = ..., create: bool = ...
+        self, path: StrOrBytesPath, factory: Callable[[IO[Any]], BabylMessage] | None = ..., create: bool = ...
     ) -> None: ...
     def get_file(self, key: str) -> IO[bytes]: ...
     def get_labels(self) -> List[str]: ...
 
 class Message(email.message.Message):
-    def __init__(self, message: Optional[_MessageData] = ...) -> None: ...
+    def __init__(self, message: _MessageData | None = ...) -> None: ...
 
 class MaildirMessage(Message):
     def get_subdir(self) -> str: ...
@@ -152,9 +151,7 @@ class MaildirMessage(Message):
 
 class _mboxMMDFMessage(Message):
     def get_from(self) -> str: ...
-    def set_from(
-        self, from_: str, time_: Optional[Union[bool, Tuple[int, int, int, int, int, int, int, int, int]]] = ...
-    ) -> None: ...
+    def set_from(self, from_: str, time_: bool | Tuple[int, int, int, int, int, int, int, int, int] | None = ...) -> None: ...
     def get_flags(self) -> str: ...
     def set_flags(self, flags: Iterable[str]) -> None: ...
     def add_flag(self, flag: str) -> None: ...
@@ -180,19 +177,17 @@ class BabylMessage(Message):
 class MMDFMessage(_mboxMMDFMessage): ...
 
 class _ProxyFile(Generic[AnyStr]):
-    def __init__(self, f: IO[AnyStr], pos: Optional[int] = ...) -> None: ...
-    def read(self, size: Optional[int] = ...) -> AnyStr: ...
-    def read1(self, size: Optional[int] = ...) -> AnyStr: ...
-    def readline(self, size: Optional[int] = ...) -> AnyStr: ...
-    def readlines(self, sizehint: Optional[int] = ...) -> List[AnyStr]: ...
+    def __init__(self, f: IO[AnyStr], pos: int | None = ...) -> None: ...
+    def read(self, size: int | None = ...) -> AnyStr: ...
+    def read1(self, size: int | None = ...) -> AnyStr: ...
+    def readline(self, size: int | None = ...) -> AnyStr: ...
+    def readlines(self, sizehint: int | None = ...) -> List[AnyStr]: ...
     def __iter__(self) -> Iterator[AnyStr]: ...
     def tell(self) -> int: ...
     def seek(self, offset: int, whence: int = ...) -> None: ...
     def close(self) -> None: ...
     def __enter__(self: Self) -> Self: ...
-    def __exit__(
-        self, exc_type: Optional[Type[BaseException]], exc: Optional[BaseException], tb: Optional[TracebackType]
-    ) -> None: ...
+    def __exit__(self, exc_type: Type[BaseException] | None, exc: BaseException | None, tb: TracebackType | None) -> None: ...
     def readable(self) -> bool: ...
     def writable(self) -> bool: ...
     def seekable(self) -> bool: ...
@@ -203,7 +198,7 @@ class _ProxyFile(Generic[AnyStr]):
         def __class_getitem__(cls, item: Any) -> GenericAlias: ...
 
 class _PartialFile(_ProxyFile[AnyStr]):
-    def __init__(self, f: IO[AnyStr], start: Optional[int] = ..., stop: Optional[int] = ...) -> None: ...
+    def __init__(self, f: IO[AnyStr], start: int | None = ..., stop: int | None = ...) -> None: ...
 
 class Error(Exception): ...
 class NoSuchMailboxError(Error): ...