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

stdlib/optparse.pyi

@@ -1,4 +1,4 @@
-from typing import IO, Any, AnyStr, Callable, Dict, Iterable, List, Mapping, Optional, Sequence, Tuple, Type, overload
+from typing import IO, Any, AnyStr, Callable, Dict, Iterable, List, Mapping, Sequence, Tuple, Type, overload
 
 NO_DEFAULT: Tuple[str, ...]
 SUPPRESS_HELP: str
@@ -42,7 +42,7 @@ class HelpFormatter:
     parser: OptionParser
     short_first: Any
     width: int
-    def __init__(self, indent_increment: int, max_help_position: int, width: Optional[int], short_first: int) -> None: ...
+    def __init__(self, indent_increment: int, max_help_position: int, width: int | None, short_first: int) -> None: ...
     def dedent(self) -> None: ...
     def expand_default(self, option: Option) -> str: ...
     def format_description(self, description: str) -> str: ...
@@ -59,14 +59,14 @@ class HelpFormatter:
 
 class IndentedHelpFormatter(HelpFormatter):
     def __init__(
-        self, indent_increment: int = ..., max_help_position: int = ..., width: Optional[int] = ..., short_first: int = ...
+        self, indent_increment: int = ..., max_help_position: int = ..., width: int | None = ..., short_first: int = ...
     ) -> None: ...
     def format_heading(self, heading: str) -> str: ...
     def format_usage(self, usage: str) -> str: ...
 
 class TitledHelpFormatter(HelpFormatter):
     def __init__(
-        self, indent_increment: int = ..., max_help_position: int = ..., width: Optional[int] = ..., short_first: int = ...
+        self, indent_increment: int = ..., max_help_position: int = ..., width: int | None = ..., short_first: int = ...
     ) -> None: ...
     def format_heading(self, heading: str) -> str: ...
     def format_usage(self, usage: str) -> str: ...
@@ -75,7 +75,7 @@ class Option:
     ACTIONS: Tuple[str, ...]
     ALWAYS_TYPED_ACTIONS: Tuple[str, ...]
     ATTRS: List[str]
-    CHECK_METHODS: Optional[List[Callable[..., Any]]]
+    CHECK_METHODS: List[Callable[..., Any]] | None
     CONST_ACTIONS: Tuple[str, ...]
     STORE_ACTIONS: Tuple[str, ...]
     TYPED_ACTIONS: Tuple[str, ...]
@@ -84,23 +84,23 @@ class Option:
     _long_opts: List[str]
     _short_opts: List[str]
     action: str
-    dest: Optional[str]
+    dest: str | None
     default: Any
     nargs: int
     type: Any
-    callback: Optional[Callable[..., Any]]
-    callback_args: Optional[Tuple[Any, ...]]
-    callback_kwargs: Optional[Dict[str, Any]]
-    help: Optional[str]
-    metavar: Optional[str]
-    def __init__(self, *opts: Optional[str], **attrs: Any) -> None: ...
+    callback: Callable[..., Any] | None
+    callback_args: Tuple[Any, ...] | None
+    callback_kwargs: Dict[str, Any] | None
+    help: str | None
+    metavar: str | None
+    def __init__(self, *opts: str | None, **attrs: Any) -> None: ...
     def _check_action(self) -> None: ...
     def _check_callback(self) -> None: ...
     def _check_choice(self) -> None: ...
     def _check_const(self) -> None: ...
     def _check_dest(self) -> None: ...
     def _check_nargs(self) -> None: ...
-    def _check_opt_strings(self, opts: Iterable[Optional[str]]) -> List[str]: ...
+    def _check_opt_strings(self, opts: Iterable[str | None]) -> List[str]: ...
     def _check_type(self) -> None: ...
     def _set_attrs(self, attrs: Dict[str, Any]) -> None: ...
     def _set_opt_strings(self, opts: Iterable[str]) -> None: ...
@@ -127,14 +127,14 @@ class OptionContainer:
     @overload
     def add_option(self, opt: Option) -> Option: ...
     @overload
-    def add_option(self, *args: Optional[str], **kwargs: Any) -> Any: ...
+    def add_option(self, *args: str | None, **kwargs: Any) -> Any: ...
     def add_options(self, option_list: Iterable[Option]) -> None: ...
     def destroy(self) -> None: ...
-    def format_description(self, formatter: Optional[HelpFormatter]) -> Any: ...
-    def format_help(self, formatter: Optional[HelpFormatter]) -> str: ...
-    def format_option_help(self, formatter: Optional[HelpFormatter]) -> str: ...
+    def format_description(self, formatter: HelpFormatter | None) -> Any: ...
+    def format_help(self, formatter: HelpFormatter | None) -> str: ...
+    def format_option_help(self, formatter: HelpFormatter | None) -> str: ...
     def get_description(self) -> Any: ...
