Installation

Cloning

We’re currently in development mode, so you’re better off cloning the repository.

$ git clone https://github.com/SpectoLabs/hoverpy.git
$ cd hoverpy
$ virtualenv .venv
$ source .venv/bin/activate
$ python setup.py install

This installs hoverpy and its requirements in your .venv folder; make sure to pull often, and run the python setup.py install when you do.

Testing

Please make sure everything is working before proceeding to the next steps.

$ python setup.py test

You should get a series of OKs.

Output:

...
testModify (hoverpy.tests.modify.testModify.TestModify) ... ok
testTemplate (hoverpy.tests.templates.testTemplates.TestTemplates) ... ok
testCapture (hoverpy.tests.testVirtualisation.TestVirt) ... ok
testPlayback (hoverpy.tests.testVirtualisation.TestVirt) ... ok

Running the examples

$ ls examples/*
$ basic       delays      modify      readthedocs tornado     unittesting urllib2eg   urllib3eg

Please note we’ll cover the examples in the usage page. But for the truly impatient, you can try running the most basic example, just to make sure everything’s working at this point.

$ python examples/basic/basic.py

Installing from repo

Please note there isn’t yet much point installing HoverPy since we’re currently still in development mode. This means the code will change often. But if you really want to, then here’s the command:

$ sudo python setup.py install

Installing from PIP

You can also install HoverPy from PIP, however once again you’re better off playing with your repo clone for now. But if you really wish so, then here’s how you can do so:

$ pip install -i https://testpypi.python.org/pypi hoverpy

HoverFly binary

Please note that when you install HoverPy, the HoverFly binaries get downloaded and installed in your home directory, in

${home}/.hoverfly/bin/dist_vX.X.X/${OS}_${ARCH}/hoverfly