The purpose of pygccxml is to read a generated xml file and provide a simple framework to navigate C++ declarations, using Python classes.

Using pygccxml you can:

  • Parse C++ source code
  • Create a powerful code generator
  • Generate UML diagrams
  • Build code analyzers
  • ...


Installation instructions can be found here: Installation


The examples are a good way to learn how to use pygccxml.

pygccxml provides a powerful API. If you want to know more about the provided API read the query interface document or the API documentation.


Test environment

pygccxml comes with comprehensive unit tests. They are executed on different operating systems, and with different versions of compilers. See the Travis builds for more details. pygccxml is tested under python 2.6, 2.7, 3.2, 3.3, 3.4, 3.5. All in all, pygccxml has more than 230 tests.

Indices and tables