skip to navigation
skip to content

cppclean 0.2.5

Find problems in C++ source that slow development of large code bases.

Latest Version: 0.12


cppclean attempts to find problems in C++ source that slow development in large code bases, for example various forms of unused code. Unused code can be unused functions, methods, data members, types, etc to unnecessary #include directives. Unnecessary #includes can cause considerable extra compiles increasing the edit-compile-run cycle.

This is a fork of the original cppclean project. The original project home page, (which no longer contains code) is:


  • Find and print C++ language constructs: classes, methods, functions, etc.

  • Find classes with virtual methods, no virtual destructor, and no bases

  • Find global/static data that are potential problems when using threads

  • Unnecessary forward class declarations

  • Unnecessary function declarations

  • Undeclared function definitions

  • Find unnecessary header files #included
    • No direct reference to anything in the header
    • Header is unnecessary if classes were forward declared instead
  • (planned) Source files that reference headers not directly #included, ie, files that rely on a transitive #include from another header

  • (planned) Unused members (private, protected, & public) methods and data

AST is Abstract Syntax Tree, a representation of parsed source code.


$ pip install --upgrade cppclean


$ cppclean <path>

Multiple include paths can be specified:

$ cppclean --include-path=directory1 --include-path=directory2 <path>

Current status

The parser works pretty well for header files, parsing about 99% of Google’s header files. Anything which inspects structure of C++ source files should work reasonably well. Function bodies are not transformed to an AST, but left as tokens.


  • Parsing all valid C++ source
  • Handling invalid C++ source gracefully
  • Compiling to machine code (or anything beyond an AST)
File Type Py Version Uploaded on Size
cppclean-0.2.5.tar.gz (md5) Source 2014-04-04 29KB