apply black and isort (#4287)

* apply black and isort * move some type ignores
2026-02-20 00:28:28 +08:00 · 2020-06-28 13:31:00 -07:00
parent fe58699ca5
commit 5d553c9584
800 changed files with 13875 additions and 10332 deletions
--- a/stdlib/2and3/doctest.pyi
+++ b/stdlib/2and3/doctest.pyi
@@ -1,15 +1,16 @@
-from typing import Any, Callable, Dict, List, NamedTuple, Optional, Tuple, Type, Union
-
 import sys
 import types
 import unittest
+from typing import Any, Callable, Dict, List, NamedTuple, Optional, Tuple, Type, Union

 class TestResults(NamedTuple):
    failed: int
    attempted: int

 OPTIONFLAGS_BY_NAME: Dict[str, int]
+
 def register_optionflag(name: str) -> int: ...
+
 DONT_ACCEPT_TRUE_FOR_1: int
 DONT_ACCEPT_BLANKLINE: int
 NORMALIZE_WHITESPACE: int
@@ -38,8 +39,15 @@ class Example:
    lineno: int
    indent: int
    options: Dict[int, bool]
-    def __init__(self, source: str, want: str, exc_msg: Optional[str] = ..., lineno: int = ..., indent: int = ...,
-                 options: Optional[Dict[int, bool]] = ...) -> None: ...
+    def __init__(
+        self,
+        source: str,
+        want: str,
+        exc_msg: Optional[str] = ...,
+        lineno: int = ...,
+        indent: int = ...,
+        options: Optional[Dict[int, bool]] = ...,
+    ) -> None: ...
    def __hash__(self) -> int: ...

 class DocTest:
@@ -49,20 +57,37 @@ class DocTest:
    filename: Optional[str]
    lineno: Optional[int]
    docstring: Optional[str]
-    def __init__(self, examples: List[Example], globs: Dict[str, Any], name: str, filename: Optional[str], lineno: Optional[int], docstring: Optional[str]) -> None: ...
+    def __init__(
+        self,
+        examples: List[Example],
+        globs: Dict[str, Any],
+        name: str,
+        filename: Optional[str],
+        lineno: Optional[int],
+        docstring: Optional[str],
+    ) -> None: ...
    def __hash__(self) -> int: ...
    def __lt__(self, other: DocTest) -> bool: ...

 class DocTestParser:
    def parse(self, string: str, name: str = ...) -> List[Union[str, Example]]: ...
-    def get_doctest(self, string: str, globs: Dict[str, Any], name: str, filename: Optional[str], lineno: Optional[int]) -> DocTest: ...
+    def get_doctest(
+        self, string: str, globs: Dict[str, Any], name: str, filename: Optional[str], lineno: Optional[int]
+    ) -> DocTest: ...
    def get_examples(self, string: str, name: str = ...) -> List[Example]: ...

 class DocTestFinder:
-    def __init__(self, verbose: bool = ..., parser: DocTestParser = ...,
-                 recurse: bool = ..., exclude_empty: bool = ...) -> None: ...
-    def find(self, obj: object, name: Optional[str] = ..., module: Union[None, bool, types.ModuleType] = ...,
-             globs: Optional[Dict[str, Any]] = ..., extraglobs: Optional[Dict[str, Any]] = ...) -> List[DocTest]: ...
+    def __init__(
+        self, verbose: bool = ..., parser: DocTestParser = ..., recurse: bool = ..., exclude_empty: bool = ...
+    ) -> None: ...
+    def find(
+        self,
+        obj: object,
+        name: Optional[str] = ...,
+        module: Union[None, bool, types.ModuleType] = ...,
+        globs: Optional[Dict[str, Any]] = ...,
+        extraglobs: Optional[Dict[str, Any]] = ...,
+    ) -> List[DocTest]: ...

 _Out = Callable[[str], Any]
 _ExcInfo = Tuple[Type[BaseException], BaseException, types.TracebackType]
@@ -74,13 +99,14 @@ class DocTestRunner:
    tries: int
    failures: int
    test: DocTest
-
    def __init__(self, checker: Optional[OutputChecker] = ..., verbose: Optional[bool] = ..., optionflags: int = ...) -> None: ...
    def report_start(self, out: _Out, test: DocTest, example: Example) -> None: ...
    def report_success(self, out: _Out, test: DocTest, example: Example, got: str) -> None: ...
    def report_failure(self, out: _Out, test: DocTest, example: Example, got: str) -> None: ...
    def report_unexpected_exception(self, out: _Out, test: DocTest, example: Example, exc_info: _ExcInfo) -> None: ...
-    def run(self, test: DocTest, compileflags: Optional[int] = ..., out: Optional[_Out] = ..., clear_globs: bool = ...) -> TestResults: ...
+    def run(
+        self, test: DocTest, compileflags: Optional[int] = ..., out: Optional[_Out] = ..., clear_globs: bool = ...
+    ) -> TestResults: ...
    def summarize(self, verbose: Optional[bool] = ...) -> TestResults: ...
    def merge(self, other: DocTestRunner) -> None: ...

@@ -92,35 +118,62 @@ class DocTestFailure(Exception):
    test: DocTest
    example: Example
    got: str
-
    def __init__(self, test: DocTest, example: Example, got: str) -> None: ...

 class UnexpectedException(Exception):
    test: DocTest
    example: Example
    exc_info: _ExcInfo
-
    def __init__(self, test: DocTest, example: Example, exc_info: _ExcInfo) -> None: ...

 class DebugRunner(DocTestRunner): ...

 master: Optional[DocTestRunner]

-def testmod(m: Optional[types.ModuleType] = ..., name: Optional[str] = ..., globs: Optional[Dict[str, Any]] = ..., verbose: Optional[bool] = ...,
-            report: bool = ..., optionflags: int = ..., extraglobs: Optional[Dict[str, Any]] = ...,
-            raise_on_error: bool = ..., exclude_empty: bool = ...) -> TestResults: ...
-def testfile(filename: str, module_relative: bool = ..., name: Optional[str] = ..., package: Union[None, str, types.ModuleType] = ...,
-             globs: Optional[Dict[str, Any]] = ..., verbose: Optional[bool] = ..., report: bool = ..., optionflags: int = ...,
-             extraglobs: Optional[Dict[str, Any]] = ..., raise_on_error: bool = ..., parser: DocTestParser = ...,
-             encoding: Optional[str] = ...) -> TestResults: ...
-def run_docstring_examples(f: object, globs: Dict[str, Any], verbose: bool = ..., name: str = ...,
-                           compileflags: Optional[int] = ..., optionflags: int = ...) -> None: ...
+def testmod(
+    m: Optional[types.ModuleType] = ...,
+    name: Optional[str] = ...,
+    globs: Optional[Dict[str, Any]] = ...,
+    verbose: Optional[bool] = ...,
+    report: bool = ...,
+    optionflags: int = ...,
+    extraglobs: Optional[Dict[str, Any]] = ...,
+    raise_on_error: bool = ...,
+    exclude_empty: bool = ...,
+) -> TestResults: ...
+def testfile(
+    filename: str,
+    module_relative: bool = ...,
+    name: Optional[str] = ...,
+    package: Union[None, str, types.ModuleType] = ...,
+    globs: Optional[Dict[str, Any]] = ...,
+    verbose: Optional[bool] = ...,
+    report: bool = ...,
+    optionflags: int = ...,
+    extraglobs: Optional[Dict[str, Any]] = ...,
+    raise_on_error: bool = ...,
+    parser: DocTestParser = ...,
+    encoding: Optional[str] = ...,
+) -> TestResults: ...
+def run_docstring_examples(
+    f: object,
+    globs: Dict[str, Any],
+    verbose: bool = ...,
+    name: str = ...,
+    compileflags: Optional[int] = ...,
+    optionflags: int = ...,
+) -> None: ...
 def set_unittest_reportflags(flags: int) -> int: ...

 class DocTestCase(unittest.TestCase):
-    def __init__(self, test: DocTest, optionflags: int = ..., setUp: Optional[Callable[[DocTest], Any]] = ...,
-                 tearDown: Optional[Callable[[DocTest], Any]] = ...,
-                 checker: Optional[OutputChecker] = ...) -> None: ...
+    def __init__(
+        self,
+        test: DocTest,
+        optionflags: int = ...,
+        setUp: Optional[Callable[[DocTest], Any]] = ...,
+        tearDown: Optional[Callable[[DocTest], Any]] = ...,
+        checker: Optional[OutputChecker] = ...,
+    ) -> None: ...
    def setUp(self) -> None: ...
    def tearDown(self) -> None: ...
    def runTest(self) -> None: ...
@@ -138,20 +191,31 @@ class SkipDocTestCase(DocTestCase):

 if sys.version_info >= (3, 4):
    class _DocTestSuite(unittest.TestSuite): ...
+
 else:
    _DocTestSuite = unittest.TestSuite

-def DocTestSuite(module: Union[None, str, types.ModuleType] = ..., globs: Optional[Dict[str, Any]] = ...,
-                 extraglobs: Optional[Dict[str, Any]] = ..., test_finder: Optional[DocTestFinder] = ...,
-                 **options: Any) -> _DocTestSuite: ...
+def DocTestSuite(
+    module: Union[None, str, types.ModuleType] = ...,
+    globs: Optional[Dict[str, Any]] = ...,
+    extraglobs: Optional[Dict[str, Any]] = ...,
+    test_finder: Optional[DocTestFinder] = ...,
+    **options: Any,
+) -> _DocTestSuite: ...

 class DocFileCase(DocTestCase):
    def id(self) -> str: ...
    def format_failure(self, err: str) -> str: ...

-def DocFileTest(path: str, module_relative: bool = ..., package: Union[None, str, types.ModuleType] = ...,
-                globs: Optional[Dict[str, Any]] = ..., parser: DocTestParser = ...,
-                encoding: Optional[str] = ..., **options: Any) -> DocFileCase: ...
+def DocFileTest(
+    path: str,
+    module_relative: bool = ...,
+    package: Union[None, str, types.ModuleType] = ...,
+    globs: Optional[Dict[str, Any]] = ...,
+    parser: DocTestParser = ...,
+    encoding: Optional[str] = ...,
+    **options: Any,
+) -> DocFileCase: ...
 def DocFileSuite(*paths: str, **kw: Any) -> _DocTestSuite: ...
 def script_from_examples(s: str) -> str: ...
 def testsource(module: Union[None, str, types.ModuleType], name: str) -> str: ...