//===- SourceCoverageView.cpp - Code coverage view for source code --------===// // // The LLVM Compiler Infrastructure // // This file is distributed under the University of Illinois Open Source // License. See LICENSE.TXT for details. // //===----------------------------------------------------------------------===// /// /// \file This class implements rendering for code coverage of source code. /// //===----------------------------------------------------------------------===// #include "SourceCoverageView.h" #include "SourceCoverageViewHTML.h" #include "SourceCoverageViewText.h" #include "llvm/ADT/SmallString.h" #include "llvm/ADT/StringExtras.h" #include "llvm/Support/FileSystem.h" #include "llvm/Support/LineIterator.h" #include "llvm/Support/Path.h" using namespace llvm; void CoveragePrinter::StreamDestructor::operator()(raw_ostream *OS) const { if (OS == &outs()) return; delete OS; } std::string CoveragePrinter::getOutputPath(StringRef Path, StringRef Extension, bool InToplevel, bool Relative) const { assert(Extension.size() && "The file extension may not be empty"); SmallString<256> FullPath; if (!Relative) FullPath.append(Opts.ShowOutputDirectory); if (!InToplevel) sys::path::append(FullPath, getCoverageDir()); SmallString<256> ParentPath = sys::path::parent_path(Path); sys::path::remove_dots(ParentPath, /*remove_dot_dots=*/true); sys::path::append(FullPath, sys::path::relative_path(ParentPath)); auto PathFilename = (sys::path::filename(Path) + "." + Extension).str(); sys::path::append(FullPath, PathFilename); sys::path::native(FullPath); return FullPath.str(); } Expected CoveragePrinter::createOutputStream(StringRef Path, StringRef Extension, bool InToplevel) const { if (!Opts.hasOutputDirectory()) return OwnedStream(&outs()); std::string FullPath = getOutputPath(Path, Extension, InToplevel, false); auto ParentDir = sys::path::parent_path(FullPath); if (auto E = sys::fs::create_directories(ParentDir)) return errorCodeToError(E); std::error_code E; raw_ostream *RawStream = new raw_fd_ostream(FullPath, E, sys::fs::F_RW); auto OS = CoveragePrinter::OwnedStream(RawStream); if (E) return errorCodeToError(E); return std::move(OS); } std::unique_ptr CoveragePrinter::create(const CoverageViewOptions &Opts) { switch (Opts.Format) { case CoverageViewOptions::OutputFormat::Text: return llvm::make_unique(Opts); case CoverageViewOptions::OutputFormat::HTML: return llvm::make_unique(Opts); } llvm_unreachable("Unknown coverage output format!"); } unsigned SourceCoverageView::getFirstUncoveredLineNo() { auto CheckIfUncovered = [](const coverage::CoverageSegment &S) { return S.HasCount && S.Count == 0; }; // L is less than R if (1) it's an uncovered segment (has a 0 count), and (2) // either R is not an uncovered segment, or L has a lower line number than R. const auto MinSegIt = std::min_element(CoverageInfo.begin(), CoverageInfo.end(), [CheckIfUncovered](const coverage::CoverageSegment &L, const coverage::CoverageSegment &R) { return (CheckIfUncovered(L) && (!CheckIfUncovered(R) || (L.Line < R.Line))); }); if (CheckIfUncovered(*MinSegIt)) return (*MinSegIt).Line; // There is no uncovered line, return zero. return 0; } std::string SourceCoverageView::formatCount(uint64_t N) { std::string Number = utostr(N); int Len = Number.size(); if (Len <= 3) return Number; int IntLen = Len % 3 == 0 ? 3 : Len % 3; std::string Result(Number.data(), IntLen); if (IntLen != 3) { Result.push_back('.'); Result += Number.substr(IntLen, 3 - IntLen); } Result.push_back(" kMGTPEZY"[(Len - 1) / 3]); return Result; } bool SourceCoverageView::shouldRenderRegionMarkers( bool LineHasMultipleRegions) const { return getOptions().ShowRegionMarkers && (!getOptions().ShowLineStatsOrRegionMarkers || LineHasMultipleRegions); } bool SourceCoverageView::hasSubViews() const { return !ExpansionSubViews.empty() || !InstantiationSubViews.empty(); } std::unique_ptr SourceCoverageView::create(StringRef SourceName, const MemoryBuffer &File, const CoverageViewOptions &Options, coverage::CoverageData &&CoverageInfo) { switch (Options.Format) { case CoverageViewOptions::OutputFormat::Text: return llvm::make_unique( SourceName, File, Options, std::move(CoverageInfo)); case CoverageViewOptions::OutputFormat::HTML: return llvm::make_unique( SourceName, File, Options, std::move(CoverageInfo)); } llvm_unreachable("Unknown coverage output format!"); } std::string SourceCoverageView::getSourceName() const { SmallString<128> SourceText(SourceName); sys::path::remove_dots(SourceText, /*remove_dot_dots=*/true); sys::path::native(SourceText); return SourceText.str(); } std::string SourceCoverageView::getVerboseSourceName() const { return getSourceName() + " (Binary: " + sys::path::filename(getOptions().ObjectFilename).str() + ")"; } void SourceCoverageView::addExpansion( const coverage::CounterMappingRegion &Region, std::unique_ptr View) { ExpansionSubViews.emplace_back(Region, std::move(View)); } void SourceCoverageView::addInstantiation( StringRef FunctionName, unsigned Line, std::unique_ptr View) { InstantiationSubViews.emplace_back(FunctionName, Line, std::move(View)); } void SourceCoverageView::print(raw_ostream &OS, bool WholeFile, bool ShowSourceName, unsigned ViewDepth) { if (WholeFile && getOptions().hasOutputDirectory()) renderTitle(OS, "Coverage Report"); renderViewHeader(OS); if (ShowSourceName) renderSourceName(OS, WholeFile); renderTableHeader(OS, (ViewDepth > 0) ? 0 : getFirstUncoveredLineNo(), ViewDepth); // We need the expansions and instantiations sorted so we can go through them // while we iterate lines. std::sort(ExpansionSubViews.begin(), ExpansionSubViews.end()); std::sort(InstantiationSubViews.begin(), InstantiationSubViews.end()); auto NextESV = ExpansionSubViews.begin(); auto EndESV = ExpansionSubViews.end(); auto NextISV = InstantiationSubViews.begin(); auto EndISV = InstantiationSubViews.end(); // Get the coverage information for the file. auto NextSegment = CoverageInfo.begin(); auto EndSegment = CoverageInfo.end(); unsigned FirstLine = NextSegment != EndSegment ? NextSegment->Line : 0; const coverage::CoverageSegment *WrappedSegment = nullptr; SmallVector LineSegments; for (line_iterator LI(File, /*SkipBlanks=*/false); !LI.is_at_eof(); ++LI) { // If we aren't rendering the whole file, we need to filter out the prologue // and epilogue. if (!WholeFile) { if (NextSegment == EndSegment) break; else if (LI.line_number() < FirstLine) continue; } // Collect the coverage information relevant to this line. if (LineSegments.size()) WrappedSegment = LineSegments.back(); LineSegments.clear(); while (NextSegment != EndSegment && NextSegment->Line == LI.line_number()) LineSegments.push_back(&*NextSegment++); // Calculate a count to be for the line as a whole. LineCoverageStats LineCount; if (WrappedSegment && WrappedSegment->HasCount) LineCount.addRegionCount(WrappedSegment->Count); for (const auto *S : LineSegments) if (S->HasCount && S->IsRegionEntry) LineCount.addRegionStartCount(S->Count); renderLinePrefix(OS, ViewDepth); if (getOptions().ShowLineNumbers) renderLineNumberColumn(OS, LI.line_number()); if (getOptions().ShowLineStats) renderLineCoverageColumn(OS, LineCount); // If there are expansion subviews, we want to highlight the first one. unsigned ExpansionColumn = 0; if (NextESV != EndESV && NextESV->getLine() == LI.line_number() && getOptions().Colors) ExpansionColumn = NextESV->getStartCol(); // Display the source code for the current line. renderLine(OS, {*LI, LI.line_number()}, WrappedSegment, LineSegments, ExpansionColumn, ViewDepth); // Show the region markers. if (shouldRenderRegionMarkers(LineCount.hasMultipleRegions())) renderRegionMarkers(OS, LineSegments, ViewDepth); // Show the expansions and instantiations for this line. bool RenderedSubView = false; for (; NextESV != EndESV && NextESV->getLine() == LI.line_number(); ++NextESV) { renderViewDivider(OS, ViewDepth + 1); // Re-render the current line and highlight the expansion range for // this subview. if (RenderedSubView) { ExpansionColumn = NextESV->getStartCol(); renderExpansionSite(OS, {*LI, LI.line_number()}, WrappedSegment, LineSegments, ExpansionColumn, ViewDepth); renderViewDivider(OS, ViewDepth + 1); } renderExpansionView(OS, *NextESV, ViewDepth + 1); RenderedSubView = true; } for (; NextISV != EndISV && NextISV->Line == LI.line_number(); ++NextISV) { renderViewDivider(OS, ViewDepth + 1); renderInstantiationView(OS, *NextISV, ViewDepth + 1); RenderedSubView = true; } if (RenderedSubView) renderViewDivider(OS, ViewDepth + 1); renderLineSuffix(OS, ViewDepth); } renderViewFooter(OS); }