diff --git a/lang/en/typeshed/stdlib/builtins.pyi b/lang/en/typeshed/stdlib/builtins.pyi index 2a61cd3..8ddd1f9 100644 --- a/lang/en/typeshed/stdlib/builtins.pyi +++ b/lang/en/typeshed/stdlib/builtins.pyi @@ -1,4 +1,4 @@ -"""Use builtin classes and functions +"""Built-in classes and functions """ import sys @@ -392,55 +392,55 @@ class str(Sequence[str]): def count( self, x: str, - __start: SupportsIndex | None = ..., - __end: SupportsIndex | None = ..., + start: SupportsIndex | None = ..., + end: SupportsIndex | None = ..., ) -> int: """Get the number of non-overlapping occurences of a substring in the string. - The optional ``__start`` and ``__end`` arguments can be used to specify a substring in which to count. + The optional ``start`` and ``end`` arguments can be used to specify a substring in which to count. Example: ``count = "banana".count("na")`` :param x: The substring to count. - :param __start: Optional argument to specify the start of the substring in which to count. - :param __end: Optional argument to specify the end of the substring in which to count. + :param start: Optional argument to specify the start of the substring in which to count. + :param end: Optional argument to specify the end of the substring in which to count. :return: The number of non-overlapping occurences of a substring in the string as an ``int``. """ ... def encode(self, encoding: str = ..., errors: str = ...) -> bytes: ... def endswith( self, - __suffix: str | Tuple[str, ...], - __start: SupportsIndex | None = ..., - __end: SupportsIndex | None = ..., + suffix: str | Tuple[str, ...], + start: SupportsIndex | None = ..., + end: SupportsIndex | None = ..., ) -> bool: """Check if the string ends with a substring. - The optional ``__start`` and ``__end`` arguments can be used to specify the range to test. + The optional ``start`` and ``end`` arguments can be used to specify the range to test. Example: ``ends_with_hello = "hello, world".endswith("hello")`` - :param __prefix: The prefix to check for. - :param __start: Optional argument to specify the start of the substring to test. - :param __end: Optional argument to specify the end of the substring to test. + :param prefix: The prefix to check for. + :param start: Optional argument to specify the start of the substring to test. + :param end: Optional argument to specify the end of the substring to test. :return: ``True`` if the string ends with the substring, otherwise ``False``. """ ... def find( self, - __sub: str, - __start: SupportsIndex | None = ..., - __end: SupportsIndex | None = ..., + sub: str, + start: SupportsIndex | None = ..., + end: SupportsIndex | None = ..., ) -> int: """Get the lowest index of where the substring is found. - The optional ``__start`` and ``__end`` arguments can be used to specify a substring in which to search. + The optional ``start`` and ``end`` arguments can be used to specify a substring in which to search. Example: ``index = "banana".find("na")`` - :param __sub: The substring to find. - :param __start: Optional argument to specify the start of the substring in which to search. - :param __end: Optional argument to specify the end of the substring in which to search. + :param sub: The substring to find. + :param start: Optional argument to specify the start of the substring in which to search. + :param end: Optional argument to specify the end of the substring in which to search. :return: The the lowest index of where the substring is found, -1 if not found. """ ... @@ -509,32 +509,32 @@ class str(Sequence[str]): :return: A copy of the string with the leading characters removed. """ ... - def replace(self, __old: str, __new: str, __count: SupportsIndex = ...) -> str: + def replace(self, old: str, new: str, count: SupportsIndex = ...) -> str: """Get a copy of the string with all occurrences of the old substring replaced by new. Example: ``replaced = "apple, orange".replace("orange", "banana")`` - :param __old: The substring to replace. - :param __new: The replacement substring. - :param __count: Optional argument to specify the number of occurences of the old substring that should be replaced. + :param old: The substring to replace. + :param new: The replacement substring. + :param count: Optional argument to specify the number of occurences of the old substring that should be replaced. :return: A copy of the string with all occurrences of the old substring replaced by new. """ ... def rfind( self, - __sub: str, - __start: SupportsIndex | None = ..., - __end: SupportsIndex | None = ..., + sub: str, + start: SupportsIndex | None = ..., + end: SupportsIndex | None = ..., ) -> int: """Get the highest index of where the substring is found. - The optional ``__start`` and ``__end`` arguments can be used to specify a substring in which to search. + The optional ``start`` and ``end`` arguments can be used to specify a substring in which to search. Example: ``index = "banana".rfind("na")`` - :param __sub: The substring to find. - :param __start: Optional argument to specify the start of the substring in which to search. - :param __end: Optional argument to specify the end of the substring in which to search. + :param sub: The substring to find. + :param start: Optional argument to specify the start of the substring in which to search. + :param end: Optional argument to specify the end of the substring in which to search. :return: The the highest index of where the substring is found, -1 if not found. """ ... @@ -561,28 +561,28 @@ class str(Sequence[str]): ) -> list[str]: ... def startswith( self, - __prefix: str | Tuple[str, ...], - __start: SupportsIndex | None = ..., - __end: SupportsIndex | None = ..., + prefix: str | Tuple[str, ...], + start: SupportsIndex | None = ..., + end: SupportsIndex | None = ..., ) -> bool: """Check if the string starts with a substring. - The optional ``__start`` and ``__end`` arguments can be used to specify the range to test. + The optional ``start`` and ``end`` arguments can be used to specify the range to test. Example: ``starts_with_hello = "hello, world".startswith("hello")`` - :param __prefix: The prefix to check for. - :param __start: Optional argument to specify the start of the substring to test. - :param __end: Optional argument to specify the end of the substring to test. + :param prefix: The prefix to check for. + :param start: Optional argument to specify the start of the substring to test. + :param end: Optional argument to specify the end of the substring to test. :return: ``True`` if the string starts with the substring, otherwise ``False``. """ ... - def strip(self, __chars: str | None = ...) -> str: + def strip(self, chars: str | None = ...) -> str: """Get a copy of the string with the leading and trailing characters removed. Example: ``stripped = " hello ".strip()`` - :param __chars: (default=" ") The characters to be removed. Defaults to whitespace characters if not provided. + :param chars: (default=" ") The characters to be removed. Defaults to whitespace characters if not provided. :return: A copy of the string with the leading and trailing characters removed. """ ... @@ -875,16 +875,16 @@ class list(MutableSequence[_T], Generic[_T]): """ ... def copy(self) -> list[_T]: ... - def append(self, __object: _T) -> None: + def append(self, object: _T) -> None: """Add an item to the end of the list. Example: ``[1, 2, 3].append(4)`` - :param __object: An item to add the end of the list. + :param object: An item to add the end of the list. """ ... def extend(self, __iterable: Iterable[_T]) -> None: ... - def pop(self, __index: SupportsIndex = ...) -> _T: + def pop(self, index: SupportsIndex = ...) -> _T: """Remove and return an item from the list. If no ``index`` is provided, the last item in the list is removed. @@ -897,34 +897,34 @@ class list(MutableSequence[_T], Generic[_T]): """ ... def index( - self, __value: _T, __start: SupportsIndex = ..., __stop: SupportsIndex = ... + self, value: _T, start: SupportsIndex = ..., stop: SupportsIndex = ... ) -> int: ... - def count(self, __value: _T) -> int: + def count(self, value: _T) -> int: """Get the number of times an item appears in the list. Example: ``["a", "b", "a"].count("a")`` - :param __value: The item to count. + :param value: The item to count. :return: The number of times an item appears in the list. """ ... - def insert(self, __index: SupportsIndex, __object: _T) -> None: + def insert(self, index: SupportsIndex, object: _T) -> None: """Insert an item into the list at a given position. Example: ``["a", "b", "a"].insert(2, "c")`` - :param __index: The position at which to insert the item. - :param __object: The item to insert. + :param index: The position at which to insert the item. + :param object: The item to insert. """ ... - def remove(self, __value: _T) -> None: + def remove(self, value: _T) -> None: """Remove the first occurence of a value from the list. A ``ValueError`` is raised if the ``value`` does not appear in the list. Example: ``["a", "b", "a"].remove("a")`` - :param __value: The item to remove. + :param value: The item to remove. """ ... def reverse(self) -> None: @@ -1143,12 +1143,12 @@ class _NotImplementedType(Any): # type: ignore NotImplemented: _NotImplementedType -def abs(__x: SupportsAbs[_T]) -> _T: +def abs(x: SupportsAbs[_T]) -> _T: """Get the absolute value of a number. Example: ``abs(-42)`` - :param __x: A number. + :param x: A number. :return: The length of or number of items in an object. """ ... @@ -1160,12 +1160,12 @@ if sys.version_info >= (3, 7): def breakpoint(*args: Any, **kws: Any) -> None: ... def callable(__obj: object) -> bool: ... -def chr(__i: int) -> str: +def chr(i: int) -> str: """Get a Unicode string representation of an integer. Example: ``chr(97)`` - :param __i: An integer within the range 0..1,114,111. + :param i: An integer within the range 0..1,114,111. :return: A Unicode string representation of a number within a valid range. """ ... @@ -1231,7 +1231,7 @@ def help(request: object) -> None: Example: ``help("print")`` """ ... -def hex(__number: int | SupportsIndex) -> str: +def hex(number: int | SupportsIndex) -> str: """Get the hexadecimal representation of an integer. Example: ``hex(42)`` @@ -1278,7 +1278,7 @@ else: __cls: type, __class_or_tuple: type | Tuple[type | Tuple[Any, ...], ...] ) -> bool: ... -def len(__obj: Sized) -> int: +def len(obj: Sized) -> int: """Get the length of, or number of items in an object. Example: ``len("Hello, world")`` @@ -1438,12 +1438,12 @@ def open( closefd: bool = ..., opener: _Opener | None = ..., ) -> IO[Any]: ... -def ord(__c: str | bytes) -> int: +def ord(c: str | bytes) -> int: """Get an integer representation of a Unicode character. Example: ``ord("a")`` - :param __c: A Unicode character. + :param c: A Unicode character. :return: The length of or number of items in an object. """ ...