//===--- tools/extra/clang-tidy/ClangTidyMain.cpp - Clang tidy tool -------===// // // The LLVM Compiler Infrastructure // // This file is distributed under the University of Illinois Open Source // License. See LICENSE.TXT for details. // //===----------------------------------------------------------------------===// /// /// \file This file implements a clang-tidy tool. /// /// This tool uses the Clang Tooling infrastructure, see /// http://clang.llvm.org/docs/HowToSetupToolingForLLVM.html /// for details on setting it up with LLVM source tree. /// //===----------------------------------------------------------------------===// #include "../ClangTidy.h" #include "clang/Tooling/CommonOptionsParser.h" using namespace clang::ast_matchers; using namespace clang::driver; using namespace clang::tooling; using namespace llvm; static cl::OptionCategory ClangTidyCategory("clang-tidy options"); static cl::extrahelp CommonHelp(CommonOptionsParser::HelpMessage); const char DefaultChecks[] = "*," // Enable all checks, except these: "-clang-analyzer-alpha*," // Too many false positives. "-llvm-include-order," // Not implemented yet. "-google-*,"; // Doesn't apply to LLVM. static cl::opt Checks("checks", cl::desc("Comma-separated list of globs with optional '-'\n" "prefix. Globs are processed in order of appearance\n" "in the list. Globs without '-' prefix add checks\n" "with matching names to the set, globs with the '-'\n" "prefix remove checks with matching names from the\n" "set of enabled checks."), cl::init(""), cl::cat(ClangTidyCategory)); static cl::opt HeaderFilter("header-filter", cl::desc("Regular expression matching the names of the\n" "headers to output diagnostics from. Diagnostics\n" "from the main file of each translation unit are\n" "always displayed.\n" "Can be used together with -line-filter."), cl::init(""), cl::cat(ClangTidyCategory)); static cl::opt LineFilter("line-filter", cl::desc("List of files with line ranges to filter the\n" "warnings. Can be used together with\n" "-header-filter. The format of the list is a JSON\n" "array of objects:\n" " [\n" " {\"name\":\"file1.cpp\",\"lines\":[[1,3],[5,7]]},\n" " {\"name\":\"file2.h\"}\n" " ]"), cl::init(""), cl::cat(ClangTidyCategory)); static cl::opt Fix("fix", cl::desc("Fix detected errors if possible."), cl::init(false), cl::cat(ClangTidyCategory)); static cl::opt ListChecks("list-checks", cl::desc("List all enabled checks and exit. Use with\n" "-checks='*' to list all available checks."), cl::init(false), cl::cat(ClangTidyCategory)); static cl::opt AnalyzeTemporaryDtors("analyze-temporary-dtors", cl::desc("Enable temporary destructor-aware analysis in\n" "clang-analyzer- checks."), cl::init(false), cl::cat(ClangTidyCategory)); static void printStats(const clang::tidy::ClangTidyStats &Stats) { if (Stats.errorsIgnored()) { llvm::errs() << "Suppressed " << Stats.errorsIgnored() << " warnings ("; StringRef Separator = ""; if (Stats.ErrorsIgnoredNonUserCode) { llvm::errs() << Stats.ErrorsIgnoredNonUserCode << " in non-user code"; Separator = ", "; } if (Stats.ErrorsIgnoredLineFilter) { llvm::errs() << Separator << Stats.ErrorsIgnoredLineFilter << " due to line filter"; Separator = ", "; } if (Stats.ErrorsIgnoredNOLINT) { llvm::errs() << Separator << Stats.ErrorsIgnoredNOLINT << " NOLINT"; Separator = ", "; } if (Stats.ErrorsIgnoredCheckFilter) llvm::errs() << Separator << Stats.ErrorsIgnoredCheckFilter << " with check filters"; llvm::errs() << ").\n"; if (Stats.ErrorsIgnoredNonUserCode) llvm::errs() << "Use -header-filter='.*' to display errors from all " "non-system headers.\n"; } } int main(int argc, const char **argv) { CommonOptionsParser OptionsParser(argc, argv, ClangTidyCategory); clang::tidy::ClangTidyGlobalOptions GlobalOptions; if (std::error_code Err = clang::tidy::parseLineFilter(LineFilter, GlobalOptions)) { llvm::errs() << "Invalid LineFilter: " << Err.message() << "\n\nUsage:\n"; llvm::cl::PrintHelpMessage(/*Hidden=*/false, /*Categorized=*/true); return 1; } clang::tidy::ClangTidyOptions Options; Options.Checks = DefaultChecks + Checks; Options.HeaderFilterRegex = HeaderFilter; Options.AnalyzeTemporaryDtors = AnalyzeTemporaryDtors; std::vector EnabledChecks = clang::tidy::getCheckNames(Options); // FIXME: Allow using --list-checks without positional arguments. if (ListChecks) { llvm::outs() << "Enabled checks:"; for (auto CheckName : EnabledChecks) llvm::outs() << "\n " << CheckName; llvm::outs() << "\n\n"; return 0; } if (EnabledChecks.empty()) { llvm::errs() << "Error: no checks enabled.\n"; llvm::cl::PrintHelpMessage(/*Hidden=*/false, /*Categorized=*/true); return 1; } // TODO: Implement configuration file reading and a "real" options provider. auto OptionsProvider = new clang::tidy::DefaultOptionsProvider(GlobalOptions, Options); std::vector Errors; clang::tidy::ClangTidyStats Stats = clang::tidy::runClangTidy( OptionsProvider, OptionsParser.getCompilations(), OptionsParser.getSourcePathList(), &Errors); clang::tidy::handleErrors(Errors, Fix); printStats(Stats); return 0; } namespace clang { namespace tidy { // This anchor is used to force the linker to link the LLVMModule. extern volatile int LLVMModuleAnchorSource; static int LLVMModuleAnchorDestination = LLVMModuleAnchorSource; // This anchor is used to force the linker to link the GoogleModule. extern volatile int GoogleModuleAnchorSource; static int GoogleModuleAnchorDestination = GoogleModuleAnchorSource; // This anchor is used to force the linker to link the MiscModule. extern volatile int MiscModuleAnchorSource; static int MiscModuleAnchorDestination = MiscModuleAnchorSource; } // namespace tidy } // namespace clang