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

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

Installing hwit-core
====================

``hwit-core`` is part of HWIT_. It contains the classes and functions
used by the other packages; by itself it requires Python_ 2.5 or later.

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 install --user

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-core-x.xx-rxxxxx.tar.gz

Removal
-------

From the activated environment, execute the following::

    pip uninstall hwit-core

Binary installation
~~~~~~~~~~~~~~~~~~~

MS Windows
----------

*   Download and install the MS Visual `C++ runtime`_ . 
*   Go to the `HWIT download`_ area and get the latest installer for
    Windows. It will have a file name like ``hwit-core-w32-0.0x.exe``.
    Double-click to install it.

..  _HWIT: http://hwit.org
..  _Python: http://python.org
..  _virtualenv: http://www.virtualenv.org/en/latest/index.html
..  _HWIT download: http://knowledgeforge.net/hwit/index.html
..  _C++ runtime: http://www.microsoft.com/downloads/details.aspx?familyid=9B2DA534-3E03-4391-8A4D-074B9F2BC1BF&displaylang=en
