| //===- CoverageExporterJson.cpp - Code coverage export --------------------===// |
| // |
| // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions. |
| // See https://llvm.org/LICENSE.txt for license information. |
| // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception |
| // |
| //===----------------------------------------------------------------------===// |
| // |
| // This file implements export of code coverage data to JSON. |
| // |
| //===----------------------------------------------------------------------===// |
| |
| //===----------------------------------------------------------------------===// |
| // |
| // The json code coverage export follows the following format |
| // Root: dict => Root Element containing metadata |
| // -- Data: array => Homogeneous array of one or more export objects |
| // -- Export: dict => Json representation of one CoverageMapping |
| // -- Files: array => List of objects describing coverage for files |
| // -- File: dict => Coverage for a single file |
| // -- Segments: array => List of Segments contained in the file |
| // -- Segment: dict => Describes a segment of the file with a counter |
| // -- Expansions: array => List of expansion records |
| // -- Expansion: dict => Object that descibes a single expansion |
| // -- CountedRegion: dict => The region to be expanded |
| // -- TargetRegions: array => List of Regions in the expansion |
| // -- CountedRegion: dict => Single Region in the expansion |
| // -- Summary: dict => Object summarizing the coverage for this file |
| // -- LineCoverage: dict => Object summarizing line coverage |
| // -- FunctionCoverage: dict => Object summarizing function coverage |
| // -- RegionCoverage: dict => Object summarizing region coverage |
| // -- Functions: array => List of objects describing coverage for functions |
| // -- Function: dict => Coverage info for a single function |
| // -- Filenames: array => List of filenames that the function relates to |
| // -- Summary: dict => Object summarizing the coverage for the entire binary |
| // -- LineCoverage: dict => Object summarizing line coverage |
| // -- FunctionCoverage: dict => Object summarizing function coverage |
| // -- InstantiationCoverage: dict => Object summarizing inst. coverage |
| // -- RegionCoverage: dict => Object summarizing region coverage |
| // |
| //===----------------------------------------------------------------------===// |
| |
| #include "CoverageExporterJson.h" |
| #include "CoverageReport.h" |
| #include "llvm/ADT/Optional.h" |
| #include "llvm/ADT/StringRef.h" |
| #include "llvm/Support/JSON.h" |
| #include "llvm/Support/ThreadPool.h" |
| #include "llvm/Support/Threading.h" |
| #include <algorithm> |
| #include <mutex> |
| #include <utility> |
| |
| /// The semantic version combined as a string. |
| #define LLVM_COVERAGE_EXPORT_JSON_STR "2.0.0" |
| |
| /// Unique type identifier for JSON coverage export. |
| #define LLVM_COVERAGE_EXPORT_JSON_TYPE_STR "llvm.coverage.json.export" |
| |
| using namespace llvm; |
| |
| namespace { |
| |
| json::Array renderSegment(const coverage::CoverageSegment &Segment) { |
| return json::Array({Segment.Line, Segment.Col, int64_t(Segment.Count), |
| Segment.HasCount, Segment.IsRegionEntry}); |
| } |
| |
| json::Array renderRegion(const coverage::CountedRegion &Region) { |
| return json::Array({Region.LineStart, Region.ColumnStart, Region.LineEnd, |
| Region.ColumnEnd, int64_t(Region.ExecutionCount), |
| Region.FileID, Region.ExpandedFileID, |
| int64_t(Region.Kind)}); |
| } |
| |
| json::Array renderRegions(ArrayRef<coverage::CountedRegion> Regions) { |
| json::Array RegionArray; |
| for (const auto &Region : Regions) |
| RegionArray.push_back(renderRegion(Region)); |
| return RegionArray; |
| } |
| |
| json::Object renderExpansion(const coverage::ExpansionRecord &Expansion) { |
| return json::Object( |
| {{"filenames", json::Array(Expansion.Function.Filenames)}, |
| // Mark the beginning and end of this expansion in the source file. |
| {"source_region", renderRegion(Expansion.Region)}, |
| // Enumerate the coverage information for the expansion. |
| {"target_regions", renderRegions(Expansion.Function.CountedRegions)}}); |
| } |
| |
| json::Object renderSummary(const FileCoverageSummary &Summary) { |
| return json::Object( |
| {{"lines", |
| json::Object({{"count", int64_t(Summary.LineCoverage.getNumLines())}, |
| {"covered", int64_t(Summary.LineCoverage.getCovered())}, |
| {"percent", Summary.LineCoverage.getPercentCovered()}})}, |
| {"functions", |
| json::Object( |
| {{"count", int64_t(Summary.FunctionCoverage.getNumFunctions())}, |
| {"covered", int64_t(Summary.FunctionCoverage.getExecuted())}, |
| {"percent", Summary.FunctionCoverage.getPercentCovered()}})}, |
| {"instantiations", |
| json::Object( |
| {{"count", |
| int64_t(Summary.InstantiationCoverage.getNumFunctions())}, |
| {"covered", int64_t(Summary.InstantiationCoverage.getExecuted())}, |
| {"percent", Summary.InstantiationCoverage.getPercentCovered()}})}, |
| {"regions", |
| json::Object( |
| {{"count", int64_t(Summary.RegionCoverage.getNumRegions())}, |
| {"covered", int64_t(Summary.RegionCoverage.getCovered())}, |
| {"notcovered", int64_t(Summary.RegionCoverage.getNumRegions() - |
| Summary.RegionCoverage.getCovered())}, |
| {"percent", Summary.RegionCoverage.getPercentCovered()}})}}); |
| } |
| |
| json::Array renderFileExpansions(const coverage::CoverageData &FileCoverage, |
| const FileCoverageSummary &FileReport) { |
| json::Array ExpansionArray; |
| for (const auto &Expansion : FileCoverage.getExpansions()) |
| ExpansionArray.push_back(renderExpansion(Expansion)); |
| return ExpansionArray; |
| } |
| |
| json::Array renderFileSegments(const coverage::CoverageData &FileCoverage, |
| const FileCoverageSummary &FileReport) { |
| json::Array SegmentArray; |
| for (const auto &Segment : FileCoverage) |
| SegmentArray.push_back(renderSegment(Segment)); |
| return SegmentArray; |
| } |
| |
| json::Object renderFile(const coverage::CoverageMapping &Coverage, |
| const std::string &Filename, |
| const FileCoverageSummary &FileReport, |
| const CoverageViewOptions &Options) { |
| json::Object File({{"filename", Filename}}); |
| if (!Options.ExportSummaryOnly) { |
| // Calculate and render detailed coverage information for given file. |
| auto FileCoverage = Coverage.getCoverageForFile(Filename); |
| File["segments"] = renderFileSegments(FileCoverage, FileReport); |
| if (!Options.SkipExpansions) { |
| File["expansions"] = renderFileExpansions(FileCoverage, FileReport); |
| } |
| } |
| File["summary"] = renderSummary(FileReport); |
| return File; |
| } |
| |
| json::Array renderFiles(const coverage::CoverageMapping &Coverage, |
| ArrayRef<std::string> SourceFiles, |
| ArrayRef<FileCoverageSummary> FileReports, |
| const CoverageViewOptions &Options) { |
| auto NumThreads = Options.NumThreads; |
| if (NumThreads == 0) { |
| NumThreads = std::max(1U, std::min(llvm::heavyweight_hardware_concurrency(), |
| unsigned(SourceFiles.size()))); |
| } |
| ThreadPool Pool(NumThreads); |
| json::Array FileArray; |
| std::mutex FileArrayMutex; |
| |
| for (unsigned I = 0, E = SourceFiles.size(); I < E; ++I) { |
| auto &SourceFile = SourceFiles[I]; |
| auto &FileReport = FileReports[I]; |
| Pool.async([&] { |
| auto File = renderFile(Coverage, SourceFile, FileReport, Options); |
| { |
| std::lock_guard<std::mutex> Lock(FileArrayMutex); |
| FileArray.push_back(std::move(File)); |
| } |
| }); |
| } |
| Pool.wait(); |
| return FileArray; |
| } |
| |
| json::Array renderFunctions( |
| const iterator_range<coverage::FunctionRecordIterator> &Functions) { |
| json::Array FunctionArray; |
| for (const auto &F : Functions) |
| FunctionArray.push_back( |
| json::Object({{"name", F.Name}, |
| {"count", int64_t(F.ExecutionCount)}, |
| {"regions", renderRegions(F.CountedRegions)}, |
| {"filenames", json::Array(F.Filenames)}})); |
| return FunctionArray; |
| } |
| |
| } // end anonymous namespace |
| |
| void CoverageExporterJson::renderRoot(const CoverageFilters &IgnoreFilters) { |
| std::vector<std::string> SourceFiles; |
| for (StringRef SF : Coverage.getUniqueSourceFiles()) { |
| if (!IgnoreFilters.matchesFilename(SF)) |
| SourceFiles.emplace_back(SF); |
| } |
| renderRoot(SourceFiles); |
| } |
| |
| void CoverageExporterJson::renderRoot(ArrayRef<std::string> SourceFiles) { |
| FileCoverageSummary Totals = FileCoverageSummary("Totals"); |
| auto FileReports = CoverageReport::prepareFileReports(Coverage, Totals, |
| SourceFiles, Options); |
| auto Files = renderFiles(Coverage, SourceFiles, FileReports, Options); |
| // Sort files in order of their names. |
| std::sort(Files.begin(), Files.end(), |
| [](const json::Value &A, const json::Value &B) { |
| const json::Object *ObjA = A.getAsObject(); |
| const json::Object *ObjB = B.getAsObject(); |
| assert(ObjA != nullptr && "Value A was not an Object"); |
| assert(ObjB != nullptr && "Value B was not an Object"); |
| const StringRef FilenameA = ObjA->getString("filename").getValue(); |
| const StringRef FilenameB = ObjB->getString("filename").getValue(); |
| return FilenameA.compare(FilenameB) < 0; |
| }); |
| auto Export = json::Object( |
| {{"files", std::move(Files)}, {"totals", renderSummary(Totals)}}); |
| // Skip functions-level information if necessary. |
| if (!Options.ExportSummaryOnly && !Options.SkipFunctions) |
| Export["functions"] = renderFunctions(Coverage.getCoveredFunctions()); |
| |
| auto ExportArray = json::Array({std::move(Export)}); |
| |
| OS << json::Object({{"version", LLVM_COVERAGE_EXPORT_JSON_STR}, |
| {"type", LLVM_COVERAGE_EXPORT_JSON_TYPE_STR}, |
| {"data", std::move(ExportArray)}}); |
| } |