1This file describes how to setup Eclipse and then the Python Charts project
2
3Setup Eclipse
4-------------
5These instructions were tested on Linux, but are very similar for Windows and
6Mac.
71. Ensure you have Python 2.x installed
82. Download and install Google App Engine SDK for Python from 
9   http://code.google.com/appengine/downloads.html
103. Note which location you put App Engine in, as this will be needed later on.
114. Download Eclipse from http://www.eclipse.org. Any distribution will probably
12   do, but if you're going to do mainly web development, you might pick Eclipse
13   IDE for JavaScript Web Developers
145. Install the PyDev plugin using the Eclipse update site mentioned at 
15   http://pydev.org/download.html
166. Install the Google Plugin for Eclipse: http://code.google.com/eclipse/
17
18Setup the project
19-----------------
20Generic instructions are available at
21http://code.google.com/appengine/docs/python/gettingstarted/ but the following
22should be enough:
231. Launch Eclipse and create a workspace
242. Create a new PyDev Project
253. In the PyDev Project wizard, uncheck the "Use Default" checkbox for Project
26   contents and browse to your tools/python_charts directory.
274. Enter a project name. We'll assume PythonCharts in the examples below.
285. In the radio button of the lower part of the window, select
29   "Add project directory to the PYTHONPATH"
306. Click Finish
317. Select the Run > Run Configuration… menu item
328. Create a new "Python Run" configuration
339. Select your Python Charts project as project
3410. As Main Module, enter the path to your dev_appserver.py, which is a part
35    of your App Engine installation,
36    e.g. /usr/local/google_appengine/dev_appserver.py
3711. At the Arguments tab, enter the location of your project root.
38    Using Eclipse variables if your project name is PythonCharts:
39    ${workspace_loc:PythonCharts}
4012. Launch the development app server by clicking the Run button.
4113. Launch a browser and go to http://localhost:8080
42