Django Subversion Installation on Mac OS X

I recently installed Django on my MacBook Pro and thought I would share my experience. This is what worked for me. I'll keep it brief, you just want to get developing right?

What you will need:

Nothing! Python and Subversion are installed by default.

Start the Terminal session:

This will take you to your user directory (not the root).

You will see something like this.

CPE-58-168-138-49:~ Dien$

Checkout/Grab the Framework Code:

Enter this at the prompt (you may need to prefix with 'sudo' if you get permission problems). I created a directory at the user level named 'Frameworks' to house it.

svn co http://code.djangoproject.com/svn/django/trunk/ /Users/[user]/Frameworks/svn_django/

Note: [User] being the current logged in user.

Linking it up:

This lets Python know where Django is.

ln -s /Users/[user]/Frameworks/svn_django/django /Library/Frameworks/Python.framework/Versions/2.5/lib/python2.5/site-packages/django

Note: Depending on what version of Python is installed you will need to substitute the version no. e.g. '2.5'. You can see the version no. by simply entering 'Python -V' at the prompt.

Test it:

Start the Python interpreter, just type in 'Python' from the terminal.

You should see something like this.

Python 2.5 (r25:51918, Sep 19 2006, 08:49:13)
[GCC 4.0.1 (Apple Computer, Inc. build 5341)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>>

Enter 'import django' if you get no errors then Django has been installed correctly.

Linking django-admin.py:

ln -s /Users/[user]/Frameworks/svn_django/django/bin/django-admin.py /usr/local/bin

This allows you to run the 'django-admin.py' from anywhere instead of qualifying it each time.

Testing django-admin.py:

You know it works when you enter it from the command prompt and get no errors.

CPE-58-168-138-49:~ Dien$ django-admin.py
Type 'django-admin.py help' for usage.

This just means that you need to specify a switch for it e.g. 'startproject [project name]'.

All you need to do now is follow the tutorials located in found in the Django Documentation.