cppclean
Goal
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: https://code.google.com/p/cppclean/
Features
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. http://en.wikipedia.org/wiki/Abstract_syntax_tree
Installation
$ pip install --upgrade cppclean
Run
$ 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. Such work is still needed on finding unused header files and storing an AST in a database.
Non-goals
Parsing all valid C++ source
Handling invalid C++ source gracefully
Compiling to machine code (or anything beyond an AST)
1 maintainer
Release files for cppclean 0.1.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| cppclean-0.1.2.tar.gz | 29.9 kB | Details |
Release files / cppclean-0.1.2.tar.gz
| Download URL | cppclean-0.1.2.tar.gz |
|---|---|
| Size | 29.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9be512c0de63f3856ccb540e9be00a2c44890e0083454be96e759bcc4e7a7260
|
|
BLAKE2b-256 checksum How to use checksums |
a39d1897bd90138cb364073837ef0b77c4d3111adf35e3af337153c5809a1b49
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
