From f33badde1704c4a5642d0d37cf0007d9e0ac814f Mon Sep 17 00:00:00 2001 From: Matt Carvin <90224411+mcarvin8@users.noreply.github.com> Date: Mon, 16 Dec 2024 17:00:10 -0500 Subject: [PATCH] feat: add support for cobertura format --- .husky/commit-msg | 3 - .husky/pre-commit | 3 - .husky/pre-push | 3 - README.md | 118 ++++++++++++-- messages/transformer.transform.md | 4 + package.json | 5 +- src/commands/acc-transformer/transform.ts | 13 +- src/helpers/setCoveredLinesCobertura.ts | 45 ++++++ ...overedLines.ts => setCoveredLinesSonar.ts} | 2 +- src/helpers/transformDeployCoverageReport.ts | 149 +++++++++++++---- src/helpers/transformTestCoverageReport.ts | 153 ++++++++++++++---- src/helpers/types.ts | 47 ++++++ src/hooks/postrun.ts | 3 + 13 files changed, 461 insertions(+), 87 deletions(-) create mode 100644 src/helpers/setCoveredLinesCobertura.ts rename src/helpers/{setCoveredLines.ts => setCoveredLinesSonar.ts} (96%) diff --git a/.husky/commit-msg b/.husky/commit-msg index a770f4b..564449e 100644 --- a/.husky/commit-msg +++ b/.husky/commit-msg @@ -1,4 +1 @@ -#!/bin/sh -. "$(dirname "$0")/_/husky.sh" - yarn commitlint --edit \ No newline at end of file diff --git a/.husky/pre-commit b/.husky/pre-commit index ffafe6a..2919583 100644 --- a/.husky/pre-commit +++ b/.husky/pre-commit @@ -1,4 +1 @@ -#!/bin/sh -. "$(dirname "$0")/_/husky.sh" - yarn lint && yarn pretty-quick --staged && yarn build \ No newline at end of file diff --git a/.husky/pre-push b/.husky/pre-push index 09c3243..15ec4f6 100644 --- a/.husky/pre-push +++ b/.husky/pre-push @@ -1,4 +1 @@ -#!/bin/sh -. "$(dirname "$0")/_/husky.sh" - yarn build \ No newline at end of file diff --git a/README.md b/README.md index 031173f..e7c4066 100644 --- a/README.md +++ b/README.md @@ -18,7 +18,7 @@ - [License](#license) </details> -A Salesforce CLI plugin to transform the Apex code coverage JSON files created during deployments and test runs into the generic test coverage format (XML) accepted by SonarQube. +A Salesforce CLI plugin to transform the Apex code coverage JSON files created during deployments and test runs into SonarQube format or Cobertura format. ## Install @@ -28,14 +28,16 @@ sf plugins install apex-code-coverage-transformer@x.y.z ## Who is the Plugin For? -This plugin is intended for users who deploy their Apex codebase (Apex classes and triggers) from any Salesforce DX repository (`sfdx-project.json` file), not just git-based ones. You should be running this plugin somewhere inside your Salesforce DX repository (root folder preferred). This plugin searches for your repository's `sfdx-project.json` file to know which package directories to search into. Since SonarQube relies on file-paths to map code coverage to the files in their explorer interface, the Apex files must be found in one of your package directories. +This plugin is intended for users who deploy their Apex codebase (Apex classes and triggers) from any Salesforce DX repository (`sfdx-project.json` file), not just git-based ones. You should be running this plugin somewhere inside your Salesforce DX repository (root folder preferred). This plugin searches for your repository's `sfdx-project.json` file to know which package directories to search into. The Apex files must be found in one of your package directories. -This plugin will work if you run local tests or run all tests in an org, including tests that originate from installed managed and unlocked packages. Since files from managed and unlocked packages aren't retrieved into Salesforce DX repositories, these files cannot be included in your SonarQube scans. +This plugin will work if you run local tests or run all tests in an org, including tests that originate from installed managed and unlocked packages. Since files from managed and unlocked packages aren't retrieved into Salesforce DX repositories, these files cannot be included in your code coverage reports. -When the plugin is unable to find the Apex file from the coverage report in your repository, it will print a warning and not add that file's coverage data to the coverage XML created by this plugin. A warning will be printed for each file not found in a package directory in your repository. See [Errors and Warnings](https://github.com/mcarvin8/apex-code-coverage-transformer?tab=readme-ov-file#errors-and-warnings) for more information. +When the plugin is unable to find the Apex file from the Salesforce CLI coverage report in your repository, it will print a warning and not add that file's coverage data to the coverage XML created by this plugin. A warning will be printed for each file not found in a package directory in your repository. See [Errors and Warnings](https://github.com/mcarvin8/apex-code-coverage-transformer?tab=readme-ov-file#errors-and-warnings) for more information. ## Creating Code Coverage Files with the Salesforce CLI +**This tool will only support the JSON coverage format from the Salesforce CLI. Do not use "json-summary" or Salesforce's cobertura output.** + To create the code coverage JSON during a Salesforce CLI deployment/validation, append `--coverage-formatters json --results-dir "coverage"` to the `sf project deploy` command. This will create a coverage JSON in this relative path - `coverage/coverage/coverage.json`. ``` @@ -49,7 +51,7 @@ sf apex run test --code-coverage --result-format json --output-dir "coverage" sf apex get test --test-run-id <test run id> --code-coverage --result-format json --output-dir "coverage" ``` -The code coverage JSONs created by the Salesforce CLI aren't accepted by SonarQube automatically for Salesforce DX repositories and needs to be converted using this plugin. +The code coverage JSONs created by the Salesforce CLI aren't accepted automatically for Salesforce DX repositories and needs to be converted using this plugin. **Disclaimer**: Due to existing bugs with how the Salesforce CLI reports covered lines during deployments (see [5511](https://github.com/forcedotcom/salesforcedx-vscode/issues/5511) and [1568](https://github.com/forcedotcom/cli/issues/1568)), to add support for covered lines in this plugin for deployment coverage files, I had to add a function to re-number out-of-range covered lines the CLI may report (ex: line 100 in a 98-line Apex Class is reported back as covered by the Salesforce CLI deploy command). Salesforce's coverage result may also include extra lines as covered (ex: 120 lines are included in the coverage report for a 100 line file), so the coverage percentage may vary based on how many lines the API returns in the coverage report. Once Salesforce fixes the API to correctly return covered lines in the deploy command, this function will be removed. @@ -63,20 +65,22 @@ The `apex-code-coverage-transformer` has 1 command: ``` USAGE - $ sf acc-transformer transform -j <value> -x <value> [--json] + $ sf acc-transformer transform -j <value> -x <value> -f <value> [--json] FLAGS -j, --coverage-json=<value> Path to the code coverage JSON file created by the Salesforce CLI deployment or test command. - -x, --xml=<value> [default: "coverage.xml"] Path to code coverage XML file that will be created by this plugin. + -x, --xml=<value> [default: "coverage.xml"] Path to code coverage XML file that will be created by this plugin. + -f, --format=<value> [default: "sonar"] Output format for the code coverage format. + Valid options are "sonar" or "cobertura". GLOBAL FLAGS --json Format output as json. DESCRIPTION - This plugin will convert the code coverage JSON file created by the Salesforce CLI during Apex deployments and test runs into an XML accepted by tools like SonarQube. + This plugin will convert the code coverage JSON file created by the Salesforce CLI during Apex deployments and test runs into SonarQube or Cobertura format. EXAMPLES - $ sf acc-transformer transform -j "coverage.json" -x "coverage.xml" + $ sf acc-transformer transform -j "coverage.json" -x "coverage.xml" -f "sonar" ``` ## Hook @@ -93,13 +97,15 @@ The `.apexcodecovtransformer.config.json` should look like this: { "deployCoverageJsonPath": "coverage/coverage/coverage.json", "testCoverageJsonPath": "coverage/test-coverage.json", - "coverageXmlPath": "coverage.xml" + "coverageXmlPath": "coverage.xml", + "format": "sonar" } ``` - `deployCoverageJsonPath` is required to use the hook after deployments and should be the path to the code coverage JSON created by the Salesforce CLI deployment command. Recommend using a relative path. - `testCoverageJsonPath` is required to use the hook after test runs and should be the path to the code coverage JSON created by the Salesforce CLI test command. Recommend using a relative path. - `coverageXmlPath` is optional and should be the path to the code coverage XML created by this plugin. Recommend using a relative path. If this isn't provided, it will default to `coverage.xml` in the working directory. +- `format` is optional and should be the intended output format for the code coverage XML created by this plugin. Options are "sonar" or "cobertura". If this isn't provided, it will default to "sonar". If the `.apexcodecovtransformer.config.json` file isn't found, the hook will be skipped. @@ -141,7 +147,7 @@ Error (1): ENOENT: no such file or directory: {packageDirPath} ## Example -This [code coverage JSON file](https://raw.githubusercontent.com/mcarvin8/apex-code-coverage-transformer/main/test/deploy_coverage_no_file_exts.json) created during a Salesforce CLI deployment will be transformed into: +This [code coverage JSON file](https://raw.githubusercontent.com/mcarvin8/apex-code-coverage-transformer/main/test/deploy_coverage_no_file_exts.json) created during a Salesforce CLI deployment will be transformed into this format for SonarQube: ```xml <?xml version="1.0"?> @@ -215,6 +221,96 @@ This [code coverage JSON file](https://raw.githubusercontent.com/mcarvin8/apex-c </coverage> ``` +and this format for Cobertura: + +```xml +<?xml version="1.0" ?> +<!DOCTYPE coverage SYSTEM "http://cobertura.sourceforge.net/xml/coverage-04.dtd"> +<coverage lines-valid="62" lines-covered="54" line-rate="0.871" branches-valid="0" branches-covered="0" branch-rate="1" timestamp="1734405832938" complexity="0" version="0.1"> + <sources> + <source>.</source> + </sources> + <packages> + <package name="main" line-rate="0.871" branch-rate="1"> + <classes> + <class name="AccountTrigger" filename="test/baselines/triggers/AccountTrigger.trigger" line-rate="0.8710" branch-rate="1"> + <methods/> + <lines> + <line number="52" hits="0" branch="false"/> + <line number="53" hits="0" branch="false"/> + <line number="59" hits="0" branch="false"/> + <line number="60" hits="0" branch="false"/> + <line number="1" hits="1" branch="false"/> + <line number="2" hits="1" branch="false"/> + <line number="3" hits="1" branch="false"/> + <line number="4" hits="1" branch="false"/> + <line number="5" hits="1" branch="false"/> + <line number="6" hits="1" branch="false"/> + <line number="7" hits="1" branch="false"/> + <line number="8" hits="1" branch="false"/> + <line number="9" hits="1" branch="false"/> + <line number="10" hits="1" branch="false"/> + <line number="11" hits="1" branch="false"/> + <line number="12" hits="1" branch="false"/> + <line number="13" hits="1" branch="false"/> + <line number="14" hits="1" branch="false"/> + <line number="15" hits="1" branch="false"/> + <line number="16" hits="1" branch="false"/> + <line number="17" hits="1" branch="false"/> + <line number="18" hits="1" branch="false"/> + <line number="19" hits="1" branch="false"/> + <line number="20" hits="1" branch="false"/> + <line number="21" hits="1" branch="false"/> + <line number="22" hits="1" branch="false"/> + <line number="23" hits="1" branch="false"/> + <line number="24" hits="1" branch="false"/> + <line number="25" hits="1" branch="false"/> + <line number="26" hits="1" branch="false"/> + <line number="27" hits="1" branch="false"/> + </lines> + </class> + <class name="AccountProfile" filename="test/baselines/classes/AccountProfile.cls" line-rate="0.8710" branch-rate="1"> + <methods/> + <lines> + <line number="52" hits="0" branch="false"/> + <line number="53" hits="0" branch="false"/> + <line number="59" hits="0" branch="false"/> + <line number="60" hits="0" branch="false"/> + <line number="54" hits="1" branch="false"/> + <line number="55" hits="1" branch="false"/> + <line number="56" hits="1" branch="false"/> + <line number="57" hits="1" branch="false"/> + <line number="58" hits="1" branch="false"/> + <line number="61" hits="1" branch="false"/> + <line number="62" hits="1" branch="false"/> + <line number="63" hits="1" branch="false"/> + <line number="64" hits="1" branch="false"/> + <line number="65" hits="1" branch="false"/> + <line number="66" hits="1" branch="false"/> + <line number="67" hits="1" branch="false"/> + <line number="68" hits="1" branch="false"/> + <line number="69" hits="1" branch="false"/> + <line number="70" hits="1" branch="false"/> + <line number="71" hits="1" branch="false"/> + <line number="72" hits="1" branch="false"/> + <line number="1" hits="1" branch="false"/> + <line number="2" hits="1" branch="false"/> + <line number="3" hits="1" branch="false"/> + <line number="4" hits="1" branch="false"/> + <line number="5" hits="1" branch="false"/> + <line number="6" hits="1" branch="false"/> + <line number="7" hits="1" branch="false"/> + <line number="8" hits="1" branch="false"/> + <line number="9" hits="1" branch="false"/> + <line number="10" hits="1" branch="false"/> + </lines> + </class> + </classes> + </package> + </packages> +</coverage> +``` + ## Issues If you encounter any issues, please create an issue in the repository's [issue tracker](https://github.com/mcarvin8/apex-code-coverage-transformer/issues). Please also create issues to suggest any new features. diff --git a/messages/transformer.transform.md b/messages/transformer.transform.md index 2ac2bbe..239eeef 100644 --- a/messages/transformer.transform.md +++ b/messages/transformer.transform.md @@ -17,3 +17,7 @@ Path to the code coverage JSON file created by the Salesforce CLI deployment or # flags.xml.summary Path to code coverage XML file that will be created by this plugin. + +# flags.format.summary + +Output format for the coverage report. diff --git a/package.json b/package.json index 5963760..79bde0d 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "apex-code-coverage-transformer", - "description": "Transforms the Apex code coverage JSON created during Salesforce deployments and test runs into the Generic Test Coverage Format (XML) for SonarQube.", + "description": "Transforms the Apex code coverage JSON created during Salesforce deployments and test runs into SonarQube or Cobertura format.", "version": "2.2.1", "dependencies": { "@oclif/core": "^4.0.37", @@ -45,7 +45,8 @@ "sonarqube", "apex", "coverage", - "git" + "git", + "cobertura" ], "license": "MIT", "oclif": { diff --git a/src/commands/acc-transformer/transform.ts b/src/commands/acc-transformer/transform.ts index ee1fff0..d8ce949 100644 --- a/src/commands/acc-transformer/transform.ts +++ b/src/commands/acc-transformer/transform.ts @@ -32,12 +32,21 @@ export default class TransformerTransform extends SfCommand<TransformerTransform exists: false, default: 'coverage.xml', }), + format: Flags.string({ + summary: messages.getMessage('flags.format.summary'), + char: 'f', + required: true, + multiple: false, + default: 'sonar', + options: ['sonar', 'cobertura'], + }), }; public async run(): Promise<TransformerTransformResult> { const { flags } = await this.parse(TransformerTransform); const jsonFilePath = resolve(flags['coverage-json']); const xmlFilePath = resolve(flags['xml']); + const format = flags['format']; const jsonData = await readFile(jsonFilePath, 'utf-8'); let xmlData: string; @@ -48,12 +57,12 @@ export default class TransformerTransform extends SfCommand<TransformerTransform // Determine the type of coverage data using type guards if (commandType === 'TestCoverageData') { - const result = await transformTestCoverageReport(parsedData as TestCoverageData[]); + const result = await transformTestCoverageReport(parsedData as TestCoverageData[], format); xmlData = result.xml; warnings = result.warnings; filesProcessed = result.filesProcessed; } else if (commandType === 'DeployCoverageData') { - const result = await transformDeployCoverageReport(parsedData as DeployCoverageData); + const result = await transformDeployCoverageReport(parsedData as DeployCoverageData, format); xmlData = result.xml; warnings = result.warnings; filesProcessed = result.filesProcessed; diff --git a/src/helpers/setCoveredLinesCobertura.ts b/src/helpers/setCoveredLinesCobertura.ts new file mode 100644 index 0000000..0ecfd60 --- /dev/null +++ b/src/helpers/setCoveredLinesCobertura.ts @@ -0,0 +1,45 @@ +'use strict'; + +import { join } from 'node:path'; + +import { getTotalLines } from './getTotalLines.js'; +import { CoberturaClass, CoberturaLine } from './types.js'; + +export async function setCoveredLinesCobertura( + coveredLines: number[], + uncoveredLines: number[], + repoRoot: string, + filePath: string, + classObj: CoberturaClass +): Promise<void> { + const randomLines: number[] = []; + const totalLines = await getTotalLines(join(repoRoot, filePath)); + + for (const coveredLine of coveredLines) { + if (coveredLine > totalLines) { + for (let randomLineNumber = 1; randomLineNumber <= totalLines; randomLineNumber++) { + if ( + !uncoveredLines.includes(randomLineNumber) && + !coveredLines.includes(randomLineNumber) && + !randomLines.includes(randomLineNumber) + ) { + const randomLine: CoberturaLine = { + '@number': randomLineNumber, + '@hits': 1, + '@branch': 'false', + }; + classObj.lines.line.push(randomLine); + randomLines.push(randomLineNumber); + break; + } + } + } else { + const coveredLineObj: CoberturaLine = { + '@number': coveredLine, + '@hits': 1, + '@branch': 'false', + }; + classObj.lines.line.push(coveredLineObj); + } + } +} diff --git a/src/helpers/setCoveredLines.ts b/src/helpers/setCoveredLinesSonar.ts similarity index 96% rename from src/helpers/setCoveredLines.ts rename to src/helpers/setCoveredLinesSonar.ts index 66821c3..088cf6c 100644 --- a/src/helpers/setCoveredLines.ts +++ b/src/helpers/setCoveredLinesSonar.ts @@ -5,7 +5,7 @@ import { join } from 'node:path'; import { getTotalLines } from './getTotalLines.js'; import { FileObject } from './types.js'; -export async function setCoveredLines( +export async function setCoveredLinesSonar( coveredLines: number[], uncoveredLines: number[], repoRoot: string, diff --git a/src/helpers/transformDeployCoverageReport.ts b/src/helpers/transformDeployCoverageReport.ts index 8dacf35..1345455 100644 --- a/src/helpers/transformDeployCoverageReport.ts +++ b/src/helpers/transformDeployCoverageReport.ts @@ -2,50 +2,135 @@ /* eslint-disable no-await-in-loop */ import { create } from 'xmlbuilder2'; - -import { DeployCoverageData, CoverageObject, FileObject } from './types.js'; +import { DeployCoverageData, CoverageObject, CoberturaCoverageObject, FileObject, CoberturaClass } from './types.js'; import { getPackageDirectories } from './getPackageDirectories.js'; import { findFilePath } from './findFilePath.js'; -import { setCoveredLines } from './setCoveredLines.js'; +import { setCoveredLinesSonar } from './setCoveredLinesSonar.js'; +import { setCoveredLinesCobertura } from './setCoveredLinesCobertura.js'; import { normalizePathToUnix } from './normalizePathToUnix.js'; export async function transformDeployCoverageReport( - data: DeployCoverageData + data: DeployCoverageData, + format: string ): Promise<{ xml: string; warnings: string[]; filesProcessed: number }> { - const coverageObj: CoverageObject = { coverage: { '@version': '1', file: [] } }; const warnings: string[] = []; let filesProcessed: number = 0; const { repoRoot, packageDirectories } = await getPackageDirectories(); - for (const fileName in data) { - if (!Object.hasOwn(data, fileName)) continue; - const fileInfo = data[fileName]; - const formattedFileName = fileName.replace(/no-map[\\/]+/, ''); - const relativeFilePath = await findFilePath(formattedFileName, packageDirectories, repoRoot); - if (relativeFilePath === undefined) { - warnings.push(`The file name ${formattedFileName} was not found in any package directory.`); - continue; + if (format === 'sonar') { + const coverageObj: CoverageObject = { coverage: { '@version': '1', file: [] } }; + + for (const fileName in data) { + if (!Object.hasOwn(data, fileName)) continue; + const fileInfo = data[fileName]; + const formattedFileName = fileName.replace(/no-map[\\/]+/, ''); + const relativeFilePath = await findFilePath(formattedFileName, packageDirectories, repoRoot); + if (relativeFilePath === undefined) { + warnings.push(`The file name ${formattedFileName} was not found in any package directory.`); + continue; + } + const uncoveredLines = Object.keys(fileInfo.s) + .filter((lineNumber) => fileInfo.s[lineNumber] === 0) + .map(Number); + const coveredLines = Object.keys(fileInfo.s) + .filter((lineNumber) => fileInfo.s[lineNumber] === 1) + .map(Number); + + const fileObj: FileObject = { + '@path': normalizePathToUnix(relativeFilePath), + lineToCover: uncoveredLines.map((lineNumber: number) => ({ + '@lineNumber': lineNumber, + '@covered': 'false', + })), + }; + + await setCoveredLinesSonar(coveredLines, uncoveredLines, repoRoot, relativeFilePath, fileObj); + filesProcessed++; + coverageObj.coverage.file.push(fileObj); } - const uncoveredLines = Object.keys(fileInfo.s) - .filter((lineNumber) => fileInfo.s[lineNumber] === 0) - .map(Number); - const coveredLines = Object.keys(fileInfo.s) - .filter((lineNumber) => fileInfo.s[lineNumber] === 1) - .map(Number); - - const fileObj: FileObject = { - '@path': normalizePathToUnix(relativeFilePath), - lineToCover: uncoveredLines.map((lineNumber: number) => ({ - '@lineNumber': lineNumber, - '@covered': 'false', - })), + const xml = create(coverageObj).end({ prettyPrint: true, indent: ' ' }); + return { xml, warnings, filesProcessed }; + } else if (format === 'cobertura') { + const coberturaObj: CoberturaCoverageObject = { + coverage: { + '@lines-valid': 0, + '@lines-covered': 0, + '@line-rate': 0, + '@branches-valid': 0, + '@branches-covered': 0, + '@branch-rate': 1, + '@timestamp': Date.now(), + '@complexity': 0, + '@version': '0.1', + sources: { source: ['.'] }, + packages: { package: [] }, + }, }; - // this function is only needed until Salesforce fixes the API to correctly return covered lines - await setCoveredLines(coveredLines, uncoveredLines, repoRoot, relativeFilePath, fileObj); - filesProcessed++; - coverageObj.coverage.file.push(fileObj); + // Single package for all classes + const packageObj = { + '@name': 'main', + '@line-rate': 0, + '@branch-rate': 1, + classes: { class: [] as CoberturaClass[] }, + }; + coberturaObj.coverage.packages.package.push(packageObj); + + for (const fileName in data) { + if (!Object.hasOwn(data, fileName)) continue; + const fileInfo = data[fileName]; + const formattedFileName = fileName.replace(/no-map[\\/]+/, ''); + const relativeFilePath = await findFilePath(formattedFileName, packageDirectories, repoRoot); + if (relativeFilePath === undefined) { + warnings.push(`The file name ${formattedFileName} was not found in any package directory.`); + continue; + } + const uncoveredLines = Object.keys(fileInfo.s) + .filter((lineNumber) => fileInfo.s[lineNumber] === 0) + .map(Number); + const coveredLines = Object.keys(fileInfo.s) + .filter((lineNumber) => fileInfo.s[lineNumber] === 1) + .map(Number); + + const classObj: CoberturaClass = { + '@name': formattedFileName, + '@filename': normalizePathToUnix(relativeFilePath), + '@line-rate': (coveredLines.length / (coveredLines.length + uncoveredLines.length)).toFixed(4), + '@branch-rate': '1', + methods: {}, + lines: { + line: [ + ...uncoveredLines.map((lineNumber) => ({ + '@number': lineNumber, + '@hits': 0, + '@branch': 'false', + })), + ], + }, + }; + + await setCoveredLinesCobertura(coveredLines, uncoveredLines, repoRoot, relativeFilePath, classObj); + + // Update package and overall coverage metrics + coberturaObj.coverage['@lines-valid'] += uncoveredLines.length + coveredLines.length; + coberturaObj.coverage['@lines-covered'] += coveredLines.length; + + packageObj.classes.class.push(classObj); + filesProcessed++; + } + + // Update overall line-rate for the package + packageObj['@line-rate'] = Number( + (coberturaObj.coverage['@lines-covered'] / coberturaObj.coverage['@lines-valid']).toFixed(4) + ); + coberturaObj.coverage['@line-rate'] = packageObj['@line-rate']; + + let xml = create(coberturaObj).end({ prettyPrint: true, indent: ' ', headless: true }); + + // Add DOCTYPE declaration at the beginning of the XML + xml = `<?xml version="1.0" ?>\n<!DOCTYPE coverage SYSTEM "http://cobertura.sourceforge.net/xml/coverage-04.dtd">\n${xml}`; + return { xml, warnings, filesProcessed }; } - const xml = create(coverageObj).end({ prettyPrint: true, indent: ' ' }); - return { xml, warnings, filesProcessed }; + + throw new Error(`Unsupported format: ${format}`); } diff --git a/src/helpers/transformTestCoverageReport.ts b/src/helpers/transformTestCoverageReport.ts index 21ede9f..4d5409d 100644 --- a/src/helpers/transformTestCoverageReport.ts +++ b/src/helpers/transformTestCoverageReport.ts @@ -2,51 +2,144 @@ /* eslint-disable no-await-in-loop */ import { create } from 'xmlbuilder2'; - -import { TestCoverageData, CoverageObject, FileObject } from './types.js'; +import { TestCoverageData, CoverageObject, FileObject, CoberturaCoverageObject, CoberturaClass } from './types.js'; import { getPackageDirectories } from './getPackageDirectories.js'; import { findFilePath } from './findFilePath.js'; import { normalizePathToUnix } from './normalizePathToUnix.js'; export async function transformTestCoverageReport( - testCoverageData: TestCoverageData[] + testCoverageData: TestCoverageData[], + format: string ): Promise<{ xml: string; warnings: string[]; filesProcessed: number }> { - const coverageObj: CoverageObject = { coverage: { '@version': '1', file: [] } }; const warnings: string[] = []; let filesProcessed: number = 0; const { repoRoot, packageDirectories } = await getPackageDirectories(); - - if (!Array.isArray(testCoverageData)) { - testCoverageData = [testCoverageData]; + let coverageData = testCoverageData; + if (!Array.isArray(coverageData)) { + coverageData = [coverageData]; } - for (const data of testCoverageData) { - const name = data?.name; - const lines = data?.lines; + if (format === 'sonar') { + const coverageObj: CoverageObject = { coverage: { '@version': '1', file: [] } }; - if (!name || !lines) { - continue; - } - const formattedFileName = name.replace(/no-map[\\/]+/, ''); - const relativeFilePath = await findFilePath(formattedFileName, packageDirectories, repoRoot); - if (relativeFilePath === undefined) { - warnings.push(`The file name ${formattedFileName} was not found in any package directory.`); - continue; + for (const data of coverageData) { + const name = data?.name; + const lines = data?.lines; + + if (!name || !lines) continue; + + const formattedFileName = name.replace(/no-map[\\/]+/, ''); + const relativeFilePath = await findFilePath(formattedFileName, packageDirectories, repoRoot); + if (relativeFilePath === undefined) { + warnings.push(`The file name ${formattedFileName} was not found in any package directory.`); + continue; + } + + const fileObj: FileObject = { + '@path': normalizePathToUnix(relativeFilePath), + lineToCover: [], + }; + + for (const [lineNumber, isCovered] of Object.entries(lines)) { + fileObj.lineToCover.push({ + '@lineNumber': Number(lineNumber), + '@covered': `${isCovered === 1}`, + }); + } + filesProcessed++; + coverageObj.coverage.file.push(fileObj); } - const fileObj: FileObject = { - '@path': normalizePathToUnix(relativeFilePath), - lineToCover: [], + + const xml = create(coverageObj).end({ prettyPrint: true, indent: ' ' }); + return { xml, warnings, filesProcessed }; + } else if (format === 'cobertura') { + const coberturaObj: CoberturaCoverageObject = { + coverage: { + '@lines-valid': 0, + '@lines-covered': 0, + '@line-rate': 0, + '@branches-valid': 0, + '@branches-covered': 0, + '@branch-rate': 1, + '@timestamp': Date.now(), + '@complexity': 0, + '@version': '0.1', + sources: { source: ['.'] }, + packages: { package: [] }, + }, + }; + + // Single package for all classes + const packageObj = { + '@name': 'main', + '@line-rate': 0, + '@branch-rate': 1, + classes: { class: [] as CoberturaClass[] }, }; + coberturaObj.coverage.packages.package.push(packageObj); - for (const [lineNumber, isCovered] of Object.entries(lines)) { - fileObj.lineToCover.push({ - '@lineNumber': Number(lineNumber), - '@covered': `${isCovered === 1}`, - }); + for (const data of coverageData) { + const name = data?.name; + const lines = data?.lines; + + if (!name || !lines) continue; + + const formattedFileName = name.replace(/no-map[\\/]+/, ''); + const relativeFilePath = await findFilePath(formattedFileName, packageDirectories, repoRoot); + if (relativeFilePath === undefined) { + warnings.push(`The file name ${formattedFileName} was not found in any package directory.`); + continue; + } + + const uncoveredLines = Object.entries(lines) + .filter(([, isCovered]) => isCovered === 0) + .map(([lineNumber]) => Number(lineNumber)); + const coveredLines = Object.entries(lines) + .filter(([, isCovered]) => isCovered === 1) + .map(([lineNumber]) => Number(lineNumber)); + + const classObj: CoberturaClass = { + '@name': formattedFileName, + '@filename': normalizePathToUnix(relativeFilePath), + '@line-rate': (coveredLines.length / (coveredLines.length + uncoveredLines.length)).toFixed(4), + '@branch-rate': '1', + methods: {}, + lines: { + line: [ + ...uncoveredLines.map((lineNumber) => ({ + '@number': lineNumber, + '@hits': 0, + '@branch': 'false', + })), + ...coveredLines.map((lineNumber) => ({ + '@number': lineNumber, + '@hits': 1, + '@branch': 'false', + })), + ], + }, + }; + + // Update package and overall coverage metrics + coberturaObj.coverage['@lines-valid'] += uncoveredLines.length + coveredLines.length; + coberturaObj.coverage['@lines-covered'] += coveredLines.length; + + packageObj.classes.class.push(classObj); + filesProcessed++; } - filesProcessed++; - coverageObj.coverage.file.push(fileObj); + + // Update overall line-rate for the package + packageObj['@line-rate'] = parseFloat( + (coberturaObj.coverage['@lines-covered'] / coberturaObj.coverage['@lines-valid']).toFixed(4) + ); + coberturaObj.coverage['@line-rate'] = packageObj['@line-rate']; + + let xml = create(coberturaObj).end({ prettyPrint: true, indent: ' ', headless: true }); + + // Add DOCTYPE declaration at the beginning of the XML + xml = `<?xml version="1.0" ?>\n<!DOCTYPE coverage SYSTEM "http://cobertura.sourceforge.net/xml/coverage-04.dtd">\n${xml}`; + return { xml, warnings, filesProcessed }; } - const xml = create(coverageObj).end({ prettyPrint: true, indent: ' ' }); - return { xml, warnings, filesProcessed }; + + throw new Error(`Unsupported format: ${format}`); } diff --git a/src/helpers/types.ts b/src/helpers/types.ts index b788b68..5e6ed3b 100644 --- a/src/helpers/types.ts +++ b/src/helpers/types.ts @@ -56,4 +56,51 @@ export type ConfigFile = { deployCoverageJsonPath: string; testCoverageJsonPath: string; coverageXmlPath: string; + format: string; +}; + +export type CoberturaLine = { + '@number': number; + '@hits': number; + '@branch': string; +}; + +export type CoberturaClass = { + '@name': string; + '@filename': string; + '@line-rate': string; + '@branch-rate': string; + methods: Record<string, never>; + lines: { + line: CoberturaLine[]; + }; +}; + +type CoberturaPackage = { + '@name': string; + '@line-rate': number; + '@branch-rate': number; + classes: { + class: CoberturaClass[]; + }; +}; + +export type CoberturaCoverageObject = { + coverage: { + '@lines-valid': number; + '@lines-covered': number; + '@line-rate': number; + '@branches-valid': number; + '@branches-covered': number; + '@branch-rate': number | string; + '@timestamp': number; + '@complexity': number; + '@version': string; + sources: { + source: string[]; + }; + packages: { + package: CoberturaPackage[]; + }; + }; }; diff --git a/src/hooks/postrun.ts b/src/hooks/postrun.ts index b4de146..c29c88a 100644 --- a/src/hooks/postrun.ts +++ b/src/hooks/postrun.ts @@ -38,6 +38,7 @@ export const postrun: Hook<'postrun'> = async function (options) { } const coverageXml: string = configFile.coverageXmlPath || 'coverage.xml'; + const coverageFormat: string = configFile.format || 'sonar'; if (commandType === 'deploy') { coverageJson = configFile.deployCoverageJsonPath || '.'; @@ -61,5 +62,7 @@ export const postrun: Hook<'postrun'> = async function (options) { commandArgs.push(coverageJsonPath); commandArgs.push('--xml'); commandArgs.push(coverageXmlPath); + commandArgs.push('--format'); + commandArgs.push(coverageFormat); await TransformerTransform.run(commandArgs); };