switch to new union syntax in third-party stubs (#5881)

This commit is contained in:
Akuli
2021-08-08 16:46:55 +03:00
committed by GitHub
parent c12c93ebe4
commit 1154218a0e
4 changed files with 229 additions and 235 deletions
+74 -74
View File
@@ -21,53 +21,53 @@ from click.parser import OptionParser
_CC = TypeVar("_CC", bound=Callable[[], Any])
def invoke_param_callback(
callback: Callable[[Context, Parameter, Optional[str]], Any], ctx: Context, param: Parameter, value: Optional[str]
callback: Callable[[Context, Parameter, str | None], Any], ctx: Context, param: Parameter, value: str | None
) -> Any: ...
def augment_usage_errors(ctx: Context, param: Optional[Parameter] = ...) -> ContextManager[None]: ...
def augment_usage_errors(ctx: Context, param: Parameter | None = ...) -> ContextManager[None]: ...
def iter_params_for_processing(
invocation_order: Sequence[Parameter], declaration_order: Iterable[Parameter]
) -> Iterable[Parameter]: ...
class Context:
parent: Optional[Context]
parent: Context | None
command: Command
info_name: Optional[str]
info_name: str | None
params: Dict[Any, Any]
args: List[str]
protected_args: List[str]
obj: Any
default_map: Optional[Mapping[str, Any]]
invoked_subcommand: Optional[str]
terminal_width: Optional[int]
max_content_width: Optional[int]
default_map: Mapping[str, Any] | None
invoked_subcommand: str | None
terminal_width: int | None
max_content_width: int | None
allow_extra_args: bool
allow_interspersed_args: bool
ignore_unknown_options: bool
help_option_names: List[str]
token_normalize_func: Optional[Callable[[str], str]]
token_normalize_func: Callable[[str], str] | None
resilient_parsing: bool
auto_envvar_prefix: Optional[str]
color: Optional[bool]
auto_envvar_prefix: str | None
color: bool | None
_meta: Dict[str, Any]
_close_callbacks: List[Any]
_depth: int
def __init__(
self,
command: Command,
parent: Optional[Context] = ...,
info_name: Optional[str] = ...,
obj: Optional[Any] = ...,
auto_envvar_prefix: Optional[str] = ...,
default_map: Optional[Mapping[str, Any]] = ...,
terminal_width: Optional[int] = ...,
max_content_width: Optional[int] = ...,
parent: Context | None = ...,
info_name: str | None = ...,
obj: Any | None = ...,
auto_envvar_prefix: str | None = ...,
default_map: Mapping[str, Any] | None = ...,
terminal_width: int | None = ...,
max_content_width: int | None = ...,
resilient_parsing: bool = ...,
allow_extra_args: Optional[bool] = ...,
allow_interspersed_args: Optional[bool] = ...,
ignore_unknown_options: Optional[bool] = ...,
help_option_names: Optional[List[str]] = ...,
token_normalize_func: Optional[Callable[[str], str]] = ...,
color: Optional[bool] = ...,
allow_extra_args: bool | None = ...,
allow_interspersed_args: bool | None = ...,
ignore_unknown_options: bool | None = ...,
help_option_names: List[str] | None = ...,
token_normalize_func: Callable[[str], str] | None = ...,
color: bool | None = ...,
) -> None: ...
@property
def meta(self) -> Dict[str, Any]: ...
@@ -83,11 +83,11 @@ class Context:
def lookup_default(self, name: str) -> Any: ...
def fail(self, message: str) -> NoReturn: ...
def abort(self) -> NoReturn: ...
def exit(self, code: Union[int, str] = ...) -> NoReturn: ...
def exit(self, code: int | str = ...) -> NoReturn: ...
def get_usage(self) -> str: ...
def get_help(self) -> str: ...
def invoke(self, callback: Union[Command, Callable[..., Any]], *args: Any, **kwargs: Any) -> Any: ...
def forward(self, callback: Union[Command, Callable[..., Any]], *args: Any, **kwargs: Any) -> Any: ...
def invoke(self, callback: Command | Callable[..., Any], *args: Any, **kwargs: Any) -> Any: ...
def forward(self, callback: Command | Callable[..., Any], *args: Any, **kwargs: Any) -> Any: ...
class BaseCommand:
allow_extra_args: bool
@@ -95,28 +95,28 @@ class BaseCommand:
ignore_unknown_options: bool
name: str
context_settings: Dict[Any, Any]
def __init__(self, name: str, context_settings: Optional[Dict[Any, Any]] = ...) -> None: ...
def __init__(self, name: str, context_settings: Dict[Any, Any] | None = ...) -> None: ...
def get_usage(self, ctx: Context) -> str: ...
def get_help(self, ctx: Context) -> str: ...
def make_context(self, info_name: str, args: List[str], parent: Optional[Context] = ..., **extra: Any) -> Context: ...
def make_context(self, info_name: str, args: List[str], parent: Context | None = ..., **extra: Any) -> Context: ...
def parse_args(self, ctx: Context, args: List[str]) -> List[str]: ...
def invoke(self, ctx: Context) -> Any: ...
def main(
self,
args: Optional[List[str]] = ...,
prog_name: Optional[str] = ...,
complete_var: Optional[str] = ...,
args: List[str] | None = ...,
prog_name: str | None = ...,
complete_var: str | None = ...,
standalone_mode: bool = ...,
**extra: Any,
) -> Any: ...
def __call__(self, *args: Any, **kwargs: Any) -> Any: ...
class Command(BaseCommand):
callback: Optional[Callable[..., Any]]
callback: Callable[..., Any] | None
params: List[Parameter]
help: Optional[str]
epilog: Optional[str]
short_help: Optional[str]
help: str | None
epilog: str | None
short_help: str | None
options_metavar: str
add_help_option: bool
no_args_is_help: bool
@@ -125,12 +125,12 @@ class Command(BaseCommand):
def __init__(
self,
name: str,
context_settings: Optional[Dict[Any, Any]] = ...,
callback: Optional[Callable[..., Any]] = ...,
params: Optional[List[Parameter]] = ...,
help: Optional[str] = ...,
epilog: Optional[str] = ...,
short_help: Optional[str] = ...,
context_settings: Dict[Any, Any] | None = ...,
callback: Callable[..., Any] | None = ...,
params: List[Parameter] | None = ...,
help: str | None = ...,
epilog: str | None = ...,
short_help: str | None = ...,
options_metavar: str = ...,
add_help_option: bool = ...,
no_args_is_help: bool = ...,
@@ -141,7 +141,7 @@ class Command(BaseCommand):
def format_usage(self, ctx: Context, formatter: HelpFormatter) -> None: ...
def collect_usage_pieces(self, ctx: Context) -> List[str]: ...
def get_help_option_names(self, ctx: Context) -> Set[str]: ...
def get_help_option(self, ctx: Context) -> Optional[Option]: ...
def get_help_option(self, ctx: Context) -> Option | None: ...
def make_parser(self, ctx: Context) -> OptionParser: ...
def get_short_help_str(self, limit: int = ...) -> str: ...
def format_help(self, ctx: Context, formatter: HelpFormatter) -> None: ...
@@ -160,42 +160,42 @@ class MultiCommand(Command):
result_callback: Callable[..., Any]
def __init__(
self,
name: Optional[str] = ...,
name: str | None = ...,
invoke_without_command: bool = ...,
no_args_is_help: Optional[bool] = ...,
subcommand_metavar: Optional[str] = ...,
no_args_is_help: bool | None = ...,
subcommand_metavar: str | None = ...,
chain: bool = ...,
result_callback: Optional[Callable[..., Any]] = ...,
result_callback: Callable[..., Any] | None = ...,
**attrs: Any,
) -> None: ...
def resultcallback(self, replace: bool = ...) -> Callable[[_F], _F]: ...
def format_commands(self, ctx: Context, formatter: HelpFormatter) -> None: ...
def resolve_command(self, ctx: Context, args: List[str]) -> Tuple[str, Command, List[str]]: ...
def get_command(self, ctx: Context, cmd_name: str) -> Optional[Command]: ...
def get_command(self, ctx: Context, cmd_name: str) -> Command | None: ...
def list_commands(self, ctx: Context) -> Iterable[str]: ...
class Group(MultiCommand):
commands: Dict[str, Command]
def __init__(self, name: Optional[str] = ..., commands: Optional[Dict[str, Command]] = ..., **attrs: Any) -> None: ...
def add_command(self, cmd: Command, name: Optional[str] = ...) -> None: ...
def __init__(self, name: str | None = ..., commands: Dict[str, Command] | None = ..., **attrs: Any) -> None: ...
def add_command(self, cmd: Command, name: str | None = ...) -> None: ...
def command(self, *args: Any, **kwargs: Any) -> Callable[[Callable[..., Any]], Command]: ...
def group(self, *args: Any, **kwargs: Any) -> Callable[[Callable[..., Any]], Group]: ...
class CommandCollection(MultiCommand):
sources: List[MultiCommand]
def __init__(self, name: Optional[str] = ..., sources: Optional[List[MultiCommand]] = ..., **attrs: Any) -> None: ...
def __init__(self, name: str | None = ..., sources: List[MultiCommand] | None = ..., **attrs: Any) -> None: ...
def add_source(self, multi_cmd: MultiCommand) -> None: ...
class _ParamType:
name: str
is_composite: bool
envvar_list_splitter: Optional[str]
def __call__(self, value: Optional[str], param: Optional[Parameter] = ..., ctx: Optional[Context] = ...) -> Any: ...
envvar_list_splitter: str | None
def __call__(self, value: str | None, param: Parameter | None = ..., ctx: Context | None = ...) -> Any: ...
def get_metavar(self, param: Parameter) -> str: ...
def get_missing_message(self, param: Parameter) -> str: ...
def convert(self, value: str, param: Optional[Parameter], ctx: Optional[Context]) -> Any: ...
def convert(self, value: str, param: Parameter | None, ctx: Context | None) -> Any: ...
def split_envvar_value(self, rv: str) -> List[str]: ...
def fail(self, message: str, param: Optional[Parameter] = ..., ctx: Optional[Context] = ...) -> NoReturn: ...
def fail(self, message: str, param: Parameter | None = ..., ctx: Context | None = ...) -> NoReturn: ...
# This type is here to resolve https://github.com/python/mypy/issues/5275
_ConvertibleType = Union[
@@ -209,26 +209,26 @@ class Parameter:
secondary_opts: List[str]
type: _ParamType
required: bool
callback: Optional[Callable[[Context, Parameter, str], Any]]
callback: Callable[[Context, Parameter, str], Any] | None
nargs: int
multiple: bool
expose_value: bool
default: Any
is_eager: bool
metavar: Optional[str]
envvar: Union[str, List[str], None]
metavar: str | None
envvar: str | List[str] | None
def __init__(
self,
param_decls: Optional[Iterable[str]] = ...,
type: Optional[_ConvertibleType] = ...,
param_decls: Iterable[str] | None = ...,
type: _ConvertibleType | None = ...,
required: bool = ...,
default: Optional[Any] = ...,
callback: Optional[Callable[[Context, Parameter, str], Any]] = ...,
nargs: Optional[int] = ...,
metavar: Optional[str] = ...,
default: Any | None = ...,
callback: Callable[[Context, Parameter, str], Any] | None = ...,
nargs: int | None = ...,
metavar: str | None = ...,
expose_value: bool = ...,
is_eager: bool = ...,
envvar: Optional[Union[str, List[str]]] = ...,
envvar: str | List[str] | None = ...,
) -> None: ...
@property
def human_readable_name(self) -> str: ...
@@ -241,7 +241,7 @@ class Parameter:
def value_is_missing(self, value: Any) -> bool: ...
def full_process_value(self, ctx: Context, value: Any) -> Any: ...
def resolve_envvar_value(self, ctx: Context) -> str: ...
def value_from_envvar(self, ctx: Context) -> Union[str, List[str]]: ...
def value_from_envvar(self, ctx: Context) -> str | List[str]: ...
def handle_parse_result(self, ctx: Context, opts: Dict[str, Any], args: List[str]) -> Tuple[Any, List[str]]: ...
def get_help_record(self, ctx: Context) -> Tuple[str, str]: ...
def get_usage_pieces(self, ctx: Context) -> List[str]: ...
@@ -257,25 +257,25 @@ class Option(Parameter):
count: bool
multiple: bool
allow_from_autoenv: bool
help: Optional[str]
help: str | None
hidden: bool
show_default: bool
show_choices: bool
show_envvar: bool
def __init__(
self,
param_decls: Optional[Iterable[str]] = ...,
param_decls: Iterable[str] | None = ...,
show_default: bool = ...,
prompt: Union[bool, str] = ...,
prompt: bool | str = ...,
confirmation_prompt: bool = ...,
hide_input: bool = ...,
is_flag: Optional[bool] = ...,
flag_value: Optional[Any] = ...,
is_flag: bool | None = ...,
flag_value: Any | None = ...,
multiple: bool = ...,
count: bool = ...,
allow_from_autoenv: bool = ...,
type: Optional[_ConvertibleType] = ...,
help: Optional[str] = ...,
type: _ConvertibleType | None = ...,
help: str | None = ...,
hidden: bool = ...,
show_choices: bool = ...,
show_envvar: bool = ...,
@@ -284,4 +284,4 @@ class Option(Parameter):
def prompt_for_value(self, ctx: Context) -> Any: ...
class Argument(Parameter):
def __init__(self, param_decls: Optional[Iterable[str]] = ..., required: Optional[bool] = ..., **attrs: Any) -> None: ...
def __init__(self, param_decls: Iterable[str] | None = ..., required: bool | None = ..., **attrs: Any) -> None: ...