cppclean
Find problems in C++ source that slow development of large code bases.
Decision gist · record as of 2026-08-14
No. The package is abandoned (last release 2019-07-30, no commits since 2022-07-26) and has high install friction. While it may still work for basic C++ analysis, the lack of maintenance means it will not support modern C++ standards or recent Python versions. For active C++ projects, consider maintained alternatives.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires a working C++ codebase to analyze; the tool parses C++ headers and source but does not compile or execute code.
- High install friction: the package is distributed as a source tarball and has been abandoned since 2019.
- Last release was 2019-07-30, with no commits since 2022-07-26.
License · maintenance · safety
Apache license (permissive) — Licensed under Apache license (permissive), which allows commercial and private use with minimal restrictions, making it safe from a licensing standpoint for most projects.
last release 2019-07-30 (2572 days) · last repo commit 2022-07-26 · 726 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 106,408 downloads/mo, #12,652 on PyPI
Alternatives
Verify before relying
pip install --upgrade cppclean
cppclean --include-path=directory1 --include-path=directory2- Whether the parser remains compatible with modern C++ standards given the last release was 2019-07-30.
- Whether the tool works reliably with Python 3.10+ despite unspecified Python version support.
- Current state of the planned features (unnecessary includes in source files, transitive includes, unused members).
- Whether the tool still functions correctly with current Python interpreters after years without maintenance.
What it is and what it does
cppclean is a static analysis tool for C++ that identifies problems in source code that can slow development cycles in large projects. It parses C++ headers and source files into an abstract syntax tree and detects issues like unused functions, methods, data members, and types; unnecessary forward declarations; undeclared definitions; and redundant #include directives. The tool reports inconsistent case in includes and can suggest removing headers that are not directly referenced.
The parser is designed to handle real-world C++ code reasonably well, achieving about 99% success on Google's header files. Function bodies are tokenized rather than fully parsed into an AST. The tool runs from the command line and accepts multiple include paths to analyze. However, it has been unmaintained since 2019 and may not support modern C++ syntax or recent Python versions.
Use it for
- Reduce compilation time in large C++ projects by identifying and removing unnecessary #include directives in header files.
- Detect unused functions, methods, and data members that can be safely removed from a codebase.
- Find classes with virtual methods but no virtual destructors, a common source of memory leaks in C++.
- Identify global and static data that may cause threading issues in multi-threaded applications.
- Locate undeclared function definitions and unnecessary forward declarations during code review.
- Audit header files for inconsistent case in #include statements (e.g., foo.h vs Foo.h).
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
No.
The package is abandoned (last release 2019-07-30, no commits since 2022-07-26) and has high install friction. While it may still work for basic C++ analysis, the lack of maintenance means it will not support modern C++ standards or recent Python versions. For active C++ projects, consider maintained alternatives.
Install
cppclean on PyPI
Before you install
High install friction: the package is distributed as a source tarball and has been abandoned since 2019. Last release was 2019-07-30, with no commits since 2022-07-26.
Requires a working C++ codebase to analyze; the tool parses C++ headers and source but does not compile or execute code.
License in practice
Licensed under Apache license (permissive), which allows commercial and private use with minimal restrictions, making it safe from a licensing standpoint for most projects.
Quickstart
pip install --upgrade cppclean
cppclean --include-path=directory1 --include-path=directory2Verify before relying
- Whether the parser remains compatible with modern C++ standards given the last release was 2019-07-30.
- Whether the tool works reliably with Python 3.10+ despite unspecified Python version support.
- Current state of the planned features (unnecessary includes in source files, transitive includes, unused members).
- Whether the tool still functions correctly with current Python interpreters after years without maintenance.
Package facts
| License | Apache license permissive |
| Python support | Not specified |
| Install friction | High. Source build required |
| Runtime dependencies | None |
| Maintenance | Abandoned 2,572 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 106,408 / month, #12,652 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Environment :: ConsoleIntended Audience :: DevelopersOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 2.7Programming Language :: Python :: 3Topic :: Software Development :: Quality Assurance |
Evidence: cppclean-0.13.tar.gz
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “unnecessary include finder”
- cppcleancppclean analyzes C++ source code to identify unused code,…
- pyobjc-framework-FinderSyncProvides Python bindings to macOS's FinderSync framework, allowing…
- pyrootsImplements root-finding algorithms (bisect, ridder, Brent) for…
Give your agent the search over MCP, or paste the wish link into any chat.
More Quality Assurance packages
Coverage.py measures which lines of Python code are executed during test runs, reporting coverage percentages and identifying untested code paths.
Install it if you want to measure test completeness or enforce coverage thresholds in your project.
Ruff is a Python linter and code formatter written in Rust that combines linting, formatting, and code fixing into a single tool, replacing Flake8, Black, isort, and related utilities.
Pexpect spawns and controls interactive console applications by sending input and matching output patterns, automating tasks that would otherwise require manual interaction.
Black reformats Python source code to a consistent style by parsing entire files and rewriting them according to an opinionated, deterministic set of rules, eliminating manual formatting decisions.
pytest-xdist distributes pytest tests across multiple CPU cores or machines to speed up test execution, with the simplest usage being `pytest -n auto` to spawn workers equal to available CPUs.
Install it if your test suite takes long enough that parallelization would save meaningful time.
Validates AWS CloudFormation templates in YAML or JSON format against resource provider schemas and best practices, checking property values and configuration correctness.
Install it if you work with CloudFormation templates.
See also uncalled · pytest-unused-fixtures · cxxheaderparser · deadcode · deptry · yesqa · creosote · fawltydeps · vulture · pcodedmp