English 中文(简体)
UnitTest Framework - Doctest API
  • 时间:2024-03-19 01:35:07

UnitTest Framework - Doctest API


Previous Page Next Page  

测试后转录器围绕以下两个集装箱类别进行循环,用于储存从护卫处收集的互动实例——

    <>Example-A/63/L,与预期产出配对。

界定了以下额外处理班级,以发现、 par、操作和检查试样。

    在某一模块中选取所有方言,并使用“DocParser”从包含互动实例的每一种方言中选取。

    Output Checker——将试验实例的实际产出与预期产出进行比较,并决定产出是否与产出相符。

DocTestFinder Class

它是用来提取与特定物体有关的试验的加工类别,从试验和含有的物体的探测中提取。 目前可以从下列物体类型中提取检测结果:模块、功能、类别、方法、静态方法、类别方法和特性。

这一类别界定了(a)项方法。 它提交了由object`a界定的Doc《试验清单》。 或通过其中任何物体进行扼杀。

DocTestParser Class

它是从扼杀中提取互动范例的加工类别,利用这些实例制造一种Doc 试验物体。 这一类定义了以下方法:

    get_doctest()- 摘录所有试示例,并将之收集到Doc / 反对。

    get_examples(string [, name]- 摘自上述插图中的所有试样,并将之作为Example物体清单。 线数为0。 任择论点是指明这种说法的名称,只用于错误信息。

    parse(string [, name]) 将所述示例和中间案文分开,并将其作为更改名单Examples和说明。 Examples的线路号码为0。 任择论点是指明这种说法的名称,只用于错误信息。

DocTestRunner Class

这是一个处理班,用于执行和核查多克试验中的互动实例。 定义如下:

report_start()

报告说,测试操作员将处理特定的例子。 提供这一方法是为了让Doc /Runner的子类能够定制其产出;不应直接将其称作

report_success()

报告说,上述例子成功。 提供这一方法是为了让多克罗内纳语的子流体能够定制其产出;不应直接使用。

report_failure()

报告说,该实例失败。 提供这一方法是为了让 Doc TestRunner的子类能够定制其产出;不应直接使用。

report_unexpected_exception()

报告说,上述例子引起了意外的例外情况。 提供这一方法是为了让定制其产出;不应直接叫它。

run(test)

介绍test (a Doc Test Object)中的实例,并利用作者职能out

summarize([verbose])

印本·多雷纳主持的所有试办案例摘要,并报送 tuple 测试结果(失败、尝试)。 任择性verbose论点控制了摘要的细节。 如果未具体说明平均船位,则使用多克试验。

OutputChecker Class

这一类别用于检查测试实例的实际产出是否与预期产出相符。

本类界定了以下方法:

check_output()

如果某一实例(got)的实际产出与预期产出(want)相符,则返回True。 这些指示如果相同,总是被认为相匹配;但取决于试验操作员使用何种选择,也有可能出现几种不实际的配对类型。 关于选择旗帜的更多信息,见Option signsDirectives

output_difference()

回归说明某一例子的预期产出(example)与实际产出(got)之间的差别。

DocTest Integration with Unittest

测试模块提供两种功能,可用于从包含测试的单元和文本文档中创建单位测试套。 将与测试发现结合起来,在检测模块中添加载荷-测试功能——

import unittest
import doctest
import doctestexample

def load_tests(loader, tests, ignore):
   tests.addTests(doctest.DocTestSuite(doctestexample))
   return tests

将形成从单位测试和测试中进行测试的综合分析,现在可以通过单位测试模块(主()方法或操作()方法进行。

The following are the two main functions for estabpshing unittest. TestSuitease from text file and questionnaires with the doctests -

doctest.DocFileSuite()

测试用的是将一个或多个文本文档中的测试转换为unittest。 返回单位测试。 测试分析将由测试组框架管理,并在每个档案中采用互动实例。 如果档案中的任何实例都失败,那么综合单位测试就失败了,而failureException的例外则提出,说明载有测试的文件名称和(有时是大约)线号。

doctest.DocTestSuite()

用于将单元的测试结果转换为unittest. 。

返回单位测试。 测试分析将由测试单位框架管理,并在模块中进行每次测试。 如果试卷失败,则综合单位测试失败,提出“failureException例外情况,说明包含测试的文件名称和(有时大致)线编号。

根据这一规定,Doc 试验(Suite)在试验中制造了一个unittest. 。 多采病例和多采病例是分级单位测试。 测试项目。

同样,DocFileSuite()也创造了一个单位测试。 停试。 DocFile 案例和证据 案件是Doc 案的子类。

因此,两种方法都是创建单位测试。 测验组有多Case。 当你行使测试职能时,你可以通过选择旗帜来测试功能,控制直接使用的试验选择。

然而,如果你书写一个单位测试框架,单位最终会检测试验何时和如何进行。 框架作者通常希望控制测试报告选择(可能的话,例如由指挥线选择规定),但是,没有办法通过单位测试测试操作员进行选择。

Advertisements