Lab this week is optional in that we will not be taking roll. However, this is an opportunity to come to ensure that you have Python, PyCharm, and PyGame installed and working properly on your laptops. If you do not come to lab, we will assume you have taken care of this yourself and you are ready to go when we start coding in lecture next week. So, if you have any doubts, come on down to lab, meet some of the TAs, and make sure you’re laptop is setup and ready to go!

1 Installing

1.1 on Windows

  1. Install Python 3.6.4:

    1. Download the executable x86-64 installer from python.org.

    2. Run the installer.

    3. Choose the “Custom Installation” option.

    4. If asked, check “Add Python to environment variables” and “Install for all users”; leave all other options at their default values.

  2. Install PyCharm Community Edition 2017.3.2:

    1. Download the executable installer from jetbrains.com.

    2. Run the installer.

    3. If asked, check “Create associations” - “.py”; leave all other options at their default values.

  3. Set up PyCharm and PyGame; see the cross-platform information below.

1.2 on Mac

  1. Install Python 3.6.4:

    1. Download the installer from python.org.

    2. Run the installer.

    3. Choose the “Custom Installation” option.

    4. If asked, check “Add Python to environment variables” and “Install for all users”; leave all other options at their default values.

  2. Install PyCharm Community Edition 2017.3.2:

    1. Download the dmg disk image from jetbrains.com.

    2. Drag the icon to the Applications folder.

  3. Install prerequisites for PyGame

    1. Download and install XQuartz - https://dl.bintray.com/xquartz/downloads/XQuartz-2.7.11.dmg.

    2. Open a Terminal window (/ApplicationsUtilitiesTerminal). In the terminal window, paste the following commands in one at a time and run them individually:

      1. xcode-select --install
      2. ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
      3. alias brew=/usr/local/bin/brew
      4. brew install sdl sdl_image sdl_ttf smpeg portmidi libogg libvorbis
      5. brew install sdl_mixer --with-libvorbis
    3. In the Finder, open /ApplicationsPython 3.6 and double-click on the icon for Install Certificates.command

  4. Set up PyCharm and PyGame; see the cross-platform information below.

1.3 On Other Systems

If you are using a system other than Windows or Mac (Linux, FreeBSD, Haiku, etc.), first off, good for you! In general, installing Python, PyGame, and PyCharm is pretty straightforward on these systems (download the Linux version of PyCharm even if you are using a BSD or the like), but if you have trouble post what system you are using on Piazza and we’ll help get you set up.

2 Set up PyCharm and PyGame

There’s a fair bit of set-up, but you should only have to do this once.

  1. Run PyCharm

  2. Accept the default options in the various screens that pop up asking you to set up various aspects of PyCharm. These should only appear the first time you run PyCharm.

  3. When you reach the welcome screen,

    PyCharm welcome screen
    PyCharm welcome screen

    set up PyGame and how Pycharm interacts with Python doing the following:

    1. In the “configuration” menu (gear icon), select “Settings”.

    2. Go to the “Project Interpreter” option on the left of the screen.

      Project interpreter options
      Project interpreter options
    3. If the “Project Interpreter” drop-down on the top of the screen has a “Python 3” of some kind, select it and skip the indented steps below; otherwise

      1. Click the gear icon beside the drop-down (top-right corner of the window) and select “Add Local…” from the menu
      2. In the pop-up window, on the left chose “System Interpreter”
      3. In the drop-down, pick python3.6 if it is present; if not, click the “…” button and find where you installed Python.

        Project interpreter selection
        Project interpreter selection
      4. Click OK

    4. Click the green + either to the top right or bottom left of the list of packages

      Project interpreter options
      Project interpreter options
    5. In the pop-up window, type pygame in the search bar, select “Pygame” in the left-hand list, and click “Install Package”

      PyGame installation
      PyGame installation
    6. Wait until an “installation successful” message appears

    7. Click “Apply” and “OK” in each window until back in the welcome screen

      Welcome screen
      Welcome screen
  4. Click “Create New Project”

  5. In the new project window

    1. Set the Location to some place you can find in your OS’s file browser; suggested:

      • Windows: C:\Users\your-user-name-on-your-computer\Desktop\cs1110
      • OS X: /Users/your-user-name-on-your-computer/Desktop/cs1110
    2. Expand the “Project Interpreter” with the little triangle and pick the “Existing Interpreter” option, with Python 3.6 as the interpreter.

      New project setup window
      New project setup window
    3. Click the Create button

  6. Create a new Python file by right-clicking (control-click if you only have one button) on the cs1110 folder in the Project pane on the left side of the window, then pick New → Python File

    New file menu
    New file menu
  7. Type setup_test.py in the new file pop-up

    New file pop-up
    New file pop-up
  8. In the editor window, type or paste the following:

    import pygame
    import urllib.request
    
    pygame.init()
    urllib.request.urlopen('https://cs1110.cs.virginia.edu')
    
    print('Hello, world!')
  9. Right-click in white space in the editor window (not on any text) and select “Run setup_test” from the drop-down menu.

    Run menu
    Run menu
  10. If you see “Hello, world!” in the second line of the bottom of the window, everything is set up correctly!

    Desired run results
    Desired run results

    If you see something else, or if something went wrong along the way, ask a TA for help.