Boston Python Workshop/Friday handout/OS X 10.6 or 10.5: Difference between revisions

== Install git ==

It's an insult in British English, but git is also an awesome version control tool. Here's how you install it:

Go to [http://code.google.com/p/git-osx-installer/downloads/list?can=3&q=&sort=-uploaded&colspec=Filename+Summary+Uploaded+Size+DownloadCount this page on google code] and download the latest file ending in "-x86_64-leopard.dmg" (1.7.2.3 as of this writing). Once it's downloaded, double click to open. You'll see something like this:

<center>

[[File:Git-screenshot.png]]

</center>

Double-click the .pkg file to install. Once that's done, close all your open Terminal windows, and open a new one. Cut and paste the following into the new Terminal window:

<pre>

git --version

</pre>

It should respond with something like "git version 1.7.2.3".

==== Tell git who you are ====

* Open up a new Terminal window.

* <code>git config --global user.name "''Your Actual Name''"</code>

* <code>git config --global user.email "''Your Actual Email''"</code>

If this doesn't produce an error, congratulations! You have a successful install of git and you can move on to the next section.

Test it:

git config --global user.name

git config --global user.email

== Download and install Django ==

* Open a Terminal and type:

cd /tmp/

curl -L http://www.djangoproject.com/download/1.2.5/tarball/ -o Django-1.2.5.tar.gz

tar zxvf Django-1.2.5.tar.gz

cd Django-1.2.5

sudo python setup.py install

== Make sure Django is working ==

* Open a Python prompt, and type this in:

import django

If you get an error, get help! Otherwise, you're done.

== Create an SSH public key ==

You'll need one of these to push your work to Github.

* Open up a new Terminal window.

* <code>ssh-keygen -C ''Your Actual Email'' -t rsa</code> (email should match git config setting)

* Hit enter to accept default location for ssh key.

* Hit enter to accept blank passphrase (if computer is shared with other people, as in a work laptop, you should create a passphrase). Hit enter again to accept blank passphrase (or enter passphrase again).

* Your brand-new public key is now stored at <code>~/.ssh/id_rsa.pub</code>.

== Install the KomodoEdit text editor ==

We'll be using the KomodoEdit text editor during the workshop, though you are free to use a different editor if you prefer. It must be a plain-text editor, such as vi or Textmate. Microsoft Word and other word processing programs won't work. If in doubt, use KomodoEdit.

'''Installation steps:'''

* Download the [http://downloads.activestate.com/Komodo/releases/5.2.4/Komodo-Edit-5.2.4-4343-macosx-x86.dmg KomodoEdit installer].

* Double-click the file once it's downloaded.

* It will open an installer with a KomodoEdit icon and a picture of your Applications folder. Something like this:

[[File:Komodo-Edit-5.png]]

* Drag KomodoEdit into your Applications folder.

* Unmount the installer disk image by dragging it from your desktop to the trash.

== Verify you can create a new Django app ==

* Create a folder on the desktop called <code>django_projects</code>

* Open a new Terminal window and type the following:

cd ~/Desktop/django_projects

django-admin.py startproject myproject

* Both commands should provide no output.

* Once that's finished, type the following in the Terminal window:

cd myproject

python manage.py runserver

* The first command should produce no output. The second command will put out a bunch of output, then just sit there until you cancel it (2 steps from now).

* In your browser, go to http://localhost:8000/

* Back in the Terminal window where you ran <code>python manage.py runserver</code>, type control-c to kill the server.

== Install SQLite Firefox add-on ==

SQLite Explorer is a piece of software that lets you browse SQLite databases. It's written as a Firefox add-on.

Even if you already have a browser like Chrome, you'll need the latest version of the Firefox web browser. (You may need to upgrade even if you already have Firefox installed.)

====If you already have Firefox====

Open it, and then go to the Firefox menu (top left of the screen). Select "About Mozilla Firefox."

You'll get a window, like the one below, that shows you what version of Firefox you have. Write down that number!

Now go to [http://www.mozilla.com/en-US/firefox/firefox.html the Firefox homepage] and see what the current version of Firefox is. If it's the same major version (such as 3.6 - you can ignore the third part of the number) then you're good. You don't need to upgrade.

If it's a different major version, then you need to upgrade. Download it from the Firefox homepage and double-click to install.

==== If you don't have Firefox yet ====

Go to [http://www.mozilla.com/en-US/firefox/firefox.html the Firefox homepage] and click the big download button. Once you have the file, double click and follow the instructions to install.

==== Install the SQLite Manager Firefox Plugin ====

Open Firefox, and then go to the Tools menu and select "Add-ons." Click the "Get Add-ons" button at the top. Enter "SQLite" where it says "Search all Add-ons." The first thing that comes up should be SQLite Manager. Click "Add to Firefox" and then follow the instructions to install it.

If you have trouble installing, double-check that your Firefox version is at least 3.6.

'''Now go back to the [https://openhatch.org/wiki/Setting_up_the_web_app#Section_3:_Configuring_your_accounts_on_the_web web app install instructions]'''