Skip to content
Python Test Anything Protocol (TAP) tools
Branch: master
Clone or download
Latest commit 79a7493 Jan 23, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs Update copyright year to 2019. Jan 23, 2019
tap Update copyright year to 2019. Jan 23, 2019
.codecov.yml Ignore the tests directory. (#65) Sep 22, 2016
.gitignore Add version 13 support (#70) May 13, 2018
.travis.yml Add official support for Python 3.7 (#83) Jan 23, 2019
AUTHORS Write the plan line up front in streaming mode (#80) Sep 14, 2018
LICENSE Update copyright year to 2019. Jan 23, 2019
MANIFEST.in Switch to Pipenv for managing development. Jan 7, 2018
Pipfile Add official support for Python 3.7 (#83) Jan 23, 2019
Pipfile.lock Use Black. Sep 14, 2018
README.md Add official support for Python 3.7 (#83) Jan 23, 2019
appveyor.yml
setup.cfg
setup.py
tox.ini Add official support for Python 3.7 (#83) Jan 23, 2019
transifex.py Update copyright year to 2019. Jan 23, 2019

README.md

tappy

PyPI version BSD license Linux status OS X status Windows status Coverage

TAP logo

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

Full documentation for tappy is at Read the Docs. The information below provides a synopsis of what tappy supplies.

For the curious: tappy sounds like "happy."

If you find tappy useful, please consider starring the repository to show a kindness and help others discover something valuable. Thanks!

Installation

tappy is available for download from PyPI. tappy is currently supported on Python 2.7, 3.4, 3.5, 3.6, 3.7, and PyPy. It is continuously tested on Linux, OS X, and Windows.

$ pip install tap.py

For testing with pytest, you only need to install pytest-tap.

$ pip install pytest-tap

For testing with nose, you only need to install nose-tap.

$ pip install nose-tap

TAP version 13 brings support for YAML blocks associated with test results. To work with version 13, install the optional dependencies. Learn more about YAML support in the TAP version 13 section.

$ pip install tap.py[yaml]

Motivation

Some projects have mixed programming environments with many programming languages and tools. Because of TAP's simplicity, it can function as a lingua franca for testing. When every testing tool can create TAP, a team can get a holistic view of their system. Python did not have a bridge from unittest to TAP so it was difficult to integrate a Python test suite into a larger TAP ecosystem.

tappy is Python's bridge to TAP.

TAP streaming demo

Goals

  1. Provide TAP Producers which translate Python's unittest into TAP.
  2. Provide a TAP Consumer which reads TAP and provides a programmatic API in Python or generates summary results.
  3. Provide a command line interface for reading TAP.

Producers

  • TAPTestRunner - This subclass of unittest.TextTestRunner provides all the functionality of TextTestRunner and generates TAP files.
  • tappy for nose - nose-tap provides a plugin for the nose testing tool.
  • tappy for pytest - pytest-tap provides a plugin for the pytest testing tool.

Consumers

  • tappy - A command line tool for processing TAP files.
  • Loader and Parser - Python APIs for handling of TAP files and data.

Contributing

The project welcomes contributions of all kinds. Check out the contributing guidelines for tips on how to get started.

You can’t perform that action at this time.