[TOC]

This is a small C++ based commandline-tool which analyzes C/C++ code and creates a graph or include tree. The result can then further analyzed by other tools.

The following output formats are supported at the moment:

• dot (Graphviz): see http://www.graphviz.org/documentation
• XML / Graphml: see http://graphml.graphdrawing.org/

This tool

• is used via command-line
• supports recursive file search
• is able to process the files via multiple threads
• written in C++
• tested on Linux (GCC, clang)

Build dependecies

• cmake

Runtime Dependencies:

• boost

Test Dependencies:

• Python 3.x
• PyUnit
• PyGraphviz
• PyGraphml
• XMLRunner

Note: pip requires GraphViz development files to install PyGraphViz and PyGraphML. To install these libraries using apt-get, run sudo apt-get libgraphviz-dev

mkdir build
cd build
cmake ..
make
make doc
make install

# analyzes recursively all files in path/to/files,
# the result is written to stdout
./include_gardener  -P path/to/files

# multiple P options can be provided, for example
./include_gardener  -P path/to/files1 -P path/to/files2

# analyzes recursively all files in the curren directory,
# the include path is set to ./inc and the result is
# written to the file graph.dot:
./include_gardener  -P ./ -I ./inc -o graph.dot

# the result can then be further converted to a scalable vector graphics file.
dot -Tsvg graph.dot > graph.svg

This tool does not respect any #if #else #endif or other pre-processor statements than #include.

• Drops configuration file
• Re-organizes architecture to allow further languages in fugure
• Improves C/C++/Obj-C include statement detection

• Adds configuration file
• Small stability and performance improvements

• Initial Version

If you find a bug, unexpected behaviour or if you have a interesting feature in your mind which fits to this tool, please add an issue / feature request.

Pull requests are always welcome.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, see http://www.gnu.org/licenses/.