From 87235ad72b778d2d9bb73faf4a643fadb04f0469 Mon Sep 17 00:00:00 2001 From: tharvik Date: Mon, 11 Jul 2016 15:23:51 +0200 Subject: [PATCH] merge py2 and py3 argparse --- stdlib/2.7/argparse.pyi | 192 -------------------------------------- stdlib/2and3/argparse.pyi | 152 ++++++++++++++++++++++++++++++ stdlib/3/argparse.pyi | 163 -------------------------------- 3 files changed, 152 insertions(+), 355 deletions(-) delete mode 100644 stdlib/2.7/argparse.pyi create mode 100644 stdlib/2and3/argparse.pyi delete mode 100644 stdlib/3/argparse.pyi diff --git a/stdlib/2.7/argparse.pyi b/stdlib/2.7/argparse.pyi deleted file mode 100644 index 84027edc4fdf..000000000000 --- a/stdlib/2.7/argparse.pyi +++ /dev/null @@ -1,192 +0,0 @@ -# Stubs for argparse (Python 2) -# -# NOTE: This dynamically typed stub was automatically generated by stubgen. - -from typing import Any, Callable, Dict, List, IO, Iterable, Sequence, Type, Union - -SUPPRESS = ... # type: Any -OPTIONAL = ... # type: Any -ZERO_OR_MORE = ... # type: Any -ONE_OR_MORE = ... # type: Any -PARSER = ... # type: Any -REMAINDER = ... # type: Any - -class _AttributeHolder: ... - -class HelpFormatter: - def __init__(self, prog, indent_increment=..., max_help_position=..., width=...) -> None: ... - class _Section: - formatter = ... # type: Any - parent = ... # type: Any - heading = ... # type: Any - items = ... # type: Any - def __init__(self, formatter, parent, heading=...) -> None: ... - def format_help(self): ... - def start_section(self, heading): ... - def end_section(self): ... - def add_text(self, text): ... - def add_usage(self, usage, actions, groups, prefix=...): ... - def add_argument(self, action): ... - def add_arguments(self, actions): ... - def format_help(self): ... - -class RawDescriptionHelpFormatter(HelpFormatter): ... -class RawTextHelpFormatter(RawDescriptionHelpFormatter): ... -class ArgumentDefaultsHelpFormatter(HelpFormatter): ... - -class ArgumentError(Exception): - argument_name = ... # type: Any - message = ... # type: Any - def __init__(self, argument, message) -> None: ... - -class ArgumentTypeError(Exception): ... - -class Action(_AttributeHolder): - option_strings = ... # type: Any - dest = ... # type: Any - nargs = ... # type: Any - const = ... # type: Any - default = ... # type: Any - type = ... # type: Any - choices = ... # type: Any - required = ... # type: Any - help = ... # type: Any - metavar = ... # type: Any - def __init__(self, - option_strings: List[str], - dest = str, - nargs: Union[int, str] = ..., - const: Any = ..., - default: Any = ..., - type: Callable[[str], Any] = ..., - choices: Iterable[Any] = ..., - required: bool = ..., - help: str = ..., - metavar: str = ...) -> None: ... - def __call__(self, parser, namespace, values, option_string=...): ... - -class _StoreAction(Action): - def __init__(self, option_strings, dest, nargs=..., const=..., default=..., type=..., - choices=..., required=..., help=..., metavar=...): ... - def __call__(self, parser, namespace, values, option_string=...): ... - -class _StoreConstAction(Action): - def __init__(self, option_strings, dest, const, default=..., required=..., help=..., - metavar=...): ... - def __call__(self, parser, namespace, values, option_string=...): ... - -class _StoreTrueAction(_StoreConstAction): - def __init__(self, option_strings, dest, default=..., required=..., help=...) -> None: ... - -class _StoreFalseAction(_StoreConstAction): - def __init__(self, option_strings, dest, default=..., required=..., help=...) -> None: ... - -class _AppendAction(Action): - def __init__(self, option_strings, dest, nargs=..., const=..., default=..., type=..., - choices=..., required=..., help=..., metavar=...): ... - def __call__(self, parser, namespace, values, option_string=...): ... - -class _AppendConstAction(Action): - def __init__(self, option_strings, dest, const, default=..., required=..., help=..., - metavar=...): ... - def __call__(self, parser, namespace, values, option_string=...): ... - -class _CountAction(Action): - def __init__(self, option_strings, dest, default=..., required=..., help=...) -> None: ... - def __call__(self, parser, namespace, values, option_string=...): ... - -class _HelpAction(Action): - def __init__(self, option_strings, dest=..., default=..., help=...) -> None: ... - def __call__(self, parser, namespace, values, option_string=...): ... - -class _VersionAction(Action): - version = ... # type: Any - def __init__(self, option_strings, version=..., dest=..., default=..., help=...) -> None: ... - def __call__(self, parser, namespace, values, option_string=...): ... - -class _SubParsersAction(Action): - class _ChoicesPseudoAction(Action): - def __init__(self, name, help) -> None: ... - def __init__(self, option_strings, prog, parser_class, dest=..., help=..., metavar=...) -> None: ... - def add_parser(self, name, **kwargs): ... - def __call__(self, parser, namespace, values, option_string=...): ... - -class FileType: - def __init__(self, mode=..., bufsize=...) -> None: ... - def __call__(self, string): ... - -class Namespace(_AttributeHolder): - def __init__(self, **kwargs) -> None: ... - __hash__ = ... # type: Any - def __eq__(self, other): ... - def __ne__(self, other): ... - def __contains__(self, key): ... - def __getattr__(self, name: str) -> Any: ... - -class _ActionsContainer: - description = ... # type: Any - argument_default = ... # type: Any - prefix_chars = ... # type: Any - conflict_handler = ... # type: Any - def __init__(self, description, prefix_chars, argument_default, conflict_handler) -> None: ... - def register(self, registry_name, value, object): ... - def set_defaults(self, **kwargs): ... - def get_default(self, dest): ... - def add_argument(self, - *args: str, - action: Union[str, Action] = ..., - nargs: str = ..., - const: Any = ..., - default: Any = ..., - type: Any = ..., - choices: Any = ..., # TODO: Container? - required: bool = ..., - help: str = ..., - metavar: str = ..., - dest: str = ..., - version: str = ... - ) -> None: ... - def add_argument_group(self, *args, **kwargs): ... - def add_mutually_exclusive_group(self, **kwargs) -> _MutuallyExclusiveGroup: ... - -class _ArgumentGroup(_ActionsContainer): - title = ... # type: Any - def __init__(self, container, title=..., description=..., **kwargs) -> None: ... - -class _MutuallyExclusiveGroup(_ArgumentGroup): - required = ... # type: Any - def __init__(self, container, required=...) -> None: ... - -class ArgumentParser(_AttributeHolder, _ActionsContainer): - prog = ... # type: Any - usage = ... # type: Any - epilog = ... # type: Any - version = ... # type: Any - formatter_class = ... # type: Any - fromfile_prefix_chars = ... # type: Any - add_help = ... # type: Any - def __init__(self, - prog: str = ..., - usage: str = ..., - description: str = ..., - epilog: str = ..., - version: None = ..., - parents: Iterable[ArgumentParser] = ..., - formatter_class: Type[HelpFormatter] = ..., - prefix_chars: str = ..., - fromfile_prefix_chars: str = ..., - argument_default: str = ..., - conflict_handler: str = ..., - add_help: bool = ...) -> None: ... - def add_subparsers(self, **kwargs): ... - def parse_args(self, args: Sequence[str] = ..., namespace=...): ... - def parse_known_args(self, args=..., namespace=...): ... - def convert_arg_line_to_args(self, arg_line): ... - def format_usage(self): ... - def format_help(self): ... - def format_version(self): ... - def print_usage(self, file=...): ... - def print_help(self, file: IO[Any] = None) -> None: ... - def print_version(self, file=...): ... - def exit(self, status=..., message=...): ... - def error(self, message): ... diff --git a/stdlib/2and3/argparse.pyi b/stdlib/2and3/argparse.pyi new file mode 100644 index 000000000000..90a9041eb6c1 --- /dev/null +++ b/stdlib/2and3/argparse.pyi @@ -0,0 +1,152 @@ +# Stubs for argparse (Python 3.4) + +from typing import ( + Any, Callable, Container, List, IO, Optional, Sequence, Tuple, Type, Union, + TypeVar, overload +) +import sys + +_T = TypeVar('_T') + + +ONE_OR_MORE = ... # type: str +OPTIONAL = ... # type: str +PARSER = ... # type: str +REMAINDER = ... # type: str +SUPPRESS = ... # type: str +ZERO_OR_MORE = ... # type: str + +class ArgumentError(Exception): ... + +class ArgumentParser: + if sys.version_info >= (3, 5): + def __init__(self, + prog: Optional[str] = ..., + usage: Optional[str] = ..., + description: Optional[str] = ..., + epilog: Optional[str] = ..., + parents: List[ArgumentParser] = ..., + formatter_class: Type[HelpFormatter] = ..., + prefix_chars: str = ..., + fromfile_prefix_chars: Optional[str] = ..., + argument_default: Optional[str] = ..., + conflict_handler: str = ..., + add_help: bool = ..., + allow_abbrev: bool = ...) -> None: ... + else: + def __init__(self, # type: ignore + prog: Optional[str] = ..., + usage: Optional[str] = ..., + description: Optional[str] = ..., + epilog: Optional[str] = ..., + parents: List[ArgumentParser] = ..., + formatter_class: Type[HelpFormatter] = ..., + prefix_chars: str = ..., + fromfile_prefix_chars: Optional[str] = ..., + argument_default: Optional[str] = ..., + conflict_handler: str = ..., + add_help: bool = ...) -> None: ... + def add_argument(self, + *name_or_flags: Union[str, List[str]], + action: Union[str, Action] = ..., + nargs: Union[int, str] = ..., + const: Any = ..., + default: Any = ..., + type: Callable[[str], _T] = ..., + choices: Container[_T] = ..., + required: bool = ..., + help: str = ..., + metavar: Union[str, Tuple[str, ...]] = ..., + dest: str = ..., + version: str = ...) -> None: ... # weirdly documented + def parse_args(self, args: Optional[Sequence[str]] = ..., + namespace: Optional[Namespace] = ...) -> Namespace: ... + def add_subparsers(self, title: str = ..., + description: Optional[str] = ..., + prog: str = ..., + parser_class: Type[ArgumentParser] = ..., + action: Type[Action] = ..., + option_string: str = ..., + dest: Optional[str] = ..., + help: Optional[str] = ..., + metavar: Optional[str] = ...) -> None: ... + def add_argument_group(self, title: Optional[str] = ..., + description: Optional[str] = ...) -> _ArgumentGroup: ... + @overload + def add_mutually_exclusive_group(self) -> None: ... + @overload + def add_mutually_exclusive_group(self, required: bool) -> _MutuallyExclusiveGroup: ... + def set_defaults(self, **kwargs: Any) -> None: ... + def get_default(self, dest: str) -> Any: ... + def print_usage(self, file: Optional[IO[str]] = ...) -> None: ... + def print_help(self, file: Optional[IO[str]] = ...) -> None: ... + def format_usage(self) -> str: ... + def format_help(self) -> str: ... + def parse_known_args(self, args: Optional[str] = ..., + namespace: Optional[Namespace] = ...) \ + -> Tuple[Namespace, List[str]]: ... + def convert_arg_line_to_args(self, arg_line: str) -> List[str]: ... + def exit(self, status: int = ..., message: Optional[str] = ...) -> None: ... + def error(self, message: str) -> None: ... + +class HelpFormatter: + # not documented + def __init__(self, prog: str, indent_increment: int = ..., + max_help_position: int = ..., + width: Optional[int] = ...) -> None: ... +class RawDescriptionHelpFormatter(HelpFormatter): ... +class RawTextHelpFormatter(HelpFormatter): ... +class ArgumentDefaultsHelpFormatter(HelpFormatter): ... +if sys.version_info >= (3,): + class MetavarTypeHelpFormatter(HelpFormatter): ... + +class Action: + def __init__(self, + option_strings: List[str], + dest: str = ..., + nargs: Optional[Union[int, str]] = ..., + const: Any = ..., + default: Any = ..., + type: Optional[Callable[[str], _T]] = ..., + choices: Optional[Container[_T]] = ..., + required: bool = ..., + help: Optional[str] = ..., + metavar: Union[str, Tuple[str, ...]] = ...) -> None: ... + def __call__(self, parser: ArgumentParser, namespace: Namespace, + values: List[Any], option_string: str = ...) -> None: ... + +class Namespace: + def __getattr__(self, name: str) -> Any: ... + +class FileType: + if sys.version_info >= (3, 4): + def __init__(self, mode: str = ..., bufsize: int = ..., + encoding: Optional[str] = ..., + errors: Optional[str] = ...) -> None: ... + elif sys.version_info >= (3,): + def __init__(self, # type: ignore + mode: str = ..., bufsize: int = ...) -> None: ... + else: + def __init__(self, # type: ignore + mode: str = ..., bufsize: Optional[int] = ...) -> None: ... + def __call__(self, string: str) -> IO[Any]: ... + +class _ArgumentGroup: + def add_argument(self, + *name_or_flags: Union[str, List[str]], + action: Union[str, Action] = ..., + nargs: Union[int, str] = ..., + const: Any = ..., + default: Any = ..., + type: Callable[[str], _T] = ..., + choices: Container[_T] = ..., + required: bool = ..., + help: str = ..., + metavar: Union[str, Tuple[str, ...]] = ..., + dest: str = ..., + version: str = ...) -> None: ... + +class _MutuallyExclusiveGroup(_ArgumentGroup): ... + +# not documented +class ArgumentTypeError(Exception): ... diff --git a/stdlib/3/argparse.pyi b/stdlib/3/argparse.pyi deleted file mode 100644 index 02328cd3443e..000000000000 --- a/stdlib/3/argparse.pyi +++ /dev/null @@ -1,163 +0,0 @@ -# Stubs for argparse (Python 3) -# -# NOTE: This dynamically typed stub was automatically generated by stubgen. - -from typing import Any, Sequence, Union - -SUPPRESS = ... # type: Any -OPTIONAL = ... # type: Any -ZERO_OR_MORE = ... # type: Any -ONE_OR_MORE = ... # type: Any -PARSER = ... # type: Any -REMAINDER = ... # type: Any - -class _AttributeHolder: ... - -class HelpFormatter: - def __init__(self, prog, indent_increment=..., max_help_position=..., width=...) -> None: ... - def start_section(self, heading): ... - def end_section(self): ... - def add_text(self, text): ... - def add_usage(self, usage, actions, groups, prefix=...): ... - def add_argument(self, action): ... - def add_arguments(self, actions): ... - def format_help(self): ... - -class RawDescriptionHelpFormatter(HelpFormatter): ... -class RawTextHelpFormatter(RawDescriptionHelpFormatter): ... -class ArgumentDefaultsHelpFormatter(HelpFormatter): ... -class MetavarTypeHelpFormatter(HelpFormatter): ... - -class ArgumentError(Exception): - argument_name = ... # type: Any - message = ... # type: Any - def __init__(self, argument, message) -> None: ... - -class ArgumentTypeError(Exception): ... - -class Action(_AttributeHolder): - option_strings = ... # type: Any - dest = ... # type: Any - nargs = ... # type: Any - const = ... # type: Any - default = ... # type: Any - type = ... # type: Any - choices = ... # type: Any - required = ... # type: Any - help = ... # type: Any - metavar = ... # type: Any - def __init__(self, option_strings, dest, nargs=..., const=..., default=..., type=..., - choices=..., required=..., help=..., metavar=...): ... - def __call__(self, parser, namespace, values, option_string=...): ... - -class _StoreAction(Action): - def __init__(self, option_strings, dest, nargs=..., const=..., default=..., type=..., - choices=..., required=..., help=..., metavar=...): ... - def __call__(self, parser, namespace, values, option_string=...): ... - -class _StoreConstAction(Action): - def __init__(self, option_strings, dest, const, default=..., required=..., help=..., - metavar=...): ... - def __call__(self, parser, namespace, values, option_string=...): ... - -class _StoreTrueAction(_StoreConstAction): - def __init__(self, option_strings, dest, default=..., required=..., help=...) -> None: ... - -class _StoreFalseAction(_StoreConstAction): - def __init__(self, option_strings, dest, default=..., required=..., help=...) -> None: ... - -class _AppendAction(Action): - def __init__(self, option_strings, dest, nargs=..., const=..., default=..., type=..., - choices=..., required=..., help=..., metavar=...): ... - def __call__(self, parser, namespace, values, option_string=...): ... - -class _AppendConstAction(Action): - def __init__(self, option_strings, dest, const, default=..., required=..., help=..., - metavar=...): ... - def __call__(self, parser, namespace, values, option_string=...): ... - -class _CountAction(Action): - def __init__(self, option_strings, dest, default=..., required=..., help=...) -> None: ... - def __call__(self, parser, namespace, values, option_string=...): ... - -class _HelpAction(Action): - def __init__(self, option_strings, dest=..., default=..., help=...) -> None: ... - def __call__(self, parser, namespace, values, option_string=...): ... - -class _VersionAction(Action): - version = ... # type: Any - def __init__(self, option_strings, version=..., dest=..., default=..., - help=...): ... - def __call__(self, parser, namespace, values, option_string=...): ... - -class _SubParsersAction(Action): - def __init__(self, option_strings, prog, parser_class, dest=..., help=..., - metavar=...): ... - def add_parser(self, name, **kwargs): ... - def __call__(self, parser, namespace, values, option_string=...): ... - -class FileType: - def __init__(self, mode=..., bufsize=..., encoding=..., errors=...) -> None: ... - def __call__(self, string): ... - -class Namespace(_AttributeHolder): - def __init__(self, **kwargs) -> None: ... - def __eq__(self, other): ... - def __ne__(self, other): ... - def __contains__(self, key): ... - def __getattr__(self, name: str) -> Any: ... - -class _ActionsContainer: - description = ... # type: Any - argument_default = ... # type: Any - prefix_chars = ... # type: Any - conflict_handler = ... # type: Any - def __init__(self, description, prefix_chars, argument_default, conflict_handler) -> None: ... - def register(self, registry_name, value, object): ... - def set_defaults(self, **kwargs): ... - def get_default(self, dest): ... - def add_argument(self, - *args: str, - action: Union[str, Action] = ..., - nargs: str = ..., - const: Any = ..., - default: Any = ..., - type: Any = ..., - choices: Any = ..., # TODO: Container? - required: bool = ..., - help: str = ..., - metavar: str = ..., - dest: str = ..., - version: str = ... - ) -> None: ... - def add_argument_group(self, *args, **kwargs): ... - def add_mutually_exclusive_group(self, **kwargs): ... - -class _ArgumentGroup(_ActionsContainer): - title = ... # type: Any - def __init__(self, container, title=..., description=..., **kwargs) -> None: ... - -class _MutuallyExclusiveGroup(_ArgumentGroup): - required = ... # type: Any - def __init__(self, container, required=...) -> None: ... - -class ArgumentParser(_AttributeHolder, _ActionsContainer): - prog = ... # type: Any - usage = ... # type: Any - epilog = ... # type: Any - formatter_class = ... # type: Any - fromfile_prefix_chars = ... # type: Any - add_help = ... # type: Any - def __init__(self, prog=..., usage=..., description=..., epilog=..., parents=..., - formatter_class=..., prefix_chars=..., fromfile_prefix_chars=..., - argument_default=..., conflict_handler=..., add_help=...): ... - def add_subparsers(self, **kwargs): ... - def parse_args(self, args: Sequence[str] = ..., namespace=...) -> Namespace: ... - def parse_known_args(self, args=..., namespace=...): ... - def convert_arg_line_to_args(self, arg_line): ... - def format_usage(self): ... - def format_help(self): ... - def print_usage(self, file=...): ... - def print_help(self, file=...): ... - def exit(self, status=..., message=...): ... - def error(self, message): ...