LiveAPI

Setting up Eclipse for developing with the LiveAPI

1. Eclipse, PyDev and Subclipse (for SVN)

Eclipse is a huge project and can be used for many things, but if you just want to do some python coding you can keep your download to a minimum by just getting what is called the 'eclipse platform', this is the basic eclipse application without all the features required for programming other languages like Java, C etc..

If you go here :

http://archive.eclipse.org/eclipse/downloads/drops/R-3.3.2-200802211800/index.php

and look down the page there is a section called 'Platform Runtime Binary', choose the binary for your platform from here. It should be about 40Mb. When its downloaded just unpack it where you want to keep it, it doesnt need installing. Once its unpacked, go into the eclipse folder and run it.

Install PyDev and SVN

In Eclipse go to Help -> Software Updates -> Find and Install

When it asks

Search for updates of the currently installed features
or
Search for new features to install

make sure search for new features is selected and do Next.

New Remote Site

Name : PyDev
Url : http://pydev.sourceforge.net/updates/

Then New Remote Site again

Name : Subclipse
Url : http://subclipse.tigris.org/update_1.2.x

Both the PyDev and Subclipse boxes should be ticked so click Finish.

After some searching you'll get a new window, in that window expand the top PyDev node and then the next !Pydev node then tick the box for PyDev for Eclipse expand the Subclipse node and then the subclipse plugin node and tick the box for Subclipse. Click Next. Accept the licence agreements and then Next and Finish.

After the extensions have downloaded you will be asked what to do, select 'Install All' then when it asks to restart (eclipse, not your machine) click Yes.

2. Download and install Python 2.2.3

Note on OSX python is already available, albeit a later version than the one that is part of Live, so you dont necessarily need to install a new version. You can skip to 3.

Go here and choose the download you need

http://www.python.org/download/releases/2.2.3/

which on windows is probably this :

http://www.python.org/ftp/python/2.2.3/Python-2.2.3.exe

When its downloaded run the installer. You can install it where you like but be aware that the LiveTelnet application is setup to use C:\Python22 by default and that is also the default from the Python installer.

3. Configure PyDev

Now we have to tell eclipse which python we are using, go to

Window (or File on OSX) -> Preferences -> PyDev -> Interpreter - Python

In the top section click New.. and navigate to

PC : /python.exe
OSX : /usr/bin/python

Next you will be asked to select which folders to add to the system python path, dont worry about this just hit OK.
Then OK again to close the preferences.

4. Get the LiveAPI source code

To get the source code we'll add the google code repository to our eclipse SVN configuration.

In Eclipse go to Window -> Open Perspective -> Other...

then select 'SVN Repository Exploring' and hit ok.

In the 'SVN Repository' pane that just opened click the button that says 'svn' with the little yellow plus on it.

Enter http://svn2.assembla.com/svn/live-api

into the box that comes up and click ok. After a little wait you should see the svn repository show up in the tree view. Open the top node, right click 'trunk' and select 'Checkout..'

In the window that appears leave the default option (Checkout as project in the workspace) and click Finish. Finally the code will be checked out of the repository into a new project.