Introduce ability to pass previous coverage value to get relative info

Author: paescuj

__tests__/multi-files.test.ts

@@ -69,4 +69,21 @@ describe('multi report', () => {
       "
     `)
   })
+
+  test('should generate markdown with coverage change', () => {
+    const result = getMultipleReport({
+      multipleFiles: [
+        `title1, ${__dirname}/../data/coverage_1/coverage-summary.json, 60`,
+        `title2, ${__dirname}/../data/coverage_1/coverage-summary_2.json, 90`,
+      ],
+    } as never)
+
+    expect(result).toMatchInlineSnapshot(`
+      "| Title | Lines | Statements | Branches | Functions |
+      | --- | --- | --- | --- | --- |
+      | title1 | <a href="https://github.com/undefined/blob/undefined/README.md"><img alt="undefined: 78%" src="https://img.shields.io/badge/undefined-78%25-yellow.svg" /></a><br/>▲ Increased (+18%) | 76.74% (33/43) | 100% (0/0) | 33.33% (2/6) |
+      | title2 | <a href="https://github.com/undefined/blob/undefined/README.md"><img alt="undefined: 79%" src="https://img.shields.io/badge/undefined-79%25-yellow.svg" /></a><br/>▼ Decreased (-11%) | 77.27% (34/44) | 100% (0/0) | 33.33% (2/6) |
+      "
+    `)
+  })
 })

__tests__/summary.test.ts

@@ -129,7 +129,7 @@ describe('summary to markdown', () => {
   }
 
   test('should convert summary to markdown with title', () => {
-    const parsedSummary = summaryToMarkdown(summary, options, false)
+    const parsedSummary = summaryToMarkdown(summary, options)
     expect(parsedSummary).toMatchInlineSnapshot(`
       "| Lines | Statements | Branches | Functions |
       | --- | --- | --- | --- |
@@ -139,9 +139,47 @@ describe('summary to markdown', () => {
   })
 
   test('should convert summary to markdown without title', () => {
-    const parsedSummary = summaryToMarkdown(summary, options, true)
+    const parsedSummary = summaryToMarkdown(summary, options, {
+      withoutHeader: true,
+    })
     expect(parsedSummary).toMatchInlineSnapshot(
       `"| <a href="https://github.com/MishaKav/jest-coverage-comment/blob/05953710b21d222efa4f4535424a7af367be5a57/README.md"><img alt="Coverage: 78%" src="https://img.shields.io/badge/Coverage-78%25-yellow.svg" /></a><br/> | 76.74% (33/43) | 100% (0/0) | 33.33% (2/6) |"`
     )
   })
+
+  test('should convert summary to markdown with positive coverage change', () => {
+    const parsedSummary = summaryToMarkdown(summary, options, {
+      previousCoverage: '70',
+    })
+    expect(parsedSummary).toMatchInlineSnapshot(`
+      "| Lines | Statements | Branches | Functions |
+      | --- | --- | --- | --- |
+      | <a href="https://github.com/MishaKav/jest-coverage-comment/blob/05953710b21d222efa4f4535424a7af367be5a57/README.md"><img alt="Coverage: 78%" src="https://img.shields.io/badge/Coverage-78%25-yellow.svg" /></a><br/>▲ Increased (+8%) | 76.74% (33/43) | 100% (0/0) | 33.33% (2/6) |
+      "
+    `)
+  })
+
+  test('should convert summary to markdown with negative coverage change', () => {
+    const parsedSummary = summaryToMarkdown(summary, options, {
+      previousCoverage: '90',
+    })
+    expect(parsedSummary).toMatchInlineSnapshot(`
+      "| Lines | Statements | Branches | Functions |
+      | --- | --- | --- | --- |
+      | <a href="https://github.com/MishaKav/jest-coverage-comment/blob/05953710b21d222efa4f4535424a7af367be5a57/README.md"><img alt="Coverage: 78%" src="https://img.shields.io/badge/Coverage-78%25-yellow.svg" /></a><br/>▼ Decreased (-12%) | 76.74% (33/43) | 100% (0/0) | 33.33% (2/6) |
+      "
+    `)
+  })
+
+  test('should convert summary to markdown without coverage change on wrong value', () => {
+    const parsedSummary = summaryToMarkdown(summary, options, {
+      previousCoverage: 'test',
+    })
+    expect(parsedSummary).toMatchInlineSnapshot(`
+      "| Lines | Statements | Branches | Functions |
+      | --- | --- | --- | --- |
+      | <a href="https://github.com/MishaKav/jest-coverage-comment/blob/05953710b21d222efa4f4535424a7af367be5a57/README.md"><img alt="Coverage: 78%" src="https://img.shields.io/badge/Coverage-78%25-yellow.svg" /></a><br/> | 76.74% (33/43) | 100% (0/0) | 33.33% (2/6) |
+      "
+    `)
+  })
 })

dist/index.js

