Skip to main content

SubUnit details parser - Test detail attachment extractor.

Project description

  • Python 3.x
  • python-subunit
  • testtools
  • 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
    $ cd subunitdetails
    $ virtualenv -p python3 .env
    $ source .env/bin/activate
    $ python3 setup install

Project details

Download files

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

Source Distribution

subunitdetails-0.0.4.tar.gz (3.6 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page