h2. Overview

This will be the home of the next iteration of the BrowserPlus
"PythonInterpreter" service (1.x):
http://browserplus.org/docs/developer/services/PythonInterpreter.html

h3. Current State:

To be pushed to production RSN.

h3. Build Notes:

external/ is where all external dependencies python will be
fetched, patched, and built.  You must first build external dependencies,
and then can build the BrowserPlus service.  Using the BrowserPlus SDK
you can run Python services from the command line, or install the service
locally and interact with them from the web.

h3. Build & Test Prerequisites

* A recent version of ruby installed on your machine (on windows you can use the "one-click installer")
* cmake, version 2.6 or greater (see http://cmake.org)
* a recent version of the BrowserPlus SDK (http://browserplus.yahoo.com/developer/service/sdk/)
* git (duh)
* (windows only) Visual Studio 2008 (express should work?)

After Checkout you must init submodules:
<pre>
$ git submodule init
$ git submodule update
</pre>

h4. Building & running on OSX 

# git submodule init
# git submodule update
# cd external && ./build.rb (this will download and build an embeddable python)
# cd src
# mkdir build && cd build
# cmake ..
# make

To run the interpreter with a sample service
<pre>
&lt;path_to_bpsdk&gt;/bin/ServiceRunner -providerPath src/build/PythonInterpreter test/HelloWorld
</pre>

Now you'll be in a command shell where you can interact with the loaded python service

h4. Building & running on Win32

> git submodule init
> git submodule update
> cd external
> python build.rb
> cd ..\..\src
> mkdir build
> cd build
> cmake -G "Visual Studio 8 2008" ..
> devenv PythonInterpreterService.sln 
  (build Debug or Release)

To run the interpreter with a sample service
<pre>
&lt;path_to_bpsdk&gt;\bin\ServiceRunner -providerPath src\build\PythonInterpreter test\HelloWorld
</pre>


License:

see COPYING for information on licensing

stay tuned,
gary