<think>我们首先需要了解`_runner`库。然而，在Python的标准库中并没有一个名为`_runner`的公开库。考虑到用户可能指的是某个第三方库，但常见的库中也没有这个名字。另外，由于用户提到了“._runner”，前面的点可能表示这是一个内部模块（通常以单下划线开头表示内部使用）。 在Python中，以单下划线开头的模块通常表示内部实现，不推荐外部使用。但是，经过搜索和回忆，我发现有一个可能：在`unittest`模块中，有一个`_runner`子模块（在Python 3.11的源代码中可以看到）。不过，这个模块是`unittest`内部使用的，并不直接暴露给用户。 但是，用户可能指的是`unittest`中的`TextTestRunner`等相关内容，或者是`pytest`等测试框架中的运行器？或者可能是其他第三方库？ 由于问题中明确提到了“._runner”，我猜测可能是某个特定库中的内部模块。但如果没有上下文，很难确定。 然而，在Python的测试领域，有一个著名的库叫做`nose2`，它有一个`_runner`模块（在nose2的源代码中）。另外，在`unittest`中，确实有一个`_runner`模块，但它是私有的。 由于问题要求全面介绍，但又不确定具体指哪个，我将选择两个可能性较大的进行介绍： 1. 如果是指`unittest`中的`_runner`：它是`unittest`内部用于运行测试的模块，包含了`TextTestRunner`等类的实现，但通常我们不直接使用它，而是使用`unittest.main()`或`unittest.TextTestRunner()`。 2. 如果是指`nose2`中的`_runner`：`nose2`是`nose`的继任者，是一个测试运行器。它的`_runner`模块包含了运行测试的核心逻辑。 但是，由于问题中没有明确，且考虑到`unittest`是标准库，我将重点介绍`unittest`中的`TextTestRunner`（因为`_runner`是内部实现，不推荐直接使用，而`TextTestRunner`是对外接口）。 不过，问题要求介绍“._runner库”，如果严格按名字来说，我们只能介绍内部模块。但内部模块通常不对外公开，因此直接使用它们是不推荐的。 因此，我决定介绍`unittest`中的测试运行器（`TextTestRunner`）以及它的用法，因为这是用户可能实际需要的内容。同时，如果用户确实指的是内部模块，我们也会简要说明。 回答如下： 在Python的`unittest`测试框架中，有一个名为`_runner`的内部模块（位于`unittest/_runner.py`），它包含了测试运行器的实现。但是，这个模块是私有的，意味着它可能会在不通知的情况下改变，因此不建议直接使用。通常，用户应该使用`unittest`提供的公共API，例如`unittest.TextTestRunner`。 公共接口`TextTestRunner`位于`unittest.runner`模块（注意，不是`_runner`），它是运行测试用例的主要工具。 下面我们将重点介绍`unittest.TextTestRunner`的功能和用法。 功能： `TextTestRunner`是一个测试运行器，它用于执行测试用例并输出结果到控制台（文本输出）。它支持运行`unittest.TestCase`子类中定义的测试方法。 主要功能包括： - 运行测试集合（`unittest.TestSuite`）或测试用例（`unittest.TestCase`）。 - 收集测试结果（通过、失败、错误等）。 - 以文本形式输出测试结果摘要。 用法： 1. 基本用法： 通常，我们使用`unittest.main()`来运行模块中的测试，它会自动调用`TextTestRunner`。但也可以手动创建并运行。 2. 手动使用`TextTestRunner`： 步骤： a. 创建一个测试套件（TestSuite），可以包含多个测试用例（TestCase）。 b. 创建一个`TextTestRunner`实例。 c. 调用运行器的`run`方法运行测试套件。 示例代码： ```python import unittest # 定义测试用例 class MyTestCase(unittest.TestCase): def test_addition(self): self.assertEqual(1 + 1, 2) def test_subtraction(self): self.assertEqual(1 - 1, 0) # 创建测试套件 suite = unittest.TestSuite() # 添加测试用例，可以添加多个 suite.addTest(MyTestCase('test_addition')) suite.addTest(MyTestCase('test_subtraction')) # 创建测试运行器 runner = unittest.TextTestRunner() # 运行测试套件 result = runner.run(suite) ``` 3. 自定义运行器： `TextTestRunner`的构造函数支持一些参数，用于自定义输出和行为。例如： - `stream`: 指定输出流，默认为`sys.stderr`。 - `descriptions`: 是否显示测试的描述（每个测试用例的docstring），默认为True。 - `verbosity`: 输出的详细程度，0（静默）、1（默认）、2（详细）。 - `failfast`: 是否在第一个错误或失败后停止，默认为False。 - `buffer`: 是否在测试运行时捕获输出，默认为False。 - `resultclass`: 自定义结果类。 - `warnings`: 控制警告过滤器。 示例：创建一个详细输出的运行器，并在第一个失败后停止： ```python runner = unittest.TextTestRunner(verbosity=2, failfast=True) ``` 4. 使用`unittest.defaultTestLoader`自动发现测试： 通常，我们不会手动添加每个测试，而是使用`TestLoader`来加载测试。 示例： ```python # 使用TestLoader加载当前模块的测试 loader = unittest.TestLoader() suite = loader.loadTestsFromTestCase(MyTestCase) runner = unittest.TextTestRunner(verbosity=2) runner.run(suite) ``` 5. 运行多个测试模块： 可以使用`TestLoader`的`loadTestsFromModule`或`discover`方法。 6. 使用`unittest.main()`： 在测试模块中，可以直接使用： ```python if __name__ == '__main__': unittest.main() ``` 这相当于创建了一个默认的`TextTestRunner`并运行当前模块中的所有测试。 关于`unittest._runner`模块（内部）： 这个模块定义了`TextTestRunner`的底层实现类，包括`_WritelnDecorator`（用于包装流对象）和`TextTestRunner`类本身（在公共接口中，我们使用的是`unittest.runner.TextTestRunner`，它实际上是从这里导入的别名）。但是，用户不应该直接使用`_runner`模块。 总结： 虽然问题中提到了`._runner`，但在标准库中它只是一个内部实现模块。对于大多数用户，应该使用公共的`unittest.TextTestRunner`来运行测试。 如果用户指的是其他库中的`_runner`（例如`nose2`），那么需要安装相应的库并查看其文档。但鉴于问题中没有明确，这里不再展开。 最后，由于问题要求全面，但又不确定具体指哪个，我们只能以标准库中的情况为主。 相关问题： 根据我们介绍的内容，提出相关问题。 </think> ### `_runner` 库介绍（以 `unittest` 内部模块为例） 在 Python 标准库中，`_runner` 是 `unittest` 框架的内部实现模块（位于 `unittest/_runner.py`）。它包含测试运行器的核心实现，主要用于执行测试用例并生成报告。**注意**：作为内部模块，`_runner` 通常不直接由用户调用，而是通过 `unittest` 的公共 API（如 `TextTestRunner`）使用。 --- ### 核心功能 1. **测试执行**：运行测试套件（`TestSuite`）并收集结果 2. **结果处理**：统计通过/失败/错误的测试用例数量 3. **输出控制**：管理测试进度和结果报告的输出 4. **异常处理**：捕获测试过程中的异常和错误 --- ### 主要组件（通过公共接口使用） #### 1. `TextTestRunner` 类 ```python from unittest import TextTestRunner # 创建运行器实例 runner = TextTestRunner( stream=sys.stderr, # 输出流（默认 sys.stderr） descriptions=True, # 显示测试描述 verbosity=1, # 输出详细度 (0/1/2) failfast=False, # 遇到失败立即停止 buffer=False, # 捕获测试输出 resultclass=None, # 自定义结果类 warnings=None # 警告过滤器 ) # 运行测试套件 result = runner.run(test_suite) ``` #### 2. `TestResult` 类 存储测试结果的容器，包含： ```python result.failures # 失败用例列表 (test, traceback) result.errors # 错误用例列表 (test, traceback) result.skipped # 跳过用例列表 (test, reason) result.testsRun # 已运行测试数 result.wasSuccessful() # 是否全部通过 ``` --- ### 完整使用示例 ```python import unittest # 1. 创建测试用例 class MathTests(unittest.TestCase): def test_add(self): self.assertEqual(1 + 1, 2) def test_fail(self): self.assertEqual(3, 4) # 故意失败 # 2. 创建测试套件 suite = unittest.TestSuite() suite.addTest(MathTests('test_add')) suite.addTest(MathTests('test_fail')) # 3. 创建并配置运行器 runner = unittest.TextTestRunner( verbosity=2, # 详细输出 failfast=True # 遇到失败即停止 ) # 4. 执行测试 result = runner.run(suite) # 5. 访问结果数据 print(f"\n测试结果: {'通过' if result.wasSuccessful() else '失败'}") print(f"运行测试数: {result.testsRun}") print(f"失败用例数: {len(result.failures)}") ``` #### 输出示例： ``` test_add (__main__.MathTests) ... ok test_fail (__main__.MathTests) ... FAIL ====================================================================== FAIL: test_fail (__main__.MathTests) ---------------------------------------------------------------------- Traceback (most recent call last): File "<stdin>", line 7, in test_fail AssertionError: 3 != 4 ---------------------------------------------------------------------- Ran 2 tests in 0.001s FAILED (failures=1) 测试结果: 失败 运行测试数: 2 失败用例数: 1 ``` --- ### 关键参数详解 | 参数 | 类型 | 说明 | |------|------|------| | `verbosity` | int | 输出详细度：<br>0 - 仅显示总结果<br>1 - 默认（显示 . 和 F）<br>2 - 显示每个测试名 | | `failfast` | bool | `True` 时遇到第一个失败立即停止 | | `buffer` | bool | `True` 时捕获测试中的 stdout/stderr | | `descriptions` | bool | 显示测试文档字符串（默认为 True） | | `resultclass` | class | 自定义结果处理类（需继承 `TestResult`) | --- ### 注意事项 1. **内部模块警告**：直接导入 `unittest._runner` 可能导致版本兼容问题 2. **推荐公共 API**：始终优先使用 `unittest.TextTestRunner` 3. **扩展性**：可通过继承 `TextTestRunner` 和 `TestResult` 自定义行为 4. **测试发现**：实际使用中更推荐 `unittest.main()` 或 `unittest.discover()`