Why there are three (...) dots written in the end of optparse.pyi implementation in vscode python-language-server?

Question

I often encounter three dots (...) in the source code of many programs. I google about it but I did not find any relevant answer. I am wondering why these ... are at end of methods the source code implementation of python library optparse. Here is the example Class from the library.

class HelpFormatter:
    def __init__(self, indent_increment: int, max_help_position: int, width: Optional[int], short_first: int) -> None: ...
    def _format__Text(self, _Text: _Text) -> _Text: ...
    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: OptionParser) -> _Text: ...
    def format_option_strings(self, option: OptionParser) -> Any: ...
    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: ...

Why there are ... dots at the end of every method of the above code. What is its purpose?

Here is image how code look like

See that *where*? It's not in https://github.com/python/cpython/blob/37440eef7f9a0c27e13fc9ce0850574bb00688b0/Lib/optparse.py#L161, for example. — jonrsharpe, Dec 08 '20 at 20:18
That's not the actual class definition. That appears to be some sort of "stub file" that just gives names & types for the parameters and return values of the methods, probably for the benefit of the IDE you're using. — jasonharper, Dec 08 '20 at 20:20
here is the ref https://github.com/microsoft/python-language-server/blob/master/src/Analysis/Ast/Impl/Typeshed/stdlib/2and3/optparse.pyi — Sardar Badar Saghir, Dec 09 '20 at 08:10

score 2 · Accepted Answer · answered Dec 08 '20 at 20:24

2

I think, it's kinda "interface" realization. It's equal to:

def func():
    pass

answered Dec 08 '20 at 20:24

vhshunter

46
1

Why there are three (...) dots written in the end of optparse.pyi implementation in vscode python-language-server?

1 Answers1