================================
Hindsight Software Python Client
================================

This client provides access to Behave for Jira in a Python environment. It uses a HTTP GET call to
download a compressed stream containing the feature files for the specified project, and then unzips
the features into the specified directory.

Installation
============

If using pip, simply::

    pip install hindsight

If installing manually, grab the tarball below and extract to a temporary directory. Then run::

    python setup.py install

from inside the temporary directory

Usage
=====

Within a script::

    #!/usr/bin/env python

    from hindsight.behave import JiraConnector

    jc = JiraConnector()
    jc.fetch(
        host='http://localhost:2990/jira',
        username='behaver',
        password='atdd4me',
        key='PROJ',
        dir='features',
        manual=True
    )

This takes mandatory arguments host and key, and the rest are optional.

Or the same request from the command line (if you installed via pip)::

    behave-cli http://localhost:2990/jira PROJ -u behaver -p atdd4me -d features -m

Taking the form::

    behave-cli HOST KEY [-u USERNAME] [-p PASSWORD] [-d DIR] [-m]


More info
=========

Please see the guide at http://hindsighttesting.com/docs