-    def get_option(self, opt_str: str) -> Optional[Option]: ...
+    def get_option(self, opt_str: str) -> Option | None: ...
     def has_option(self, opt_str: str) -> bool: ...
     def remove_option(self, opt_str: str) -> None: ...
     def set_conflict_handler(self, handler: Any) -> None: ...
@@ -144,12 +144,12 @@ class OptionGroup(OptionContainer):
     option_list: List[Option]
     parser: OptionParser
     title: str
-    def __init__(self, parser: OptionParser, title: str, description: Optional[str] = ...) -> None: ...
+    def __init__(self, parser: OptionParser, title: str, description: str | None = ...) -> None: ...
     def _create_option_list(self) -> None: ...
     def set_title(self, title: str) -> None: ...
 
 class Values:
-    def __init__(self, defaults: Optional[Mapping[str, Any]] = ...) -> None: ...
+    def __init__(self, defaults: Mapping[str, Any] | None = ...) -> None: ...
     def _update(self, dict: Mapping[str, Any], mode: Any) -> None: ...
     def _update_careful(self, dict: Mapping[str, Any]) -> None: ...
     def _update_loose(self, dict: Mapping[str, Any]) -> None: ...
@@ -161,30 +161,30 @@ class Values:
 
 class OptionParser(OptionContainer):
     allow_interspersed_args: bool
-    epilog: Optional[str]
+    epilog: str | None
     formatter: HelpFormatter
-    largs: Optional[List[str]]
+    largs: List[str] | None
     option_groups: List[OptionGroup]
     option_list: List[Option]
     process_default_values: Any
-    prog: Optional[str]
-    rargs: Optional[List[Any]]
+    prog: str | None
+    rargs: List[Any] | None
     standard_option_list: List[Option]
-    usage: Optional[str]
-    values: Optional[Values]
+    usage: str | None
+    values: Values | None
     version: str
     def __init__(
         self,
-        usage: Optional[str] = ...,
-        option_list: Optional[Iterable[Option]] = ...,
+        usage: str | None = ...,
+        option_list: Iterable[Option] | None = ...,
         option_class: Type[Option] = ...,
-        version: Optional[str] = ...,
+        version: str | None = ...,
         conflict_handler: str = ...,
-        description: Optional[str] = ...,
-        formatter: Optional[HelpFormatter] = ...,
+        description: str | None = ...,
+        formatter: HelpFormatter | None = ...,
         add_help_option: bool = ...,
-        prog: Optional[str] = ...,
-        epilog: Optional[str] = ...,
+        prog: str | None = ...,
+        epilog: str | None = ...,
     ) -> None: ...
     def _add_help_option(self) -> None: ...
     def _add_version_option(self) -> None: ...
@@ -205,22 +205,20 @@ class OptionParser(OptionContainer):
     def disable_interspersed_args(self) -> None: ...
     def enable_interspersed_args(self) -> None: ...
     def error(self, msg: str) -> None: ...
-    def exit(self, status: int = ..., msg: Optional[str] = ...) -> None: ...
-    def expand_prog_name(self, s: Optional[str]) -> Any: ...
+    def exit(self, status: int = ..., msg: str | None = ...) -> None: ...
+    def expand_prog_name(self, s: str | None) -> Any: ...
     def format_epilog(self, formatter: HelpFormatter) -> Any: ...
-    def format_help(self, formatter: Optional[HelpFormatter] = ...) -> str: ...
-    def format_option_help(self, formatter: Optional[HelpFormatter] = ...) -> str: ...
+    def format_help(self, formatter: HelpFormatter | None = ...) -> str: ...
+    def format_option_help(self, formatter: HelpFormatter | None = ...) -> str: ...
     def get_default_values(self) -> Values: ...
     def get_option_group(self, opt_str: str) -> Any: ...
     def get_prog_name(self) -> str: ...
     def get_usage(self) -> str: ...
     def get_version(self) -> str: ...
-    def parse_args(
-        self, args: Optional[Sequence[AnyStr]] = ..., values: Optional[Values] = ...
-    ) -> Tuple[Values, List[AnyStr]]: ...
-    def print_usage(self, file: Optional[IO[str]] = ...) -> None: ...
-    def print_help(self, file: Optional[IO[str]] = ...) -> None: ...
-    def print_version(self, file: Optional[IO[str]] = ...) -> None: ...
+    def parse_args(self, args: Sequence[AnyStr] | None = ..., values: Values | None = ...) -> Tuple[Values, List[AnyStr]]: ...
+    def print_usage(self, file: IO[str] | None = ...) -> None: ...
+    def print_help(self, file: IO[str] | None = ...) -> None: ...
+    def print_version(self, file: IO[str] | None = ...) -> None: ...
     def set_default(self, dest: Any, value: Any) -> None: ...
     def set_defaults(self, **kwargs: Any) -> None: ...
     def set_process_default_values(self, process: Any) -> None: ...