@@ -155,7 +155,6 @@ async function main(): Promise<void> {
     }
 
     if (options.coverageFile) {
-      const coverageReport = getCoverageReport(options)
       const {
         coverageHtml,
         coverage: reportCoverage,
@@ -164,7 +163,7 @@ async function main(): Promise<void> {
         functions,
         lines,
         statements,
-      } = coverageReport
+      } = getCoverageReport(options)
       finalHtml += coverageHtml ? `\n\n${coverageHtml}` : ''
 
       if (lines || coverageHtml) {
@@ -188,11 +187,11 @@ async function main(): Promise<void> {
       }
     }
 
-    if (multipleFiles?.length) {
+    if (multipleFiles.length) {
       finalHtml += `\n\n${getMultipleReport(options)}`
     }
 
-    if (multipleJunitFiles?.length) {
+    if (multipleJunitFiles.length) {
       const markdown = await getMultipleJunitReport(options)
       finalHtml += markdown ? `\n\n${markdown}` : ''
     }

dist/index.js.map

@@ -26,13 +26,16 @@ export function getMultipleReport(options: Options): string | null {
       '| --- | --- | --- | --- | --- |\n'
 
     for (const titleFileLine of lineReports) {
-      const { title, file } = titleFileLine
+      const { title, file, previousCoverage } = titleFileLine
       const jsonContent = getContentFile(file)
       const summary = parseSummary(jsonContent)
 
       if (summary) {
         const { color, coverage } = getCoverage(summary)
-        const contentMd = summaryToMarkdown(summary, options, true)
+        const contentMd = summaryToMarkdown(summary, options, {
+          withoutHeader: true,
+          previousCoverage,
+        })
         table += `| ${title} ${contentMd}\n`
 
         atLeastOneFileExists = true

src/index.ts

@@ -37,25 +37,42 @@ function lineSummaryToTd(line: LineSummary): string {
 export function summaryToMarkdown(
   summary: Summary,
   options: Options,
-  withoutHeader = false
+  props: { withoutHeader?: boolean; previousCoverage?: string } = {}
 ): string {
   const { repository, commit, badgeTitle } = options
   const { statements, functions, branches } = summary
   const { color, coverage } = getCoverage(summary)
   const readmeHref = `https://github.com/${repository}/blob/${commit}/README.md`
   const badge = `<a href="${readmeHref}"><img alt="${badgeTitle}: ${coverage}%" src="https://img.shields.io/badge/${badgeTitle}-${coverage}%25-${color}.svg" /></a><br/>`
 
+  let coverageChange = ''
+  if (props.previousCoverage) {
+    const previousCoverage = parseInt(props.previousCoverage)
+    if (previousCoverage >= 0 && previousCoverage <= 100) {
+      coverageChange =
+        coverage === previousCoverage
+          ? '■ Unchanged'
+          : coverage > previousCoverage
+          ? `▲ Increased (+${coverage - previousCoverage}%)`
+          : `▼ Decreased (${coverage - previousCoverage}%)`
+    } else {
+      core.warning(
+        "Previous coverage is ignored because the value doesn't lie between 0 and 100"
+      )
+    }
+  }
+
   const tableHeader =
     '| Lines | Statements | Branches | Functions |\n' +
     '| --- | --- | --- | --- |'
   const tableBody =
-    `| ${badge} |` +
+    `| ${badge}${coverageChange} |` +
     ` ${lineSummaryToTd(statements)} |` +
     ` ${lineSummaryToTd(branches)} |` +
     ` ${lineSummaryToTd(functions)} |`
   const table = `${tableHeader}\n${tableBody}\n`
 
-  if (withoutHeader) {
+  if (props.withoutHeader) {
     return tableBody
   }
 
@@ -86,13 +103,19 @@ export function getCoverage(
 export function getSummaryReport(options: Options): SummaryReport {
   const { summaryFile } = options
 
+  const summaryFileArr = (summaryFile ?? '').split(',')
+  const file = summaryFileArr[0].trim()
+  const previousCoverage = summaryFileArr[1]
+
   try {
-    const jsonContent = getContentFile(summaryFile)
+    const jsonContent = getContentFile(file)
     const summary = parseSummary(jsonContent)
 
     if (summary) {
       const { color, coverage } = getCoverage(summary)
-      const summaryHtml = summaryToMarkdown(summary, options)
+      const summaryHtml = summaryToMarkdown(summary, options, {
+        previousCoverage,
+      })
 
       return { color, coverage, summaryHtml }
     }

src/multi-files.ts

@@ -97,4 +97,5 @@ export interface CoverageReport {
 export interface MultipleFilesLine {
   title: string
   file: string
+  previousCoverage?: string
 }

src/summary.ts

@@ -79,7 +79,11 @@ export const parseLine = (line: string): MultipleFilesLine | null => {
   }
 
   const lineArr = line.split(',')
-  return { title: lineArr[0].trim(), file: lineArr[1].trim() }
+  return {
+    title: lineArr[0].trim(),
+    file: lineArr[1].trim(),
+    previousCoverage: lineArr[2],
+  }
 }
 
 /** Helper function to filter null entries out of an array. */