= Installation Guidelines: Mac - Developer - Manual =

== Install Python ==

1. FIRST:
* You WILL NEED Apple's Xcode Developer Tools (http://developer.apple.com/technologies/tools/) (version 4.1 or later for Lion, 3.2 or later for Snow Leopard, or 3.1 or later for Leopard), found at the Apple Developer Connection site, on your Mac OS X installation CDs/DVD, or in the Mac App Store. Using the latest available version that will run on your OS is highly recommended. Ensure that the optional components for command line development are installed ("UNIX Development", plus "System Tools" in newer versions, or "Command Line Support" in older ones).
* If you need some advanced GIS features of Eden. Before you proceed install the GDAL framework
 * http://trac.osgeo.org/gdal/wiki/DownloadingGdalBinaries

2. Python: http://python.org/ftp/python/2.7.2/python-2.7.2-macosx10.6.dmg

3. You also need to install some modules of python 
(You may want to consider using Pip for these installations)
{{{
STATIC_DEPS=true sudo easy_install lxml
sudo easy_install shapely
sudo easy_install reportlab
sudo easy_install xlwt
sudo easy_install pyserial
sudo easy_install tweepy
}}}

4. In case you want to use PostgreSQL - PostGIS (I assume you already installed the spatial modules before)
 Install the one clickInstaller sponsored by EnterpriseDB PostgreSQL and select also installation of postgis.
 Then based on this article http://schwuk.com/articles/2009/09/10/psycopg2-on-os-x install the python database driver 
{{{
sudo easy_install pip
PATH=$PATH:/Library/PostgreSQL/8.4/bin/ sudo pip install psycopg2
defaults write com.apple.versioner.python Prefer-32-Bit -bool yes
}}}
 without the last you will not be able to see available the PostgreSQL driver when web2py launch

=== Trouble? ===
 * {{{lxml}}} can give trouble on OS X.  Try:
  * {{{STATIC_DEPS=true sudo easy_install lxml}}} (adapted from [http://blog.ianbicking.org/2008/12/10/lxml-an-underappreciated-web-scraping-library/ this blog post])
  * remove other {{{libxml2}}} versions, such as may have been installed by {{{fink}}} or !MacPorts - ONLY works in unmodified python setup. In case you have modified your python you must link some how the python directory with /frameworks/python otherwise lxml will not being found(not tested)
 * Mac OS X: Xcode to compile some Python libraries:  http://developer.apple.com/technologies/tools/xcode.html

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