Editing Django Development on Mac (section)

== Software ==

=== Python ===

Use version 3.x. As of 2015, version 2.7 comes pre-installed on Mac. It's necessary to manually install Python 3.

=== Django ===

<div class="alert-warning">If multiple versions of Python are installed on the system, it's necessary to create a virtualenv to install Python packages such as Django. See [[Python Virtual Environments]]</div>

* [https://docs.djangoproject.com/en/1.8/topics/install/ How To Install Django] - Django Documentation (version 1.8)
* Mac: `sudo pip install Django`

''N.B. The iMac that was purchased in 2015 came with python 2.x installed. Python 3 was manually installed.''

'' In this situation typing `python` on the command line invokes python 2.x.''
 
''To invoke python 3.x it's necessary to use `python3`. Similarly, `pip` will install for python 2.x, while `pip3` installs for python 3.x.''

=== Database ===

Recommended database is [http://www.postgresql.org/download/ PostgreSQL]. 

The PostgreSQL server is running on littledamienii. It's not necessary to have a local database server. 

However, python does require the `psycopg2` package in order to connect to the database.

<div class="alert-warning">If multiple versions of Python are installed on the system, it's necessary to create a virtualenv to install Python packages such as `psycopg2`. See [[Python Virtual Environments]]</div>

* Download the PostgreSQL installer & run it. 
* Install '''pip''': `sudo easy_install pip`
* Django projects that use PostgreSQL databases depend on the `psycopg2` package. 
** This ''should'' simply be a matter of `sudo pip install psycopg2`, but that install depends on `pg_config`, which appears to be part of the "Homebrew" install of PostgreSQL. 
** Don't install PostgreSQL using the EnterprisesDB installer. 
** Install with "Homebrew": `brew install postgresql` <ref>[http://www.postgresql.org/download/macosx/ PostgreSQL Mac OS X packages] - PostgreSQL.org</ref>
** With the Homebrew installation of PostgreSQL, `pip` should be able to install `psycopg2`.