Merge branch 'hotfix/v1.7.1'

Author: iMichka

.coveragerc

@@ -1,5 +1,8 @@
 [run]
 source = pygccxml,docs/example,unittests
+# unittest/misc contains some tests that are just there for debugging
+# purposes and which do not need to be covered.
+omit = unittests/misc
 parallel = True
 
 [report]

.gitignore

@@ -4,3 +4,8 @@ docs/_build
 unittests/temp
 unittests/data/pygccxml.cache
 .idea
+dist
+build
+pygccxml.egg-info
+*.prof
+.coverage

README.rst

@@ -44,7 +44,7 @@ Branches
 
 The stable version can be found on the master branch.
 
-The develop branch containes the latest improvements but can be unstable. Pull Requests should be done on the develop branch.
+The develop branch contains the latest improvements but can be unstable. Pull Requests should be done on the develop branch.
 
 Testing and code coverage
 -------------------------

docs/apidocs/utils.rst

@@ -2,7 +2,7 @@ pygccxml.utils package
 ======================
 
 Modules
---------
+-------
 
 .. automodule:: pygccxml.utils.utils
     :members:

docs/conf.py

@@ -53,9 +53,9 @@
 # built documents.
 #
 # The short X.Y version.
-version = 'v1.7.0'
+version = 'v1.7.1'
 # The full version, including alpha/beta/rc tags.
-release = 'v1.7.0'
+release = 'v1.7.1'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

docs/design.rst

@@ -2,28 +2,31 @@
 Design overview
 ===============
 
-------------------------
-The view from 10000 fits
-------------------------
-
 pygccxml has 4 packages:
 
-* :mod:`declarations <pygccxml.declarations>` package defines classes that describe
-  C++ declarations and types
+* :mod:`declarations <pygccxml.declarations>`
+
+  This package defines classes that describe C++ declarations and types.
+
+* :mod:`parser <pygccxml.parser>`
+
+  This package defines classes that parse `GCC-XML`_
+  or `CastXML`_ generated files. It also defines a few classes that will help
+  you unnecessary parsing of C++ source files.
 
-* :mod:`parser <pygccxml.parser>` package defines classes that parse `GCC-XML`_
-  generated files. Also it defines few classes that will help you to eliminate
-  unnecessary parsing of C++ source files.
+* :mod:`binary_parsers <pygccxml.binary_parsers>`
 
-* :mod:`binary_parsers <pygccxml.binary_parsers>` package extracts some
-  information from binary files ( `.so`, `.dll`, `.map` ) and merges it with
-  the declarations tree.
+  This package extracts information from binary files (`.so`, `.dll`, `.map`)
+  and merges it with the declarations tree.
 
-* ``utils`` package defines few functions, I found useful in the whole project.
+* :mod:`utils <pygccxml.utils>`
 
--------------------------
+  This package defines a few functions useful for the whole project,
+  but which are mainly used internally by pygccxml.
+
+------------------------
 ``declarations`` package
--------------------------
+------------------------
 
 Please take a look on the `UML diagram`_. This `UML diagram`_ describes almost all
 classes defined in the package and their relationship. ``declarations`` package
@@ -275,6 +278,13 @@ This is not the only bug, which could be fixed, there are few of them. pygccxml
 introduces few classes, which knows how to deal with specific bug. More over, those
 bugs are fixed, only if I am 101% sure, that this is the right thing to do.
 
+-----------------
+``utils`` package
+-----------------
+
+ Use internally by pygccxml.
+ Some methods/classes may be still usefull: loggers, find_xml_generator
+
 -------
 Summary
 -------
@@ -287,6 +297,7 @@ information please read API documentation.
 .. _`SourceForge`: http://sourceforge.net/index.php
 .. _`Python`: http://www.python.org
 .. _`GCC-XML`: http://www.gccxml.org
+.. _`CastXML`: https://github.com/CastXML/CastXML
 .. _`UML diagram` : declarations_uml.png
 .. _`parser package UML diagram` : parser_uml.png
 .. _`ReleaseForge` : http://releaseforge.sourceforge.net

docs/history.rst

@@ -11,6 +11,24 @@ to python 3 (keeping it compatible with python 2).
 In Mai 2014, Michka Popoff and the Insight Software Consortium revived pygccxml
 by setting up a git repositery on github, hosted along with gccxml.
 
+Version 1.7.1
+-------------
+
+1. Remove the __va_list_tag declaration from the tree when parsing with CastXML
+
+   The __va_list_tag declarations are internal declarations, which are often
+   not needed. They are for example polluting the declarations tree when running
+   pyplusplus.
+
+   This is optional but on by default. To still load the __va_list_tag declarations
+   in the tree, a config flag can be set like this: ``config.flags = ["f1"]``,
+   or by passing the ``flags=["f1"]`` argument the config setup.
+
+2. Some code cleanup
+
+3. Build new package for pypi. The ``1.7.0`` upload has gone wrong ...
+
+
 Version 1.7.0
 -------------
 
@@ -124,6 +142,8 @@ Version 1.7.0
 
 24. [Doc] Small documentation update, moved people list to credits page, added new examples.
 
+25. [Misc] Add Travis unit tests for Python 3.5
+
 
 Version 1.6.2
 -------------

pygccxml/__init__.py

@@ -40,4 +40,4 @@
 # TODO:
 # 1. Add "explicit" property for constructors
 
-__version__ = 'v1.7.0'
+__version__ = 'v1.7.1'

pygccxml/binary_parsers/parsers.py

@@ -430,7 +430,7 @@ def merge_information(global_ns, fname, runs_under_unittest=False):
     """high level function - select the appropriate binary file parser and
     integrates the information from the file to the declarations tree. """
     ext = os.path.splitext(fname)[1]
-    parser = None
+
     if '.dll' == ext:
         parser = dll_file_parser_t(global_ns, fname)
     elif '.map' == ext:

pygccxml/binary_parsers/undname.py

@@ -21,7 +21,7 @@
 from .. import declarations
 
 
-class UNDECORATE_NAME_OPTIONS:
+class UNDECORATE_NAME_OPTIONS(object):
 
     """defines few constants for `UnDecorateSymbolName` function"""
 
@@ -76,7 +76,7 @@ class UNDECORATE_NAME_OPTIONS:
         | UNDNAME_NO_ACCESS_SPECIFIERS | UNDNAME_NO_ECSU
 
 
-class undname_creator_t:
+class undname_creator_t(object):
 
     """implementation details - should not be used directly
 
@@ -253,7 +253,7 @@ def format_decl(self, decl, hint=None):
         could be mapped later to the blobs.
         The valid options are: "msvc" and "nm".
         """
-        name = None
+
         if hint is None:
             if 'nt' == os.name:
                 hint = 'msvc'