taptaptap 1.2.1

目录

• Compatibility
• Changelog
• The File Format
• Testsuite & Examples
• Command line tools
• Pickling
• When to use ^{tt1}$

Compatibility

taptaptap只应该使用python 2.7（由于with语句和argparse）。 它完全支持Unicode。 它已经在2.7.15rc1上用Xubuntu 18.04（Linux4.15x86x64）进行了测试。python 3.x的一个版本作为包taptaptap3提供。

Changelog

The File Format

维基百科提供了一个基本的介绍。格式由Perl社区指定。

• The Wikipedia article
• Original specification
• Test::Harness

Testsuite & Examples

taptaptap附带了一个testsuite，它涵盖了tap格式的许多特殊情况，并测试了所提供的api。请不要犹豫报告任何issues。

您可以使用：

./run.sh

在测试目录中。testsuite还显示了一些api使用示例，但我想在这里提供一些。如果您使用的是python repl:

from taptaptap.proc import plan, ok, not_ok, out
plan(tests=10)
ok('Starting the robot')
not_ok('Starting the engine')
not_ok('Find the object', skip='Setup required')
not_ok('Terminate', skip='Setup required')

out()

输出如下：

1..10
ok - Starting the robot
not ok - Starting the engine
not ok - Find the object  # SKIP Setup required
not ok - Terminate  # SKIP Setup required

请注意，状态存储在模块中。如果你在REPL之外，这不是你想要的。在这种情况下，TapWriter类更方便：

import taptaptap

writer = taptaptap.TapWriter()
writer.plan(1, 3)
writer.ok('This testcase went fine')
writer.ok('And another one')
writer.ok('And also the last one')

如果您喜欢python的生成器，则需要使用SimpleTapCreator：

@taptaptap.SimpleTapCreator
def runTests():
    yield True
    yield True
    yield False

print runTests()

给我们：

1..3
ok
ok
not ok

或者看看更复杂的TapCreator。如果您是一个真正的专家，您可以直接使用TapDocument，这涵盖了tap的所有可能性。

Command line tools

您还可以直接从命令行调用taptaptap：

python -m taptaptap.__main__ some_tap_file_to_validate.tap

此命令将解析文件并以模块理解的方式写入文件。退出代码表示其有效性：

0

一切都很好。

1

TAP文件缺少一些测试用例或包含失败的测试用例。

2

提出了一项救助计划。因此，测试环境在运行期间崩溃。

Pickling

所有对象都是可拾取的。

When to use ^{tt1}$

taptaptap满足您的需求吗？ 如果您正在为tap文档寻找一个解析器和验证器，而您不想关心细节，只需要一个温和的api，那么就可以了。

谨致问候， 梅斯特鲁克