tap.py 3.2.1

Test Anything Protocol (TAP) tools

tappy is a set of tools for working with the Test Anything Protocol (TAP), a line based test protocol for recording test data in a standard way.

Follow tappy development on GitHub. Developer documentation is on Read the Docs.

Releases

Version 3.2, Released January 25, 2025

• Drop support for Python 3.6 (it is end-of-life).

• Drop support for Python 3.7 (it is end-of-life).

• Drop support for Python 3.8 (it is end-of-life).

• Add support for Python 3.11.

• Add support for Python 3.12.

• Add support for Python 3.13.

• Add support for adding diagnostics to ok test.

Version 3.1, Released December 29, 2021

• Add support for Python 3.10.

• Add support for Python 3.9.

• Add support for Python 3.8.

• Drop support for Python 3.5 (it is end-of-life).

• Fix parsing of multi-line strings in YAML blocks (#111)

• Remove unmaintained i18n support.

Version 3.0, Released January 10, 2020

• Drop support for Python 2 (it is end-of-life).

• Add support for subtests.

• Run a test suite with python -m tap.

• Discontinue use of Pipenv for managing development.

Version 2.6.2, Released October 20, 2019

• Fix bug in streaming mode that would generate tap files when the plan was already set (affected pytest).

Version 2.6.1, Released September 17, 2019

• Fix TAP version 13 support from more-itertools behavior change.

Version 2.6, Released September 16, 2019

• Add support for Python 3.7.

• Drop support for Python 3.4 (it is end-of-life).

Version 2.5, Released September 15, 2018

• Add set_plan to Tracker which allows producing the 1..N plan line before any tests.

• Switch code style to use Black formatting.

Version 2.4, Released May 29, 2018

• Add support for producing TAP version 13 output to streaming and file reports by including the TAP version 13 line.

Version 2.3, Released May 15, 2018

• Add optional method to install tappy for YAML support with pip install tap.py[yaml].

• Make tappy version 13 compliant by adding support for parsing YAML blocks.

• unittest.expectedFailure now uses a TODO directive to better align with the specification.

Version 2.2, Released January 7, 2018

• Add support for Python 3.6.

• Drop support for Python 3.3 (it is end-of-life).

• Use Pipenv for managing development.

• Switch to pytest as the development test runner.

Version 2.1, Released September 23, 2016

• Add Parser.parse_text to parse TAP provided as a string.

Version 2.0, Released July 31, 2016

• Remove nose plugin. The plugin moved to the nose-tap distribution.

• Remove pytest plugin. The plugin moved to the pytest-tap distribution.

• Remove Pygments syntax highlighting plugin. The plugin was merged upstream directly into the Pygments project and is available without tappy.

• Drop support for Python 2.6.

Version 1.9, Released March 28, 2016

• TAPTestRunner has a set_header method to enable or disable test case header ouput in the TAP stream.

• Add support for Python 3.5.

• Perform continuous integration testing on OS X.

• Drop support for Python 3.2.

Version 1.8, Released November 30, 2015

• The tappy TAP consumer can read a TAP stream directly from STDIN.

• Tracebacks are included as diagnostic output for failures and errors.

• The tappy TAP consumer has an alternative, shorter name of tap.

• The pytest plugin now defaults to no output unless provided a flag. Users dependent on the old default behavior can use --tap-files to achieve the same results.

• Translated into Arabic.

• Translated into Chinese.

• Translated into Japanese.

• Translated into Russian.

• Perform continuous integration testing on Windows with AppVeyor.

• Improve unit test coverage to 100%.

Version 1.7, Released August 19, 2015

• Provide a plugin to integrate with pytest.

• Document some viable alternatives to tappy.

• Translated into German.

• Translated into Portuguese.

Version 1.6, Released June 18, 2015

• TAPTestRunner has a set_stream method to stream all TAP output directly to an output stream instead of a file. results in a single output file.

• The nosetests plugin has an optional --tap-stream flag to stream all TAP output directly to an output stream instead of a file.

• tappy is now internationalized. It is translated into Dutch, French, Italian, and Spanish.

• tappy is available as a Python wheel package, the new Python packaging standard.

Version 1.5, Released May 18, 2015

• TAPTestRunner has a set_combined method to collect all results in a single output file.

• The nosetests plugin has an optional --tap-combined flag to collect all results in a single output file.

• TAPTestRunner has a set_format method to specify line format.

• The nosetests plugin has an optional --tap-format flag to specify line format.

Version 1.4, Released April 4, 2015

• Update setup.py to support Debian packaging. Include man page.

Version 1.3, Released January 9, 2015

• The tappy command line tool is available as a TAP consumer.

• The Parser and Loader are available as APIs for programmatic handling of TAP files and data.

Version 1.2, Released December 21, 2014

• Provide a syntax highlighter for Pygments so any project using Pygments (e.g., Sphinx) can highlight TAP output.

Version 1.1, Released October 23, 2014

• TAPTestRunner has a set_outdir method to specify where to store .tap files.

• The nosetests plugin has an optional --tap-outdir flag to specify where to store .tap files.

• tappy has backported support for Python 2.6.

• tappy has support for Python 3.2, 3.3, and 3.4.

• tappy has support for PyPy.

Version 1.0, Released March 16, 2014

• Initial release of tappy

• TAPTestRunner - A test runner for unittest modules that generates TAP files.

• Provides a plugin for integrating with nose.