Difference between revisions of "PyOGP Client Library Development Sandbox"
Tao Takashi (talk | contribs) |
Enus Linden (talk | contribs) |
||
| Line 2: | Line 2: | ||
== Prerequisites == | == Prerequisites == | ||
Agents used in testing need to be in the gridnauts group in sl. | |||
You need to have the following things installed: | You need to have the following things installed: | ||
| Line 8: | Line 10: | ||
* [http://python.org/download/ Python] (2.5 is what we use, might work with 2.4) | * [http://python.org/download/ Python] (2.5 is what we use, might work with 2.4) | ||
* a development environment wich a C/C++ compiler | * a development environment wich a C/C++ compiler | ||
Linden Stations: | |||
By default have python 2.3.5 installed, which is incompatible with pyogp. Use /local/bin/python on station18 when running pyogp. | |||
=== Mac specific requirements === | === Mac specific requirements === | ||
Revision as of 10:17, 24 July 2008
We will first run down the general explanation and add platform specific notes later.
Prerequisites
Agents used in testing need to be in the gridnauts group in sl.
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
Linden Stations: By default have python 2.3.5 installed, which is incompatible with pyogp. Use /local/bin/python on station18 when running pyogp.
Mac specific requirements
- make sure you have X-Code installed
Windows specific requirements
Linux specific requirements
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