= Installation Guidelines: Mac - Developer - Manual =

== Install Apple developer tools ==
You will need [http://developer.apple.com/technologies/tools/ Apple's Xcode Developer 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).

// Caution: The Xcode download is over 3GB. //

== Install GIS tools ==
For some GIS features of Eden (e.g. if you would rather use PostgreSQL with PostGIS instead of MySQL) install the [http://trac.osgeo.org/gdal/wiki/DownloadingGdalBinaries GDAL framework]

== Install Python ==
[http://python.org/ftp/python/2.7.2/python-2.7.2-macosx10.6.dmg Mac installer for Python]

== Install Python packages ==
You can use [http://peak.telecommunity.com/DevCenter/EasyInstall easy_install] or [http://www.pip-installer.org/ 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
}}}

If you want to use PostgreSQL - PostGIS (for which you will need GDAL, above):
 * Install the one clickInstaller sponsored by EnterpriseDB PostgreSQL and select also installation of PostGIS.
 * Following [http://schwuk.com/articles/2009/09/10/psycopg2-on-os-x this post], install the Python database driver (substitute your path for PostgreSQL):
{{{
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 Web2py will not be able to find the PostgreSQL driver.)

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

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