//===- CoverageReport.cpp - Code coverage report -------------------------===// // // The LLVM Compiler Infrastructure // // This file is distributed under the University of Illinois Open Source // License. See LICENSE.TXT for details. // //===----------------------------------------------------------------------===// // // This class implements rendering of a code coverage report. // //===----------------------------------------------------------------------===// #include "CoverageReport.h" #include "RenderingSupport.h" #include "llvm/ADT/DenseMap.h" #include "llvm/Support/FileSystem.h" #include "llvm/Support/Format.h" #include "llvm/Support/Path.h" #include using namespace llvm; namespace { /// \brief Helper struct which prints trimmed and aligned columns. struct Column { enum TrimKind { NoTrim, WidthTrim, RightTrim }; enum AlignmentKind { LeftAlignment, RightAlignment }; StringRef Str; unsigned Width; TrimKind Trim; AlignmentKind Alignment; Column(StringRef Str, unsigned Width) : Str(Str), Width(Width), Trim(WidthTrim), Alignment(LeftAlignment) {} Column &set(TrimKind Value) { Trim = Value; return *this; } Column &set(AlignmentKind Value) { Alignment = Value; return *this; } void render(raw_ostream &OS) const { if (Str.size() <= Width) { if (Alignment == RightAlignment) { OS.indent(Width - Str.size()); OS << Str; return; } OS << Str; OS.indent(Width - Str.size()); return; } switch (Trim) { case NoTrim: OS << Str; break; case WidthTrim: OS << Str.substr(0, Width); break; case RightTrim: OS << Str.substr(0, Width - 3) << "..."; break; } } }; raw_ostream &operator<<(raw_ostream &OS, const Column &Value) { Value.render(OS); return OS; } Column column(StringRef Str, unsigned Width) { return Column(Str, Width); } template Column column(StringRef Str, unsigned Width, const T &Value) { return Column(Str, Width).set(Value); } // Specify the default column widths. size_t FileReportColumns[] = {25, 12, 18, 10, 12, 18, 10, 16, 16, 10, 12, 18, 10}; size_t FunctionReportColumns[] = {25, 10, 8, 8, 10, 8, 8}; /// \brief Adjust column widths to fit long file paths and function names. void adjustColumnWidths(ArrayRef Files, ArrayRef Functions) { for (StringRef Filename : Files) FileReportColumns[0] = std::max(FileReportColumns[0], Filename.size()); for (StringRef Funcname : Functions) FunctionReportColumns[0] = std::max(FunctionReportColumns[0], Funcname.size()); } /// \brief Prints a horizontal divider long enough to cover the given column /// widths. void renderDivider(ArrayRef ColumnWidths, raw_ostream &OS) { size_t Length = std::accumulate(ColumnWidths.begin(), ColumnWidths.end(), 0); for (size_t I = 0; I < Length; ++I) OS << '-'; } /// \brief Return the color which correponds to the coverage percentage of a /// certain metric. template raw_ostream::Colors determineCoveragePercentageColor(const T &Info) { if (Info.isFullyCovered()) return raw_ostream::GREEN; return Info.getPercentCovered() >= 80.0 ? raw_ostream::YELLOW : raw_ostream::RED; } /// \brief Get the number of redundant path components in each path in \p Paths. unsigned getNumRedundantPathComponents(ArrayRef Paths) { // To start, set the number of redundant path components to the maximum // possible value. SmallVector FirstPathComponents{sys::path::begin(Paths[0]), sys::path::end(Paths[0])}; unsigned NumRedundant = FirstPathComponents.size(); for (unsigned I = 1, E = Paths.size(); NumRedundant > 0 && I < E; ++I) { StringRef Path = Paths[I]; for (const auto &Component : enumerate(make_range(sys::path::begin(Path), sys::path::end(Path)))) { // Do not increase the number of redundant components: that would remove // useful parts of already-visited paths. if (Component.index() >= NumRedundant) break; // Lower the number of redundant components when there's a mismatch // between the first path, and the path under consideration. if (FirstPathComponents[Component.index()] != Component.value()) { NumRedundant = Component.index(); break; } } } return NumRedundant; } /// \brief Determine the length of the longest redundant prefix of the paths in /// \p Paths. unsigned getRedundantPrefixLen(ArrayRef Paths) { // If there's at most one path, no path components are redundant. if (Paths.size() <= 1) return 0; unsigned PrefixLen = 0; unsigned NumRedundant = getNumRedundantPathComponents(Paths); auto Component = sys::path::begin(Paths[0]); for (unsigned I = 0; I < NumRedundant; ++I) { auto LastComponent = Component; ++Component; PrefixLen += Component - LastComponent; } return PrefixLen; } } // end anonymous namespace namespace llvm { void CoverageReport::render(const FileCoverageSummary &File, raw_ostream &OS) const { auto FileCoverageColor = determineCoveragePercentageColor(File.RegionCoverage); auto FuncCoverageColor = determineCoveragePercentageColor(File.FunctionCoverage); auto InstantiationCoverageColor = determineCoveragePercentageColor(File.InstantiationCoverage); auto LineCoverageColor = determineCoveragePercentageColor(File.LineCoverage); SmallString<256> FileName = File.Name; sys::path::remove_dots(FileName, /*remove_dot_dots=*/true); sys::path::native(FileName); OS << column(FileName, FileReportColumns[0], Column::NoTrim) << format("%*u", FileReportColumns[1], (unsigned)File.RegionCoverage.NumRegions); Options.colored_ostream(OS, FileCoverageColor) << format( "%*u", FileReportColumns[2], (unsigned)File.RegionCoverage.NotCovered); if (File.RegionCoverage.NumRegions) Options.colored_ostream(OS, FileCoverageColor) << format("%*.2f", FileReportColumns[3] - 1, File.RegionCoverage.getPercentCovered()) << '%'; else OS << column("-", FileReportColumns[3], Column::RightAlignment); OS << format("%*u", FileReportColumns[4], (unsigned)File.FunctionCoverage.NumFunctions); OS << format("%*u", FileReportColumns[5], (unsigned)(File.FunctionCoverage.NumFunctions - File.FunctionCoverage.Executed)); if (File.FunctionCoverage.NumFunctions) Options.colored_ostream(OS, FuncCoverageColor) << format("%*.2f", FileReportColumns[6] - 1, File.FunctionCoverage.getPercentCovered()) << '%'; else OS << column("-", FileReportColumns[6], Column::RightAlignment); OS << format("%*u", FileReportColumns[7], (unsigned)File.InstantiationCoverage.NumFunctions); OS << format("%*u", FileReportColumns[8], (unsigned)(File.InstantiationCoverage.NumFunctions - File.InstantiationCoverage.Executed)); if (File.InstantiationCoverage.NumFunctions) Options.colored_ostream(OS, InstantiationCoverageColor) << format("%*.2f", FileReportColumns[9] - 1, File.InstantiationCoverage.getPercentCovered()) << '%'; else OS << column("-", FileReportColumns[9], Column::RightAlignment); OS << format("%*u", FileReportColumns[10], (unsigned)File.LineCoverage.NumLines); Options.colored_ostream(OS, LineCoverageColor) << format( "%*u", FileReportColumns[11], (unsigned)File.LineCoverage.NotCovered); if (File.LineCoverage.NumLines) Options.colored_ostream(OS, LineCoverageColor) << format("%*.2f", FileReportColumns[12] - 1, File.LineCoverage.getPercentCovered()) << '%'; else OS << column("-", FileReportColumns[12], Column::RightAlignment); OS << "\n"; } void CoverageReport::render(const FunctionCoverageSummary &Function, const DemangleCache &DC, raw_ostream &OS) const { auto FuncCoverageColor = determineCoveragePercentageColor(Function.RegionCoverage); auto LineCoverageColor = determineCoveragePercentageColor(Function.LineCoverage); OS << column(DC.demangle(Function.Name), FunctionReportColumns[0], Column::RightTrim) << format("%*u", FunctionReportColumns[1], (unsigned)Function.RegionCoverage.NumRegions); Options.colored_ostream(OS, FuncCoverageColor) << format("%*u", FunctionReportColumns[2], (unsigned)Function.RegionCoverage.NotCovered); Options.colored_ostream( OS, determineCoveragePercentageColor(Function.RegionCoverage)) << format("%*.2f", FunctionReportColumns[3] - 1, Function.RegionCoverage.getPercentCovered()) << '%'; OS << format("%*u", FunctionReportColumns[4], (unsigned)Function.LineCoverage.NumLines); Options.colored_ostream(OS, LineCoverageColor) << format("%*u", FunctionReportColumns[5], (unsigned)Function.LineCoverage.NotCovered); Options.colored_ostream( OS, determineCoveragePercentageColor(Function.LineCoverage)) << format("%*.2f", FunctionReportColumns[6] - 1, Function.LineCoverage.getPercentCovered()) << '%'; OS << "\n"; } void CoverageReport::renderFunctionReports(ArrayRef Files, const DemangleCache &DC, raw_ostream &OS) { bool isFirst = true; for (StringRef Filename : Files) { auto Functions = Coverage.getCoveredFunctions(Filename); if (isFirst) isFirst = false; else OS << "\n"; std::vector Funcnames; for (const auto &F : Functions) Funcnames.emplace_back(DC.demangle(F.Name)); adjustColumnWidths({}, Funcnames); OS << "File '" << Filename << "':\n"; OS << column("Name", FunctionReportColumns[0]) << column("Regions", FunctionReportColumns[1], Column::RightAlignment) << column("Miss", FunctionReportColumns[2], Column::RightAlignment) << column("Cover", FunctionReportColumns[3], Column::RightAlignment) << column("Lines", FunctionReportColumns[4], Column::RightAlignment) << column("Miss", FunctionReportColumns[5], Column::RightAlignment) << column("Cover", FunctionReportColumns[6], Column::RightAlignment); OS << "\n"; renderDivider(FunctionReportColumns, OS); OS << "\n"; FunctionCoverageSummary Totals("TOTAL"); for (const auto &F : Functions) { FunctionCoverageSummary Function = FunctionCoverageSummary::get(F); ++Totals.ExecutionCount; Totals.RegionCoverage += Function.RegionCoverage; Totals.LineCoverage += Function.LineCoverage; render(Function, DC, OS); } if (Totals.ExecutionCount) { renderDivider(FunctionReportColumns, OS); OS << "\n"; render(Totals, DC, OS); } } } std::vector CoverageReport::prepareFileReports(const coverage::CoverageMapping &Coverage, FileCoverageSummary &Totals, ArrayRef Files) { std::vector FileReports; unsigned LCP = getRedundantPrefixLen(Files); for (StringRef Filename : Files) { FileCoverageSummary Summary(Filename.drop_front(LCP)); // Map source locations to aggregate function coverage summaries. DenseMap, FunctionCoverageSummary> Summaries; for (const auto &F : Coverage.getCoveredFunctions(Filename)) { FunctionCoverageSummary Function = FunctionCoverageSummary::get(F); auto StartLoc = F.CountedRegions[0].startLoc(); auto UniquedSummary = Summaries.insert({StartLoc, Function}); if (!UniquedSummary.second) UniquedSummary.first->second.update(Function); Summary.addInstantiation(Function); Totals.addInstantiation(Function); } for (const auto &UniquedSummary : Summaries) { const FunctionCoverageSummary &FCS = UniquedSummary.second; Summary.addFunction(FCS); Totals.addFunction(FCS); } FileReports.push_back(Summary); } return FileReports; } void CoverageReport::renderFileReports(raw_ostream &OS) const { std::vector UniqueSourceFiles; for (StringRef SF : Coverage.getUniqueSourceFiles()) UniqueSourceFiles.emplace_back(SF.str()); renderFileReports(OS, UniqueSourceFiles); } void CoverageReport::renderFileReports(raw_ostream &OS, ArrayRef Files) const { FileCoverageSummary Totals("TOTAL"); auto FileReports = prepareFileReports(Coverage, Totals, Files); std::vector Filenames; for (const FileCoverageSummary &FCS : FileReports) Filenames.emplace_back(FCS.Name); adjustColumnWidths(Filenames, {}); OS << column("Filename", FileReportColumns[0]) << column("Regions", FileReportColumns[1], Column::RightAlignment) << column("Missed Regions", FileReportColumns[2], Column::RightAlignment) << column("Cover", FileReportColumns[3], Column::RightAlignment) << column("Functions", FileReportColumns[4], Column::RightAlignment) << column("Missed Functions", FileReportColumns[5], Column::RightAlignment) << column("Executed", FileReportColumns[6], Column::RightAlignment) << column("Instantiations", FileReportColumns[7], Column::RightAlignment) << column("Missed Insts.", FileReportColumns[8], Column::RightAlignment) << column("Executed", FileReportColumns[9], Column::RightAlignment) << column("Lines", FileReportColumns[10], Column::RightAlignment) << column("Missed Lines", FileReportColumns[11], Column::RightAlignment) << column("Cover", FileReportColumns[12], Column::RightAlignment) << "\n"; renderDivider(FileReportColumns, OS); OS << "\n"; for (const FileCoverageSummary &FCS : FileReports) render(FCS, OS); renderDivider(FileReportColumns, OS); OS << "\n"; render(Totals, OS); } } // end namespace llvm