from typing import IO, Any, AnyStr, Callable, Iterable, Mapping, Sequence, Union, overload

# See https://groups.google.com/forum/#!topic/python-ideas/gA1gdj3RZ5g
_Text = Union[str, unicode]

NO_DEFAULT: tuple[_Text, ...]
SUPPRESS_HELP: _Text
SUPPRESS_USAGE: _Text

def check_builtin(option: Option, opt: Any, value: _Text) -> Any: ...
def check_choice(option: Option, opt: Any, value: _Text) -> Any: ...
def isbasestring(x: Any) -> bool: ...

class OptParseError(Exception):
    msg: _Text
    def __init__(self, msg: _Text) -> None: ...

class BadOptionError(OptParseError):
    opt_str: _Text
    def __init__(self, opt_str: _Text) -> None: ...

class AmbiguousOptionError(BadOptionError):
    possibilities: Iterable[_Text]
    def __init__(self, opt_str: _Text, possibilities: Sequence[_Text]) -> None: ...

class OptionError(OptParseError):
    msg: _Text
    option_id: _Text
    def __init__(self, msg: _Text, option: Option) -> None: ...

class OptionConflictError(OptionError): ...
class OptionValueError(OptParseError): ...

class HelpFormatter:
    NO_DEFAULT_VALUE: _Text
    _long_opt_fmt: _Text
    _short_opt_fmt: _Text
    current_indent: int
    default_tag: _Text
    help_position: Any
    help_width: Any
    indent_increment: int
    level: int
    max_help_position: int
    option_strings: dict[Option, _Text]
    parser: OptionParser
    short_first: Any
    width: int
    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) -> _Text: ...
    def format_description(self, description: _Text) -> _Text: ...
    def format_epilog(self, epilog: _Text) -> _Text: ...
    def format_heading(self, heading: Any) -> _Text: ...
    def format_option(self, option: Option) -> _Text: ...
    def format_option_strings(self, option: Option) -> _Text: ...
    def format_usage(self, usage: Any) -> _Text: ...
    def indent(self) -> None: ...
    def set_long_opt_delimiter(self, delim: _Text) -> None: ...
    def set_parser(self, parser: OptionParser) -> None: ...
    def set_short_opt_delimiter(self, delim: _Text) -> None: ...
    def store_option_strings(self, parser: OptionParser) -> None: ...

class IndentedHelpFormatter(HelpFormatter):
    def __init__(
        self, indent_increment: int = ..., max_help_position: int = ..., width: int | None = ..., short_first: int = ...
    ) -> None: ...
    def format_heading(self, heading: _Text) -> _Text: ...
    def format_usage(self, usage: _Text) -> _Text: ...

class TitledHelpFormatter(HelpFormatter):
    def __init__(
        self, indent_increment: int = ..., max_help_position: int = ..., width: int | None = ..., short_first: int = ...
    ) -> None: ...
    def format_heading(self, heading: _Text) -> _Text: ...
    def format_usage(self, usage: _Text) -> _Text: ...

class Option:
    ACTIONS: tuple[_Text, ...]
    ALWAYS_TYPED_ACTIONS: tuple[_Text, ...]
    ATTRS: list[_Text]
    CHECK_METHODS: list[Callable[..., Any]] | None
    CONST_ACTIONS: tuple[_Text, ...]
    STORE_ACTIONS: tuple[_Text, ...]
    TYPED_ACTIONS: tuple[_Text, ...]
    TYPES: tuple[_Text, ...]
    TYPE_CHECKER: dict[_Text, Callable[..., Any]]
    _long_opts: list[_Text]
    _short_opts: list[_Text]
    action: _Text
    dest: _Text | None
    default: Any
    nargs: int
    type: Any
    callback: Callable[..., Any] | None
    callback_args: tuple[Any, ...] | None
    callback_kwargs: dict[_Text, Any] | None
    help: _Text | None
    metavar: _Text | None
    def __init__(self, *opts: _Text | 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[_Text | None]) -> list[_Text]: ...
    def _check_type(self) -> None: ...
    def _set_attrs(self, attrs: dict[_Text, Any]) -> None: ...
    def _set_opt_strings(self, opts: Iterable[_Text]) -> None: ...
    def check_value(self, opt: _Text, value: Any) -> Any: ...
    def convert_value(self, opt: _Text, value: Any) -> Any: ...
    def get_opt_string(self) -> _Text: ...
    def process(self, opt: Any, value: Any, values: Any, parser: OptionParser) -> int: ...
    def take_action(self, action: _Text, dest: _Text, opt: Any, value: Any, values: Any, parser: OptionParser) -> int: ...
    def takes_value(self) -> bool: ...

make_option = Option

