Re: [pygccxml-development] Future of pypp_api...

[Matthias B. <ba...@ir...>]

Lakin Wecker wrote:
> I've had a look at the pypp wiki a few times now, although I have not 
> read through it in great detail.   From looking at the wiki, I still 
> don't understand what it is that pypp does. 
> 
> If you want to convince me that pypp is an easier better api to use, 
> then you're going to have to create some concrete examples of how this 
> new API saves me time.

Just to clarify, compared to the Py++ high-level API pypp_api is not a 
*new* API. pypp_api was created by Allen and me because we were not 
satisfied with the way py++ had to be used at that time (there hasn't 
been any high-level API at all). Obviously the general concepts from our 
experimental prototype did convince Roman and so he implemented his own 
version of a high-level API which is based on the ideas from pypp_api 
but which does some things differently. To me it was just another 
"prototype" to try out alternative ways. But as it is integrated into 
the pyplusplus code base it has become the official API.
Anyway, this explains why there are a lot of similarities between the 
two APIs.

Meanwhile I'm the only one who is using pypp_api and who's keeping it 
alive. But instead of sticking it into the repository for my own project 
I decided to put it into the pyplusplus contrib directory so that 1) 
others who are interested have the chance to try it out as well and 2) I 
don't have to duplicate code when I want to use the API for another project.

As for documentation/examples, now that we have a wiki I did write a 
short quick start tutorial and I've just started some user guide 
documentation. So if anyone is interested in giving pypp_api a try then 
keep an eye on the following pages:

https://realityforge.vrsource.org/view/PyppApi/PyppTutorial
https://realityforge.vrsource.org/view/PyppApi/PyppUserGuide

and run the script contrib/pypp_api/generate_docs.py to create an epydoc 
reference manual.

If you want a full example you could have a look at pypp_setup.py in 
here: http://svn.sourceforge.net/viewvc/cgkit/maya/trunk/maya_wrapper/
This is how I create Python bindings for the Maya SDK (Maya is a 
commercial 3D application from Autodesk (formerly from Alias)).

But on the other hand, if you're entirely happy with the current Py++ 
API and you already have the bindings you wanted to have, then there's 
absolutely no reason to waste your time with pypp_api.

- Matthias -