Re: [pygccxml-development] Phisical (re)design

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

Roman Yakovenko wrote:
> On 4/18/06, Matthias Baas <ba...@ir...> wrote:
>> Roman Yakovenko wrote:
>>> pyplusplus_dev/
>>> |    |----environment.py #containes paths to boost  and pygccxml
> 
> pyplusplus unit tests have external dependencies: boost libraries,
> scons, location
> of header files. This file should contain this information. I don't
> like this approach.
> The second approach I considered was environment variables - I hate
> it. So I am going
> with the first one. If you have better idea, and obvious you do, then
> share it :-)

Having some sort of config file for the unit tests is ok. The question 
is, if this file should be under cvs control or not. Personally, I think 
it should not be in cvs because the contents of that file depend on the 
user's environment and every user who wants to run the unit tests needs 
a different file anyway.

>> What is this file used for?
>>> |    |    |----scripts/
>> Currently, this directory is not a sub-package and the files in this
>> directory are not meant to be imported. That's why I'd suggest to move
>> this directory up one level.
> 
> May be I missed that, so scripts will sit in the same directory where setup.py?

That's what I would do. (You may put it into some other directory if you 
want, the point is just that it is not inside the 'pyplusplus' directory)

>> What's the difference between docs/tutorials and tutorials?
> 
> I want to create full separation between code and documentation.
> 
> docs directory contains documentation for whole project, including
> examples, tutorials and
> whatever.
> 
> All other directories contains code.

ok, I see.

> I have question. pyplusplus depends on other software: boost, EasyBMP,
> TnFOX and I can add something in the future. 

When you say 'pyplusplus' you obviously mean the entire contents of the 
cvs repository, right? (whereas when I read 'pyplusplus' I only think of 
the actual Python package (including pygccxml))
The above are not required for users of pyplusplus who create their own 
bindings. It's only required if someone wants to run the examples you 
provided (or if someone really wants those libraries in Python).

> I expose whole functionality found in
> that libraries, except TnFOX ) to Python. So, those packages become
> useful and valuable on their own.
> 
> How I should manage ( location within directory tree, for example )
> those 3rd party libraries?

Is the main intention of those bindings to serve as an example for 
pyplusplus or to create bindings that are really meant to be used on 
their own (and that are maintained by yourself)?
In the former case I would suggest to leave them in an examples 
directory and in the latter case I would argue that they don't belong 
into the pyplusplus repository and you might instead consider 
registering one or more new SF projects for them.

- Matthias -