= Installation Guidelines: Linux - Developer =

As a Developer running Linux, you have 2 choices:
 * Install Python and all libraries manually: InstallationGuidelines/Linux/Developer/Manual [[br]]
   //This option takes longer, but allows getting the latest versions of tools and packages.//

 * Install [http://virtualbox.org VirtualBox] & run a [InstallationGuidelinesVirtualMachine Virtual Machine] which includes a pre-configured Eclipse on an Ubuntu OS [[br]]
   //This is appropriate for getting started quickly, as browser and IDE setup has been done. The virtual machine itself will need some setup. Installing directly on your machine may be a better choice if you are interested in doing long-term Eden development.//

== 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)

== Install Python Libraries ==
Linux users should generally use Operating System Packages, where available.
Examples are shown for Debian-based systems

==== Mandatory ====
 * [http://codespeak.net/lxml lxml] for XML export/import: {{{apt-get install python-lxml}}}
 * [http://pypi.python.org/pypi/Shapely/ Shapely] for GIS Features: {{{apt-get install python-shapely}}}
 * [http://www.reportlab.com/software/opensource/rl-toolkit/download/ ReportLab] for PDF output: {{{apt-get install python-reportlab}}}
 * [http://www.pythonware.com/products/pil/ PIL] Python Image Library for PDFs: {{{apt-get install python-imaging}}}
 * [http://labix.org/python-dateutil dateutil]: {{{apt-get install python-dateutil}}}

==== Optional ====
 * [http://pypi.python.org/pypi/xlwt xlwt] for XLS output: {{{apt-get install python-xlwt}}}

 * [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]: {{{apt-get install python-mysqldb}}}
 * [http://initd.org/psycopg/ Psycopg for accessing PostgreSQL databases]: {{{apt-get install python-psycopg2}}}

== Install Bzr ==
We use the [http://wiki.bazaar.canonical.com/ Bazaar] Distributed Version Control System
 * {{{apt-get install bzr}}}

== Next ==
Install Web2Py & Sahana:
 * InstallationGuidelines/Developer/PostPython