:author:    D Haynes
:contact:   tundish@thuswise.org

..  Titling
    ##++::==~~--''``

Installing hwit-examples
====================

Skel is not really designed to be installed. It simply provides
a template for new packages in the HWIT_ namespace.

It needs Python_ 2.7 to run.

User-local method
~~~~~~~~~~~~~~~~~

This is the simplest way of installing, and requires no special dependencies.

Installation
------------

Unpack the distribution and ``cd`` into its top-level directory. Then::

    python setup.py develop --user

Removal
-------

In the top-level directory, execute the following::

    python setup.py develop --user --uninstall

Virtualenv method
~~~~~~~~~~~~~~~~~

This is the best way to deploy to a host where configuration management is a key
concern. You should install virtualenv_ first.

Installation
------------

Activate the virtual environment. Then::

    pip install hwit-examples-x.xx.tar.gz

Removal
-------

From the activated environment, execute the following::

    pip uninstall hwit-examples

..  _HWIT: http://hwit.org
..  _Python: http://python.org
..  _virtualenv: http://www.virtualenv.org/en/latest/index.html
