Skip to main content

Python Hooks Bridge for Dredd API Testing Framework

Project description


This package contains a bridge between Dredd API Testing Framework and Python environment to ease implementation of testing hooks provided by Dredd. Write Dredd hooks in Python to glue together API Blueprint with your Python project

Usage example:

import dredd_hooks as hooks

def foo(transactions):
    for t in transactions:
        t['request']['headers']['content-type'] = 'application/json'


You can see all the available versions at PyPI.

From source (tar.gz or checkout)

Unpack the archive, enter the dredd-hooks-python directory and run:

python install


Alternatively it can be installed from PyPI, either manually downloading the files and installing as described above or using:

pip install dredd_hooks


  1. Create a hook file in

import dredd_hooks as hooks

@hooks.before("Machines > Machines collection > Get Machines")
def before_hook(transaction):
    transaction['skip'] = "true"
  1. Run it with Dredd:

    $ dredd apiary.apib localhost:3000 --language python --hookfiles ./


Module dredd_hooks defines following decorators before, after, before_all, after_all, before_each, after_each, before_validation, before_each_validation. before, before_validation and after hooks are identified by transaction name.

You can combine those decorators together. So one function can be used for different hooks but be aware that some hooks have a list of all transactions as an argument and not a single transaction.

import dredd_hooks as hooks

@hooks.before_validation('Machines > Machines collection > Get Machines')
@hooks.before("Machines > Machines collection > Get Machines")
@hooks.after("Machines > Machines collection > Get Machines")
def multi_hook_function(trans):
   if isinstance(trans, list):
       print('called with list of transactions')
       if trans['name'] == 'Machines > Machines collection > Get Machines':
           trans['skip'] = 'true'

Usage is very similar to sync JS hooks API


  1. Fork it

  2. Create your feature branch (git checkout -b my-newfeature)

  3. Commit your changes (git commit -am 'Add some feature')

  4. Push (git push origin my-new-feature)

  5. Create a new Pull Request


Don’t forget about tests, see test directory. The project uses unittest package and tox.

For integration test with Dredd interface the project uses ruby based aruba so to get it running make sure you have Ruby installed and then do:

$ bundle install

After the setup you can run the test easily with:

$ bundle exec cucumber

More details about the integration test can be found in the dredd-hooks-template repo


Copyright (c) 2015 Apiary Czech Republic, s.r.o.


MIT, see LICENSE for details.

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

dredd_hooks-0.2.0.tar.gz (9.8 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