[[TOC]]
= Eclipse =
Eclipse is a full IDE supporting Debugging & Code Completion.

!PyDev is an Eclipse module which supports Python.

== Installation ==
 1. Install [http://java.sun.com/javase/downloads/widget/jdk6.jsp Java JDK]
 2. Install [http://www.eclipse.org/downloads/packages/eclipse-classic-360/heliosr Eclipse 3.6]
 3. Install !PyDev through Eclipse: 
  i. Help menu > Install New Software
  i. Work with: http://pydev.org/updates
  i. Add, OK
  i. tick !PyDev (can exclude the optional !PyDev Mylyn Integration), Next, Next, Accept, Finish
  i. tick to trust certificate, Restart now
 4. Set up the Python Interpreter:
  i. Window > Preferences > !PyDev > Interpreter - Python
  i. New, Browse to python26/python.exe, OK, OK
 5. Add a new !PyDev Project:
  i. File > New > Project > !PyDev Project > Next
  i. untick Use Default
  i. Browse to the web2py directory
  i. Give the project a name: eden, Next
  i. untick 'Create default 'src' folder and add it to the pythonpath'
 6. Debug Configuration: Run > Debug Configurations > Python Run 
  i. Name: Sahana Eden
  i. Project: Browse to eden
  i. Main Module: Browse to web2py.py
  i. Arguments tab: Program Arguments: -a password
  i. Apply, Debug
  i. unblock in Windows Firewall

Other Installation Guides (should not be required):
 * http://kollerie.wordpress.com/2009/04/07/setting-up-your-ide-for-web2py-development/
 * (Simpler Instructions) http://allisterx.blogspot.com/2009/06/using-web2py-framework-on-eclipse.html

=== Bzr integration (optional) ===
 * http://wiki.bazaar.canonical.com/BzrEclipse
{{{
bzr branch lp:bzr-xmloutput
cd bzr-xmloutput
python setup.py install
cd ..

}}}
== Configuration ==
 * Right-click on Java perspective in top-right & select Close
 * Window menu > Open Perspective > Other > Debug
 * Window menu > Show View > Expressions
 * right-click on toolbar > Customise Perspective > untick !PyDev Debug, Run & External Tools

== Debugging with Eclipse ==
 * Set and remove breakpoints by double clicking in the margin of the code file
 * Click the 'Debug Sahana Eden' button
 * F5 Step into functions
 * F6 Step over lines
 * F7 Step out of functions
 * Use expressions (drag and drop from code) or right-click > watch  

== Related Links ==
 * [wiki:DeveloperGuidelinesTips#Pythondebugging Debugging Web2Py]

----
DeveloperGuidelines