A GUI for filtering "include hierarchy"-files of C++ compilers.
All 3 big C++ Compilers support some kind of include hierarchy output when compiling source code.
For MSVC, it is the /showIncludes
option,
for clang/gcc it is -H
or --trace-includes
.
The output can be very helpful tracking down some specific problems.
But also, the output can be very large and, especially the MSVC output and the hierarchy can be hard to track. Figuring out what header file includes a specific header file and at which level can be cumbersome to untangle, especially on MSVC as they choosed to use the whitespace as the hierarchy depth indicator.
For example, which files includes cstddef
(last line). This is a shortened example for the Readme, it can get much messier very fast.
Note: including file: C:\libs\Qt\6.5.0\msvc2019_64\include\QtWidgets\QMainWindow
Note: including file: C:\libs\Qt\6.5.0\msvc2019_64\include\QtWidgets\qmainwindow.h
Note: including file: C:\libs\Qt\6.5.0\msvc2019_64\include\QtWidgets/qtwidgetsglobal.h
Note: including file: C:\libs\Qt\6.5.0\msvc2019_64\include\QtGui/qtguiglobal.h
Note: including file: C:\libs\Qt\6.5.0\msvc2019_64\include\QtCore/qglobal.h
Note: including file: C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Tools\MSVC\14.37.32822\include\type_traits
Note: including file: C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Tools\MSVC\14.37.32822\include\yvals_core.h
Note: including file: C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Tools\MSVC\14.37.32822\include\vcruntime.h
Note: including file: C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Tools\MSVC\14.37.32822\include\sal.h
Note: including file: C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Tools\MSVC\14.37.32822\include\concurrencysal.h
Note: including file: C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Tools\MSVC\14.37.32822\include\vadefs.h
Note: including file: C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Tools\MSVC\14.37.32822\include\xkeycheck.h
Note: including file: C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Tools\MSVC\14.37.32822\include\cstddef
This GUI program can read the include hierarchy output from the compiler and presents it in a treeview.
You can filter the tree view and by presseing "enter", the program jumps to the first occurance of the finding.
Supports formats from MSVC, clang and gcc. Either read it from a file or copy the compiler output in the clipboard + paste it in the IncludeFilter GUI program.
It can also parse a subset of the given hierarchy output.
GPLv3 License © Matthias Möller. Made with ❤ in Germany.