/tappy

Python Test Anything Protocol (TAP) tools

Primary LanguagePythonBSD 2-Clause "Simplified" LicenseBSD-2-Clause

tappy

PyPI version BSD license Downloads Linux: Linux status Windows: 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.6, 2.7, 3.2, 3.3, 3.4 and PyPy. It is continuously tested on Linux and Windows. tappy is also translated into Dutch, French, German, Italian, Japanese, Portuguese, and Spanish.

$ pip install tap.py

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 - tappy provides a plugin for the nose testing tool.
  • tappy for pytest - tappy 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.