Setting Up Eclipse for Python

What is Eclipse?

Eclipse is an integrated development environment (IDE) that provides an array of convenient and powerful code editing and debugging tools. For instance, Eclipse allows you to pause the execution of your code and investigate the values of all assigned variables. Such functionality will speed up your debugging process immensely.

(1) Install Python

Note: the computers in Soda already have python installed. Your computer might too

Download Python here.

(2) Download & Install Eclipse

You can download Eclipse here. The page should automatically detect your operating system. You want to download something called the "Eclipse IDE for java developers" (~80Mb).

Decompressing and opening should yield an Eclipse welcome screen. Close the welcome screen (close tab in upper left) to view the editor. You're now ready to install PyDev.

(3) Install PyDev

Eclipse installs extensions for you from within the application. All you need to provide is the web address of the extension you want to add (in our case, PyDev).

  1. A. From the menu system, select Help >> Software Updates >> Find and Install...
  2. B. Select Search for new features to install
  3. C. Click the "New Remote Site..." button and enter the following web address:
    http://www.fabioz.com/pydev/updates
  4. D. Select the new site by checking its box, and click Finish
  5. E. Click to install PyDev and PyDev extensions. Pydev Optional Extensions are unnecessary.
  6. F. Open the Preferences window within Eclipse and select Pydev >> Interpreter - Python"
  7. G. In the top of the preferences pane, click New... and locate your installation of Python.
  8. H. You can license PyDev Extensions via these instructions (password given in class)

(4) Creating a Python Project

Eclipse organizes all of your code into projects. You'll want to create a new Python project for all of your CS 188 code.

(5) Running Python from within Eclipse

Now you're ready to create a new python file and run it from within Eclipse. Right-click (control-click on Macs) on your project and create a new blank file. Make sure your file ends in .py, and Eclipse will recognize it as Python code.

Type in some Python code (for instance: print 2+2), then right-click on the Python file you've created and select Run As >> Python run . You should see the output of your Python code in the console at the bottom of the Eclipse window.

Now that you've run the code once, you can press the green Run arrow at the top of the Eclipse window to run it again.

(6) The PyDev perspective

Your installation of Pydev also changes the contextual menus and layout of the Eclipse GUI to better suit Python development. To enable these enhancements, select Window >> Open Perspective >> Other... and then select the Pydev perspective. The changes you'll find are subtle; for instance you can create a new Python module by right-clicking on your project (instead of a generic file).

(7) Debugging

You can add breakpoints to your code by double clicking in the gray bar to the left of the editing pane within the Eclipse window (a blue dot will appear). Then, to pause the code at that location and inspect the value of variables, select Debug As >> Python Run or click the bug at the top of the screen. Eclipse should automatically change to a debugging perspective, which allows you to inspect variables in the upper right pane of the window.