class OptionContainer:
    _long_opt: dict[_Text, Option]
    _short_opt: dict[_Text, Option]
    conflict_handler: _Text
    defaults: dict[_Text, Any]
    description: Any
    option_class: type[Option]
    def __init__(self, option_class: type[Option], conflict_handler: Any, description: Any) -> None: ...
    def _check_conflict(self, option: Any) -> None: ...
    def _create_option_mappings(self) -> None: ...
    def _share_option_mappings(self, parser: OptionParser) -> None: ...
    @overload
    def add_option(self, opt: Option) -> Option: ...
    @overload
    def add_option(self, *args: _Text | None, **kwargs: Any) -> Any: ...
    def add_options(self, option_list: Iterable[Option]) -> None: ...
    def destroy(self) -> None: ...
    def format_description(self, formatter: HelpFormatter | None) -> Any: ...
    def format_help(self, formatter: HelpFormatter | None) -> _Text: ...
    def format_option_help(self, formatter: HelpFormatter | None) -> _Text: ...
    def get_description(self) -> Any: ...
    def get_option(self, opt_str: _Text) -> Option | None: ...
    def has_option(self, opt_str: _Text) -> bool: ...
    def remove_option(self, opt_str: _Text) -> None: ...
    def set_conflict_handler(self, handler: Any) -> None: ...
    def set_description(self, description: Any) -> None: ...

class OptionGroup(OptionContainer):
    option_list: list[Option]
    parser: OptionParser
    title: _Text
    def __init__(self, parser: OptionParser, title: _Text, description: _Text | None = ...) -> None: ...
    def _create_option_list(self) -> None: ...
    def set_title(self, title: _Text) -> None: ...

class Values:
    def __init__(self, defaults: Mapping[str, Any] | None = ...) -> None: ...
    def _update(self, dict: Mapping[_Text, Any], mode: Any) -> None: ...
    def _update_careful(self, dict: Mapping[_Text, Any]) -> None: ...
    def _update_loose(self, dict: Mapping[_Text, Any]) -> None: ...
    def ensure_value(self, attr: _Text, value: Any) -> Any: ...
    def read_file(self, filename: _Text, mode: _Text = ...) -> None: ...
    def read_module(self, modname: _Text, mode: _Text = ...) -> None: ...
    def __getattr__(self, name: str) -> Any: ...
    def __setattr__(self, name: str, value: Any) -> None: ...

class OptionParser(OptionContainer):
    allow_interspersed_args: bool
    epilog: _Text | None
    formatter: HelpFormatter
    largs: list[_Text] | None
    option_groups: list[OptionGroup]
    option_list: list[Option]
    process_default_values: Any
    prog: _Text | None
    rargs: list[Any] | None
    standard_option_list: list[Option]
    usage: _Text | None
    values: Values | None
    version: _Text
    def __init__(
        self,
        usage: _Text | None = ...,
        option_list: Iterable[Option] | None = ...,
        option_class: type[Option] = ...,
        version: _Text | None = ...,
        conflict_handler: _Text = ...,
        description: _Text | None = ...,
        formatter: HelpFormatter | None = ...,
        add_help_option: bool = ...,
        prog: _Text | None = ...,
        epilog: _Text | None = ...,
    ) -> None: ...
    def _add_help_option(self) -> None: ...
    def _add_version_option(self) -> None: ...
    def _create_option_list(self) -> None: ...
    def _get_all_options(self) -> list[Option]: ...
    def _get_args(self, args: Iterable[Any]) -> list[Any]: ...
    def _init_parsing_state(self) -> None: ...
    def _match_long_opt(self, opt: _Text) -> _Text: ...
    def _populate_option_list(self, option_list: Iterable[Option], add_help: bool = ...) -> None: ...
    def _process_args(self, largs: list[Any], rargs: list[Any], values: Values) -> None: ...
    def _process_long_opt(self, rargs: list[Any], values: Any) -> None: ...
    def _process_short_opts(self, rargs: list[Any], values: Any) -> None: ...
    @overload
    def add_option_group(self, __opt_group: OptionGroup) -> OptionGroup: ...
    @overload
    def add_option_group(self, *args: Any, **kwargs: Any) -> OptionGroup: ...
    def check_values(self, values: Values, args: list[_Text]) -> tuple[Values, list[_Text]]: ...
    def disable_interspersed_args(self) -> None: ...
    def enable_interspersed_args(self) -> None: ...
    def error(self, msg: _Text) -> None: ...
    def exit(self, status: int = ..., msg: str | None = ...) -> None: ...
    def expand_prog_name(self, s: _Text | None) -> Any: ...
    def format_epilog(self, formatter: HelpFormatter) -> Any: ...
    def format_help(self, formatter: HelpFormatter | None = ...) -> _Text: ...
    def format_option_help(self, formatter: HelpFormatter | None = ...) -> _Text: ...
    def get_default_values(self) -> Values: ...
    def get_option_group(self, opt_str: _Text) -> Any: ...
    def get_prog_name(self) -> _Text: ...
    def get_usage(self) -> _Text: ...
    def get_version(self) -> _Text: ...
    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: ...
    def set_usage(self, usage: _Text) -> None: ...
