如何检查cobertura.xml文件的代码/测试覆盖率是否高于指定的阈值?

c#

我有一个包含多个项目和多个测试项目的 .Net 5 解决方案。我想确保测试涵盖所有内容或指定的百分比值(例如 80%)。我正在使用 xUnit 进行测试,并根据文档创建了以下 Powershell 脚本

https://docs.microsoft.com/en-us/dotnet/core/testing/unit-testing-code-coverage?tabs=windows#generate-reports

dotnet test --collect:"XPlat Code Coverage";

reportgenerator -reports:'**/coverage.cobertura.xml' -targetdir:'CoverageReports' -reporttypes:'Cobertura';

[XML]$report = Get-Content CoverageReports/Cobertura.xml

if($report.coverage.'line-rate' -ge 20)
{
    Write-Host "greater or equal than 20"
}
else
{
    Write-Host "less than 20"
}

Read-Host -Prompt 'done'

执行以下操作

  • 它运行测试并为每个测试项目创建一个cobertura文件
  • 它将每个cobertura文件合并为一个文件并将其放入CoverageReports目录中
  • 它解析 .xml 文件

现在我可以访问覆盖信息,例如线路速率。而不是虚拟 if 语句,我怎样才能实现以下示例?

if($report.coverage.percentage -lt 80)
{
    Write-Host "Coverage is less than 80 percent"
}

作为奖励,我可以写下尚未涵盖的内容列表。


这是从虚拟项目生成的 Cobertura.xml 文件的内容

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE coverage SYSTEM "http://cobertura.sourceforge.net/xml/coverage-04.dtd">
<coverage line-rate="1" branch-rate="1" lines-covered="4" lines-valid="4" branches-covered="0" branches-valid="0" complexity="4" version="0" timestamp="1627911309">
  <sources>
    <source>C:</source>
  </sources>
  <packages>
    <package name="ClassLibrary1" line-rate="1" branch-rate="1" complexity="3">
      <classes>
        <class name="ClassLibrary1.BoolReturner" filename="C:...ClassLibrary1BoolReturner.cs" line-rate="1" branch-rate="1" complexity="3">
          <methods>
            <method name="Get" signature="(...)" line-rate="1" branch-rate="1" complexity="1">
              <lines>
                <line number="5" hits="3" branch="false" />
              </lines>
            </method>
            <method name="GetFalse" signature="()" line-rate="1" branch-rate="1" complexity="1">
              <lines>
                <line number="6" hits="1" branch="false" />
              </lines>
            </method>
            <method name="X" signature="()" line-rate="1" branch-rate="1" complexity="1">
              <lines>
                <line number="7" hits="1" branch="false" />
              </lines>
            </method>
          </methods>
          <lines>
            <line number="5" hits="3" branch="false" />
            <line number="6" hits="1" branch="false" />
            <line number="7" hits="1" branch="false" />
          </lines>
        </class>
      </classes>
    </package>
    <package name="ClassLibrary2" line-rate="1" branch-rate="1" complexity="1">
      <classes>
        <class name="ClassLibrary2.StringCombiner" filename="C:...StringCombiner.cs" line-rate="1" branch-rate="1" complexity="1">
          <methods>
            <method name="Combine" signature="(...)" line-rate="1" branch-rate="1" complexity="1">
              <lines>
                <line number="7" hits="2" branch="false" />
              </lines>
            </method>
          </methods>
          <lines>
            <line number="7" hits="2" branch="false" />
          </lines>
        </class>
      </classes>
    </package>
  </packages>
</coverage>

回答

Cobertura 报告将线路覆盖信息作为“线路速率”属性提供。它包含 0 到 1 范围内的值(1 表示 100%)。属性“线路速率”在不同级别定义:对于整个报告 -coverage根元素;对于特定组件 -package元素;对于特定的类 -class元素等。

如果目标是检查整个报告(整个代码库)的代码覆盖率,这可以通过流动的代码片段来实现

[XML]$report = Get-Content CoverageReports/Cobertura.xml

if ($report.coverage.'line-rate' -lt 0.8) {
  Write-Host "Coverage is less than 80 percent"
}

如果应该更有选择性地检查代码覆盖率百分比,例如在类级别,那么代码片段可能如下

[XML]$report = Get-Content CoverageReports/Cobertura.xml

# Select all rows with line-rate < 0.8 (80%).
$classes = $report.SelectNodes('//class[@line-rate < 0.8]');

# Check number of selected rows.
if ($classes.Count -gt 0) {
  Write-Host "Coverage is less than 80 percent"

  #Write list of files with low coverage.
  $classes | Sort-Object -Property 'line-rate' | Format-Table -Property 'line-rate', filename
}

在此示例中,使用XPath表达式选择低覆盖率的类列表//class[@line-rate < 0.8]。它选择属性值小于 0.8 (80%) 的所有class元素line-rate


另外,当需要更复杂的数据分析时,可以代替XPath,直接在PS代码中编写类似的逻辑,例如

[XML]$report = Get-Content CoverageReports/Cobertura.xml

$classes = $report.SelectNodes('//class');
$lowCoverage = $false;

foreach($class in $classes){

  # Convert line-rate value to 0..100% range.
  $percentage = [int](100.0 * [double]$class.'line-rate');

  if ($percentage -lt 80) {
    Write-Host $class.filename " [$percentage%]"
    $lowCoverage = $true;
  }
}

if ($lowCoverage) {
  Write-Host "Coverage is less than 80 percent"
}

高级 XML 处理技术可以在ForEach in XML file with PowerShell问题的答案中找到


以上是如何检查cobertura.xml文件的代码/测试覆盖率是否高于指定的阈值?的全部内容。
THE END
分享
二维码
< <上一篇
下一篇>>