| 1 | == Development (Mac OS X Tiger) == |
| 2 | |
| 3 | These instructions are for Django 0.91. I hope to update this with most new releases. |
| 4 | |
| 5 | I prefer the latest tarballs for general development. If I ever start to get really into the software I get the CVS or SVN. |
| 6 | |
| 7 | **Before beginning**, install XCode. XCode contains make, gcc, and other things you'll be needing when compiling from source. |
| 8 | |
| 9 | === Installing Python === |
| 10 | |
| 11 | 1. Download and unpack latest stable python tarball |
| 12 | 1. {{{./configure --prefix=/usr/local; make; make install}}} |
| 13 | 1. Add {{{export PATH=/usr/local/bin:$PATH}}} and {{{export MANPATH=/usr/local/man:$MANPATH}}} to {{{~/.profile}}} |
| 14 | 1. Open a new terminal session |
| 15 | 1. Type {{{python}}} and check that it is the version you just installed |
| 16 | |
| 17 | === Installing \PostgreSQL === |
| 18 | |
| 19 | 1. Create a new user, _postgres_ in the Accounts Pane of the Mac OS X System Preferences |
| 20 | 1. Download and unpack latest stable \PostgreSQL tarball |
| 21 | 1. `./configure --prefix=/usr/local/pgsql; make; sudo make install` |
| 22 | 1. Add `export PATH=/usr/local/pgsql/bin:$PATH` and `export MANPATH=/usr/local/pgsql/man:$MANPATH` to `~/.profile` |
| 23 | 1. Add `export PGDATA=/usr/local/pgsql/data` to `~/.profile` **NOTE: If this isn't set, _postgres_ will complain about a missing conf file.** |
| 24 | 1. Open a new terminal session |
| 25 | 1. Type `psql -V` and check that it is the version you just installed |
| 26 | 1. Create a data directory: `sudo mkdir $PGDATA` |
| 27 | 1. Change ownership to postgres: `sudo chown postgres:postgres $PGDATA` |
| 28 | 1. Create the initial data area: `sudo -u postgres initdb -D $PGDATA` **NOTE: `sudo` means _substitute user and do_, and in this case with the initial `-u` parameter, we are telling sudo to run the command as _postgres_ rather than _root_.** |
| 29 | 1. To run the database (will not be automatically started on boot): `sudo -u postgres pg_ctl start` |
| 30 | 1. Open a new window, and type `sudo -u postgres createdb test`. If it says `CREATE DATABASE`, it's working. :) |
| 31 | |
| 32 | === Installing psycopg (\PostgreSQL Bindings) === |
| 33 | |
| 34 | At the time of this writing, the only stable version of _psycopg_ is _psycopg1_. The development version _psycopg2_ is not supported by Django. |
| 35 | |
| 36 | 1. Download the latest stable tartball of _[mxDateTime](http://www.egenix.com/files/python/mxDateTime.html)_ |
| 37 | 1. Unpack the tarball and go into the directory |
| 38 | 1. `python setup.py build` |
| 39 | 1. `sudo python setup.py install` |
| 40 | 1. `Download the latest stable tarball of psycopg1` |
| 41 | 1. `export MACOSX_DEPLOYMENT_TARGET=10.4` |
| 42 | 1. `export CPPFLAGS="-I/usr/local/lib/python2.4/site-packages/mx/DateTime/mxDateTime"` |
| 43 | 1. `./configure --with-postgres-libraries=$(pg_config --libdir) --with-postgres-includes=$(pg_config --includedir)` |
| 44 | 1. `make` |
| 45 | 1. `sudo make install` |
| 46 | 1. Run `python`, type `import psycopg` into the interactive read-eval-print loop (REPL), and `quit` the REPL. |