//===- 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 // -- Branches: array => List of Branches in the file // -- Branch: dict => Describes a branch of the file with counters // -- MCDC Records: array => List of MCDC records in the file // -- MCDC Values: array => List of T/F covered condition values // -- 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 // -- Branches: array => List of Branches in the expansion // -- Branch: dict => Describes a branch in expansion and counters // -- 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 // -- BranchCoverage: dict => Object summarizing branch coverage // -- MCDCCoverage: dict => Object summarizing MC/DC 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 // -- BranchCoverage: dict => Object summarizing branch coverage // -- MCDCCoverage: dict => Object summarizing MC/DC coverage // //===----------------------------------------------------------------------===// #include "CoverageExporterJson.h" #include "CoverageReport.h" #include "llvm/ADT/StringRef.h" #include "llvm/Support/JSON.h" #include "llvm/Support/ThreadPool.h" #include "llvm/Support/Threading.h" #include <algorithm> #include <limits> #include <mutex> #include <utility> /// The semantic version combined as a string. #define LLVM_COVERAGE_EXPORT_JSON_STR … /// Unique type identifier for JSON coverage export. #define LLVM_COVERAGE_EXPORT_JSON_TYPE_STR … usingnamespacellvm; namespace { // The JSON library accepts int64_t, but profiling counts are stored as uint64_t. // Therefore we need to explicitly convert from unsigned to signed, since a naive // cast is implementation-defined behavior when the unsigned value cannot be // represented as a signed value. We choose to clamp the values to preserve the // invariant that counts are always >= 0. int64_t clamp_uint64_to_int64(uint64_t u) { … } json::Array renderSegment(const coverage::CoverageSegment &Segment) { … } json::Array renderRegion(const coverage::CountedRegion &Region) { … } json::Array renderBranch(const coverage::CountedRegion &Region) { … } json::Array gatherConditions(const coverage::MCDCRecord &Record) { … } json::Array renderMCDCRecord(const coverage::MCDCRecord &Record) { … } json::Array renderRegions(ArrayRef<coverage::CountedRegion> Regions) { … } json::Array renderBranchRegions(ArrayRef<coverage::CountedRegion> Regions) { … } json::Array renderMCDCRecords(ArrayRef<coverage::MCDCRecord> Records) { … } std::vector<llvm::coverage::CountedRegion> collectNestedBranches(const coverage::CoverageMapping &Coverage, ArrayRef<llvm::coverage::ExpansionRecord> Expansions) { … } json::Object renderExpansion(const coverage::CoverageMapping &Coverage, const coverage::ExpansionRecord &Expansion) { … } json::Object renderSummary(const FileCoverageSummary &Summary) { … } json::Array renderFileExpansions(const coverage::CoverageMapping &Coverage, const coverage::CoverageData &FileCoverage, const FileCoverageSummary &FileReport) { … } json::Array renderFileSegments(const coverage::CoverageData &FileCoverage, const FileCoverageSummary &FileReport) { … } json::Array renderFileBranches(const coverage::CoverageData &FileCoverage, const FileCoverageSummary &FileReport) { … } json::Array renderFileMCDC(const coverage::CoverageData &FileCoverage, const FileCoverageSummary &FileReport) { … } json::Object renderFile(const coverage::CoverageMapping &Coverage, const std::string &Filename, const FileCoverageSummary &FileReport, const CoverageViewOptions &Options) { … } json::Array renderFiles(const coverage::CoverageMapping &Coverage, ArrayRef<std::string> SourceFiles, ArrayRef<FileCoverageSummary> FileReports, const CoverageViewOptions &Options) { … } json::Array renderFunctions( const iterator_range<coverage::FunctionRecordIterator> &Functions) { … } } // end anonymous namespace void CoverageExporterJson::renderRoot(const CoverageFilters &IgnoreFilters) { … } void CoverageExporterJson::renderRoot(ArrayRef<std::string> SourceFiles) { … }