Boston Python Workshop/Friday handout/Ubuntu Debian Fedora

From OpenHatch wiki
Jump to navigation Jump to search

Install git

Install it:

sudo apt-get install git
# On Fedora:
sudo yum install git

Test it:

    git --version

It should respond with something like "git version".

Tell git who you are

  • Open up a new Terminal window.
  • git config --global "Your Actual Name"
  • git config --global "Your Actual Email"

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


  • Open a Terminal and type:
sudo apt-get install python-django
# Fedora users
sudo yum install Django

Make sure Django is working

  • Open a Python prompt, and type this in:
import django

If you get an error, get help!

  • Note: It's important for this workshop that you use Django 1.2.x. If you have a different version, talk to a volunteer. (Volunteers: Create a virtualenv for the person, then use "pip" to install django within the virtualenv.)

Create an SSH public key

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

  • Open up a new Terminal window.
  • ssh-keygen -C "Your Actual Email" -t rsa (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).
  • Output of ssh-keygen command
  • Your brand-new public key is now stored at ~/.ssh/

Install a reasonable text editor

The Windows and Mac folks will be using KomodoEdit during the workshop. It's actually kind of nice.

If you have our own favorite editor, by all means using it during the workshop.

Verify you can create a new Django app

  • Create a folder on the desktop called django_projects
  • Open a new Terminal window and type the following:
   cd ~/Desktop/django_projects
   django-admin startproject myproject
  • Both commands should provide no output.
  • Once that's finished, type the following in the Terminal window:
   cd myproject
   python 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 python runserver, 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 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're at a workshop and you need this file, please ask a volunteer. We may have it on a thumb drive and it'll save you a bunch of download time.

If you don't have Firefox yet

Go to 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 web app install instructions