= Installation Guidelines: Windows - Developer (Manual) =

If you are a Developer running Windows and wishing to install Python & all dependent libraries manually then this is the right page for you.

== Install Python ==
2.7 is currently recommended. (2.6 works for all core functionality, but doesn't allow you to use the S3Cube pivot table functions)

NB 32-bit Python should be used even on 64-bit Windows:

 * http://python.org/ftp/python/2.7.2/python-2.7.2.msi

== Install Python Libraries ==
Windows users should generally use Windows Installers, where available

==== Mandatory ====
 * [http://codespeak.net/lxml lxml] for XML export/import: http://pypi.python.org/packages/2.7/l/lxml/lxml-2.3.win32-py2.7.exe
 * [http://pypi.python.org/pypi/Shapely/ Shapely] for GIS Features: http://pypi.python.org/packages/2.7/S/Shapely/Shapely-1.2.13.win32-py2.7.exe
 * [http://www.reportlab.com/software/opensource/rl-toolkit/download/ ReportLab] for PDF output
 * [http://www.pythonware.com/products/pil/ PIL] Python Image Library for PDFs: http://effbot.org/downloads/PIL-1.1.7.win32-py2.7.exe
 * [http://labix.org/python-dateutil dateutil]: http://labix.org/download/python-dateutil/python-dateutil-1.5.tar.gz
  * No Windows installer, so install by unzipping, opening a command line inside the folder & {{{python setup.py install}}}

==== Optional ====
 * [http://pypi.python.org/pypi/xlwt xlwt] for XLS output

 * [http://numpy.scipy.org  numpy] required by matplotlib
 * [http://www.scipy.org/Installing_SciPy SciPy] required for S3Cube
 * [http://matplotlib.sourceforge.net/users/installing.html MatPlotLib] for charts (used in the Survey application & for the S3Cube pivottable reports)

 * [http://pypi.python.org/pypi/setuptools/ setuptools] for installing tweepy
 * [http://pypi.python.org/pypi/tweepy/ tweepy] python library to interact with twitter
 * [http://sourceforge.net/projects/pyserial/files/ Pyserial] for SMS Features 

 * [http://pypi.python.org/pypi/pytz/ PyTZ] for Timezone awareness
 * [http://pypi.python.org/pypi/pywurfl/ PyWURFL] for Browser Capabilities (unused currently)

 * [http://pypi.python.org/pypi/MySQL-python/ MySQLDB for accessing MySQL databases]: http://www.codegood.com/download/10/
 * [http://initd.org/psycopg/ Psycopg for accessing PostgreSQL databases]:
  * [http://www.stickpeople.com/projects/python/win-psycopg/psycopg2-2.4.2.win32-py2.7-pg9.0.4-release.exe PostgreSQL-9.0.4]
  * [http://www.stickpeople.com/projects/python/win-psycopg/psycopg2-2.2.1.win32-py2.7-pg8.4.4-release.exe PostgreSQL-8.4.4]

== Install Bzr ==
We use the [http://wiki.bazaar.canonical.com/ Bazaar] Distributed Version Control System
Several downloads are [http://wiki.bazaar.canonical.com/WindowsDownloads available], but we recommend using the Python Installer:
 * http://launchpad.net/bzr/2.4/2.4.1/+download/bzr-2.4.1-1.win32-py2.7.exe

== Install Web2Py ==
As a Developer, it is best to run the Trunk version of Web2Py, so that you can fine-tune the version that you have installed & get involved with the Web2Py developer community.
{{{
bzr branch 
}}}

There are occasional issues with the latest Trunk, so you may need to try a slightly older revision.
{{{
cd web2py
bzr revert -r <revision>
}}}

== Install Sahana ==
As a Developer, you should generally run the Trunk version of Web2Py, so that you can submit patches against the latest code:
{{{
cd web2py/applications
bzr branch lp:sahana-eden eden
}}}

NB Note the fact that we ensure that the name of the web2py application has no hyphen in, as otherwise it cannot run!