Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)



Configuring Eclipse on Windows to Use With Google App Engine

Warning! This article discusses Eclipse 3.4 and has not been updated. These instructions are not valid for later versions of Eclipse. For more recent information about using Eclipse with Google Apps and App Engine, see Using the Google Plugin for Eclipse .

Joscha Feth
June 2008

This article was written and submitted by an external developer. The Google App Engine team thanks Joscha Feth for his time and expertise.

Introduction

As a fan of Eclipse and being new to Python development, I searched for an Eclipse Python extension and finally found PyDev sourceforge project . I know this is basic stuff, but it took me several minutes to find out how to get code completion working with Google App Engine.

So here is a small how-to for getting App Engine with Eclipse and PyDev up and running.

Downloading the components

Before you get started, you will need to set up your environment properly. To do this, you will need to download and configure the following components on your machine:

Installing PyDev on Eclipse

Once you have the above components, you can set up the PyDev Eclipse extension, which is customized for Python developers.

  1. Open Eclipse and go to Help -> Software Updates -> Find and Install .
  2. Locate and Install PyDev:
    • Choose Search for new features to install and click on Next .
    • Click on New remote site :
    • Select the PyDev update site you just added:
    • Click on Finish
    • After the update site has been searched, choose to install the PyDev for Eclipse :
    • Click on Next .
    • Accept the agreement.
    • Click on Finish .
    • Click on Install All .
    • Choose Yes to restart Eclipse.
  3. After Eclipse restarts:
    • Choose Windows -> Preferences to bring up the preferences dialog.
    • Change to the PyDev -> Interpreter - Python section to configure Python.
    • Click on New which is located just right of the "Python interpreters" field to add an interpreter:
    • Search for the "python.exe" executable (normally in C:\Python25).
    • After you select the executable, PyDev will search for libraries, and the following screen appears:
      • Normally, the pre-selection done by PyDev is fine, so click OK to accept the system pythonpath entries.
      • In the Preferences window, click OK to confirm your changes.

Starting Your First Project

After you have PyDev installed on Eclipse, you are ready to start developing your application!

  1. Let's create our first Python project:
  2. For a quick start, you can work on the Getting Started tutorial available. Use the "src" Folder as base folder for your project:
  3. The last thing we need to do now is to add a user-defined starter for our Google App Engine development server:

From now on, you can run your project by selecting your configuration from the "Run" dropdown and access your app on http://localhost:9999/ . If an error occurs, you can see it in the console view of Eclipse and click on it to jump to the error location within your scripts:

When you are ready to upload your app, simply upload the application's 'src' folder using appcfg.py.

Authentication required

You need to be signed in with Google+ to do that.

Signing you in...

Google Developers needs your permission to do that.