PyOGP Client Library Development Sandbox

We will first run down the general explanation and add platform specific notes later.

Prerequisites

You need to have the following things installed:

• subversion (1.4.x is recommended right now)
• Python (2.5 is what we use, might work with 2.4)
• a development environment wich a C/C++ compiler

Mac specific requirements

• make sure you have X-Code installed

Getting the buildout

We use zc.buildout to automatically setup a development environment. buildout gives you the ability to install packages only locally instead of your global python installation. It's sort of a local python installation which helps you avoiding version conflicts of packages.

1. First check out the buildout into a directory of your choice:

svn co http://svn.secondlife.com/svn/linden/projects/2008/pyogp/buildouts/libdev/trunk/ libdev

If you are using svn1.5 or have otherwise problems on Mac OSX, try this buildout instead:

svn co http://svn.secondlife.com/svn/linden/projects/2008/pyogp/buildouts/libdev_mac/trunk/ libdev

It needs Python2.5 though (which is the standard Python version of Mac OSX though)

2. Enter the directory and run the bootstrap.py file:

cd libdev
python bootstrap.py

3. This creates a bunch of directories and the bin/buildout script (bin\buildout.exe on windows). We now run this:

 bin/buildout -v

or on Windows:

 bin\buildout.exe -v

4. The development sandbox is ready. There now is a bin/pyogp which is a python interpreter which contains all the installed packaged and the pyogp library and related projects.

Using the login example

To test this installation you can (at least at this stage of the project) try the following:

 bin/login <firstname> <lastname>

Give your Avatar name and it will ask for a password. Then it tries to login using the Linden Lab Agent Domain and placing the avatar on a different's grid region.

The structure of the sandbox

You now might wonder what all those directories are good for. To learn more about this check out the Filesystem Structure