Skip to main content

SubUnit details parser - Test detail attachment extractor.

Project description

Requires:
  • Python 3.x
  • python-subunit
  • testtools
Author:
  • Corey Goldberg, 2014

About subunitdetails:

subunitdetails takes a binary encoded subunit stream, and extracts test details (content object attachments) and saves them to the filesystem.

Using subunitdetails to extract content object attachments:

Invoke the subunitdetails script, with a subunit file name as an argument. It will extract the embedded content objects (test details) from the subunit result, into the current directory:

$ subunitdetails <file_name>

About SubUnit:

SubUnit is a streaming protocol for test results. The protocol is a binary encoding that is easily generated and parsed. By design all the components of the protocol conceptually fit into the xUnit TestCase -> TestResult interaction.

About Test Details:

Details are MIME-based content objects that may be attached to a TestCase. This is done using the testtools library (extensions to Python’s standard unittest lib). It allows you to attach any information that you could possibly conceive of to a test, and allows testtools to use or serialize that information.

Using subunit, the encoded stream can be parsed. Test suite results and attached Details (with MIME-types) can then be retrieved.

Installing subunitdetails:

subunit-details uses standard python packaging via setuptools.

There are a few ways to install subunitdetails.

  • Install from PyPI using pip (system-wide):

    $ sudo pip install subunitdetails
    
  • Install from PyPI using pip, into a virtualenv::

    $ virtualenv -p python3 .env
    $ source .env/bin/activate
    $ pip install subunitdetails
    
  • Clone the dev repository and install, using a virtualenv:

    $ git clone https://github.com/cgoldberg/subunitdetails.git
    $ cd subunitdetails
    $ virtualenv -p python3 .env
    $ source .env/bin/activate
    $ python3 setup install
    

Project details


Release history Release notifications

This version
History Node

0.0.4

History Node

0.0.3

History Node

0.0.2

History Node

0.0.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
subunitdetails-0.0.4.tar.gz (3.6 kB) Copy SHA256 hash SHA256 Source None Jul 3, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page