include-what-you-use/include-what-you-use
Include What You Use
Include What You Use is a C++ include optimizer and header dependency analyzer. It identifies unused or missing header includes in source files to reduce project bloat and improve compilation performance.
The tool performs static analysis using a Clang-based abstract syntax tree to map symbol usage and track preprocessor effects across different build configurations. It can automatically rewrite source files by inserting or deleting preprocessor directives based on the calculated dependency graph.
The system integrates with compilation databases to determine the exact compiler flags used for each source file, enabling the analysis and pruning of dependencies across an entire project.
Features
- Header Dependency Analysis - Provides specialized analysis to identify redundant or missing header inclusions to optimize C++ compilation times.
- Recursive Include Optimization - Reduces project bloat and compilation times by optimizing recursive include paths and pruning unused headers.
- AST-Based Source Transformations - Implements AST-based source transformations to automatically insert or delete preprocessor directives in source files.
- C++ Build Optimization - Optimizes C++ build performance by reducing compilation overhead through the pruning of unnecessary header includes.
- Header - Ensures every source file includes exactly the headers it needs for correct compilation without redundancy.
- Symbol Usage Tracking - Maps every identifier in a file against declarations provided by included headers to track symbol usage.
- C++ Header Optimizers - Identifies and removes unused header files to reduce project bloat and accelerate compilation speeds.
- Preprocessors - Tracks C-family preprocessor macros and conditional compilation to ensure accurate dependency analysis across build configurations.
- Compiler-Integrated AST Parsing - Utilizes the Clang compiler frontend to parse source code into an abstract syntax tree for precise symbol tracking.
- Build System Integration - Connects the analysis engine to compilers and compilation databases to automate project-wide header optimization.
- Automated Fixers - Automatically applies programmatic corrections to source files by adding or removing include directives based on static analysis.
- Compilation Database Integrations - Integrates with JSON compilation databases to determine the exact compiler flags used for every source file.
- Automated Code Fixes - Provides a command-line interface to automatically apply source code edits that fix missing or unused includes.
- Static Analysis - Uses the Clang toolset for static analysis of source code patterns to manage header dependencies.
- Build Systems - A tool to identify and fix unnecessary header inclusions.
- Developer Tools - Tool to analyze includes in source files
- Development Tools - Identify and fix unnecessary header inclusions.
- Static Analysis - Analyzes include files to optimize build times and dependencies.
- Windows Environments - Listed in the “Windows Environments” section of the Awesome C awesome list.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
