[pygccxml-development] pyplusplus status

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

Hi. I just want to describe what have been done and what I think should be done
before next version will be ready to be released.

Done:
1. pyplusplus now preserves the order of generated code. I mean if you
run pyplusplus
    twice, than second run will not change any file. If you see a
different behaviour, please
    report a bug.

2. Usability of pyplusplus has been improved. Now by default it will
print only very important
    messages:
    1. gccxml command line ( printed text will start with "INFO" word )
    2. declarations, that user asked to export, but for some reason,
pyplusplus can
        not export them ( ( printed text will start with "WARNING" word )
    3. a list of updated(created) files ( printed text will start with
"INFO" word )

    It is possible to configure pyplusplus to print much more information:

    import logger
    from pyplusplus import module_builder
    module_builder.set_logger_level( logging.DEBUG )

3. pyplusplus is able to generate code for indexing suite v2.
    You need explicitly to enable it:
    mb = module_builder.module_builder_t( ..., indexing_suite_version=2 )

    The documentation for this feature is in progress

What still should be done?

1. Georgiy Dernovoy contributed code, that extracts doxygen
documentation from source
    files. I will add code to pyplusplus that will generate documentation.

2. I should find solution for long standing problem: the number of
include directives
    in generated source files.

3. I am going to work a little on file_writers package. The main
missing future here is
   to add user code to generated source file.

4. Documentation.

For items (2) and (3), I'd like to know your opinion:
    1. What code pyplusplus should generate?
    2. How do you prefer to configure the feature? ( user interface )

I don't want to set release day,  but from now I will try to keep
source code in
"release ready" mode. If you can try source code from "Subversion" and
report bugs
it will be grate.

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