pygccxml-development

[pygccxml-development] High level API

[Roman Y. <rom...@gm...>]

Hi. We have small problem in all versions of API's. ( I think )

Module builder class implicitly done some steps if user did not them.
For example if user didn't called "parse" method, then it will be
called from next step by framework. The same will happen with
code_creators tree. What is wrong with this?

There are some customization that user can do on declarations, even
after code creators
tree creation. But there are set of customizations that will not have
effect on code creators.
For example ignore. In big project it cause a problem, because
customize code is not
written in one place.

I think, we should change the behaviour in next way:

__init__ function will take as parameters:
    module name
    list of files
    gccxml parser configuration

__init__ function will parse file and put global namespace decl in
global_ns member variable

declarations member variable will be deleted

From this point if user tries to work with code creators tree or just
write code to
disk, every step should be done explicitly by user, otherwise
exception will be raised.

create_code_creators_tree ( please give better name for the function )
function will
create/initialize module_creator instance

write_file/write_multiple_files will write code to disk

What do you think? I just debug my own program that had the bug like
this. I did not
like the fact that it is easy to be confused.

--
Roman Yakovenko
C++ Python language binding
http://www.language-binding.net/

Re: [pygccxml-development] High level API

[Roman Y. <rom...@gm...>]

On 3/19/06, Matthias Baas <ba...@ir...> wrote:
> Roman Yakovenko wrote:
> > There are some customization that user can do on declarations, even
> > after code creators tree creation.
>
> So far, I was considering it more or less an error if the user modifies
> the declaration tree after the code creator tree has been created

And you was right here. The only mistake is that I did is that
"Errors should never pass silently". We need to raise an error, when
user tries to
do it, or at least to print some warning to him.

>
> > But there are set of customizations that will not have
> > effect on code creators.
> > For example ignore.
>
> I don't understand that. Ignoring a declaration has the effect that the
> corresponding code creator is not created, so it does have an effect on
> the code creators, doesn't it?

If code creators tree already created then setting ignore flag to
true, will not have
effect. And this is exactly the problem I spent more then 3 hours to find.
It drive me crazy. So I prefer to fix it in a such way, that user at least
will be aware to this.

What can you recommend?

--
Roman Yakovenko
C++ Python language binding
http://www.language-binding.net/

Re: [pygccxml-development] High level API

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

Roman Yakovenko wrote:
> And you was right here. The only mistake is that I did is that
> "Errors should never pass silently". We need to raise an error, when
> user tries to
> do it, or at least to print some warning to him.

I agree (I added this behavior to the experimental module).

- Matthias -

Re: [pygccxml-development] High level API

[Roman Y. <rom...@gm...>]

On 3/20/06, Matthias Baas <ba...@ir...> wrote:
> Roman Yakovenko wrote:
> > And you was right here. The only mistake is that I did is that
> > "Errors should never pass silently". We need to raise an error, when
> > user tries to
> > do it, or at least to print some warning to him.
>
> I agree (I added this behavior to the experimental module).

Good. I will take a look on it and move relevant code to the main branch.
Thanks

> - Matthias -


--
Roman Yakovenko
C++ Python language binding
http://www.language-binding.net/