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

• ​lxml for XML export/import: ​http://pypi.python.org/packages/2.7/l/lxml/lxml-2.3.win32-py2.7.exe
• ​Shapely for GIS Features: ​http://pypi.python.org/packages/2.7/S/Shapely/Shapely-1.2.13.win32-py2.7.exe
• ​ReportLab for PDF output
• ​PIL Python Image Library for PDFs: ​http://effbot.org/downloads/PIL-1.1.7.win32-py2.7.exe
• ​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

• ​xlwt for XLS output

• ​numpy required by matplotlib
• ​SciPy required for S3Cube
• ​MatPlotLib for charts (used in the Survey application & for the S3Cube pivottable reports)

• ​setuptools for installing tweepy
• ​tweepy python library to interact with twitter
• ​Pyserial for SMS Features

• ​PyTZ for Timezone awareness
• ​PyWURFL for Browser Capabilities (unused currently)

• ​MySQLDB for accessing MySQL databases: ​http://www.codegood.com/download/10/
• ​Psycopg for accessing PostgreSQL databases:
  • ​PostgreSQL-9.0.4
  • ​PostgreSQL-8.4.4

Install Bzr

We use the ​Bazaar Distributed Version Control System Several downloads are ​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 lp:~mdipierro/web2py/devel web2py

There are occasional issues with the latest Trunk, so you may need to try a slightly older revision.

cd web2py
bzr revno
bzr revert -r <earlier 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!

Install Eclipse

If you want a graphical debugger to set breakpoints & step through code then it is recommended to install Eclipse:

• DeveloperGuidelinesEclipse

Developer Guidelines

Now, see how to put your installation to work:

• DeveloperGuidelines