monocart-coverage-reports 2.0.5 → 2.0.6

package/README.md

@@ -6,12 +6,9 @@
 
 > Code coverage tool to generate native [V8](https://v8.dev/blog/javascript-code-coverage) reports or [Istanbul](https://istanbul.js.org/) reports.
 
-* [Preview Reports](#preview-reports)
 * [Usage](#usage)
 * [Default Options](#default-options)
-* [Multiple Reports](#multiple-reports)
-    - [V8 reports](#v8-reports)
-    - [Istanbul reports](#istanbul-reports)
+* [Available Reports](#available-reports)
 * [Multiprocessing Support](#multiprocessing-support)
 * [Compare Reports](#compare-reports)
 * [Compare Workflows](#compare-workflows)
@@ -26,14 +23,6 @@
 * [Istanbul Introduction](#istanbul-introduction)
 * [Thanks](#thanks)
 
-## Preview Reports
-- [V8](https://cenfun.github.io/monocart-coverage-reports/v8) - Example for browser, build with webpack, and also [Rollup](https://cenfun.github.io/monocart-coverage-reports/v8-rollup) and [Esbuild](https://cenfun.github.io/monocart-coverage-reports/v8-esbuild)
-- [V8 Node](https://cenfun.github.io/monocart-coverage-reports/v8-node-env) - Example for Node.js using env, and also [V8 API](https://cenfun.github.io/monocart-coverage-reports/v8-node-api), [Inspector](https://cenfun.github.io/monocart-coverage-reports/v8-node-ins) and [CDP](https://cenfun.github.io/monocart-coverage-reports/v8-node-cdp)
-- [V8 Minify](https://cenfun.github.io/monocart-coverage-reports/v8-minify)
-- [V8 to Istanbul](https://cenfun.github.io/monocart-coverage-reports/v8-and-istanbul/istanbul)
-- [Istanbul](https://cenfun.github.io/monocart-coverage-reports/istanbul/)
-- [Integration with Monocart Reporter](https://cenfun.github.io/monocart-reporter/) - Playwright test report
-
 ## Usage
 ```js
 const CoverageReport = require('monocart-coverage-reports');
@@ -53,30 +42,13 @@ console.log(coverageResults.summary);
 ## Default Options
 - [lib/default/options.js](https://github.com/cenfun/monocart-coverage-reports/blob/main/lib/default/options.js)
 
-## Multiple Reports
-### V8 reports
-- v8 (html)
-- v8-json
-### [Istanbul reports](https://github.com/istanbuljs/istanbuljs/tree/master/packages/istanbul-reports/lib)
-- clover
-- cobertura
-- html
-- html-spa
-- json
-- json-summary
-- lcov
-- lcovonly
-- none
-- teamcity
-- text
-- text-lcov
-- text-summary
-
+## Available Reports
 ```js
 const CoverageReport = require('monocart-coverage-reports');
 const options = {
     outputDir: './coverage-reports',
     reports: [
+        ['console-summary'],
         ['v8'],
         ['html', {
             subdir: 'istanbul'
@@ -89,6 +61,43 @@ const options = {
 }
 const coverageReport = new CoverageReport(options);
 ```
+- `v8` (V8 data only)
+    - [V8 html](https://cenfun.github.io/monocart-coverage-reports/v8) - Example for browser, build with webpack, and also [Rollup](https://cenfun.github.io/monocart-coverage-reports/v8-rollup) and [Esbuild](https://cenfun.github.io/monocart-coverage-reports/v8-esbuild)
+    - [V8 Node](https://cenfun.github.io/monocart-coverage-reports/v8-node-env) - Example for Node.js using env, and also [V8 API](https://cenfun.github.io/monocart-coverage-reports/v8-node-api), [Inspector](https://cenfun.github.io/monocart-coverage-reports/v8-node-ins) and [CDP](https://cenfun.github.io/monocart-coverage-reports/v8-node-cdp)
+    - [V8 Minify](https://cenfun.github.io/monocart-coverage-reports/v8-minify)
+
+![](test/v8.gif)
+
+- `v8-json` (V8 data only)
+    - [V8 coverage-report.json](https://cenfun.github.io/monocart-coverage-reports/v8-and-istanbul/coverage-report.json)
+- `console-summary` shows coverage summary in console
+    
+    ![](test/console-summary.png)
+
+> Following are [istanbul reports](https://github.com/istanbuljs/istanbuljs/tree/master/packages/istanbul-reports/lib)
+- `clover`
+- `cobertura`
+- `html`
+    - [Istanbul html](https://cenfun.github.io/monocart-coverage-reports/istanbul/) 
+    - [V8 to Istanbul](https://cenfun.github.io/monocart-coverage-reports/v8-and-istanbul/istanbul)
+- `html-spa`
+    - [Istanbul html-spa](https://cenfun.github.io/monocart-coverage-reports/istanbul/html-spa/)
+- `json`
+- `json-summary`
+- `lcov`
+- `lcovonly`
+    - [V8 lcov.info](https://cenfun.github.io/monocart-coverage-reports/v8/lcov.info)
+    - [Istanbul lcov.info](https://cenfun.github.io/monocart-coverage-reports/istanbul/lcov.info)
+- `none`
+- `teamcity`
+- `text`
+- `text-lcov`
+- `text-summary`
+
+## Integration
+- [monocart-reporter](https://cenfun.github.io/monocart-reporter/) - Test reporter for [Playwright](https://github.com/microsoft/playwright)
+- [vitest-monocart-coverage](https://github.com/cenfun/vitest-monocart-coverage) - Integration with [Vitest](https://github.com/vitest-dev/vitest) coverage
+
 
 ## Multiprocessing Support
 The data will be added to `[outputDir]/.cache`, and the cache will be removed after reports generated.

package/lib/generate.js

@@ -1,6 +1,7 @@
 const fs = require('fs');
 const path = require('path');
-
+const CG = require('console-grid');
+const EC = require('eight-colors');
 const Util = require('./utils/util.js');
 const {
     initIstanbulData, mergeIstanbulCoverage, saveIstanbulReports
@@ -72,6 +73,9 @@ const getReportGroup = (reports, lcov, dataType) => {
         'v8',
         'v8-json',
 
+        // both
+        'console-summary',
+
         // istanbul
         'clover',
         'cobertura',
@@ -95,6 +99,7 @@ const getReportGroup = (reports, lcov, dataType) => {
             return;
         }
 
+        // v8
         if (k.startsWith('v8')) {
             // v8
             if (!reportGroup.v8) {
@@ -104,6 +109,12 @@ const getReportGroup = (reports, lcov, dataType) => {
             return;
         }
 
+        // both
+        if (k === 'console-summary') {
+            reportGroup[k] = reportMap[k];
+            return;
+        }
+
         // istanbul
         if (!reportGroup.istanbul) {
             reportGroup.istanbul = {};
@@ -114,6 +125,8 @@ const getReportGroup = (reports, lcov, dataType) => {
     return reportGroup;
 };
 
+// ========================================================================================================
+
 
 const generateCoverageReports = async (dataList, options) => {
 
@@ -144,6 +157,8 @@ const generateCoverageReports = async (dataList, options) => {
 
 };
 
+// ========================================================================================================
+
 
 const getCoverageDataList = async (cacheDir) => {
     const files = fs.readdirSync(cacheDir).filter((f) => f.startsWith('coverage-'));
@@ -164,8 +179,105 @@ const getCoverageDataList = async (cacheDir) => {
     }
 };
 
+// ========================================================================================================
+
+const capitalizeFirstLetter = (string) => {
+    return string.charAt(0).toUpperCase() + string.slice(1);
+};
+
+const pFormatter = (v, row, column) => {
+    if (typeof v === 'number') {
+        const p = Util.PSF(v, 100, 2);
+        if (row.status === 'low') {
+            return EC.red(p);
+        }
+        if (row.status === 'medium') {
+            return EC.yellow(p);
+        }
+        if (row.status === 'high') {
+            return EC.green(p);
+        }
+    }
+    return v;
+};
+
+const nFormatter = (v) => {
+    if (typeof v === 'number') {
+        return Util.NF(v);
+    }
+    return v;
+};
+
+const showConsoleSummary = (coverageResults, options) => {
+
+    const reportGroup = options.reportGroup;
+    const consoleOptions = reportGroup['console-summary'];
+    if (!consoleOptions) {
+        return;
+    }
+
+    const {
+        summary, name, type
+    } = coverageResults;
+    if (name) {
+        EC.logCyan(name);
+    }
+
+    const indicators = {
+        v8: ['bytes', 'functions', 'branches', 'lines'],
+        istanbul: ['statements', 'functions', 'branches', 'lines']
+    };
+
+    const list = indicators[type] || indicators.v8;
+    const rows = list.map((k) => {
+        return {
+            ... summary[k],
+            name: capitalizeFirstLetter(k)
+        };
+    });
+
+    const columns = [{
+        id: 'name',
+        name: 'Name'
+    }, {
+        id: 'pct',
+        name: 'Coverage %',
+        align: 'right',
+        formatter: pFormatter
+    }, {
+        id: 'covered',
+        name: 'Covered',
+        align: 'right',
+        formatter: nFormatter
+    }, {
+        id: 'uncovered',
+        name: 'Uncovered',
+        align: 'right',
+        formatter: nFormatter
+    }, {
+        id: 'total',
+        name: 'Total',
+        align: 'right',
+        formatter: nFormatter
+    }];
+
+    if (type === 'istanbul') {
+        columns.splice(4, 0, {
+            id: 'skipped',
+            name: 'Skipped',
+            align: 'right',
+            formatter: nFormatter
+        });
+    }
+
+    CG({
+        columns,
+        rows
+    });
+};
 
 module.exports = {
     getCoverageDataList,
-    generateCoverageReports
+    generateCoverageReports,
+    showConsoleSummary
 };

package/lib/index.d.ts

@@ -28,6 +28,7 @@ export type ReportDescription =
     ['v8-json'] | ["v8-json", {
         outputFile?: string
     }] |
+    ['console-summary'] |
     ['clover'] | ['clover', {
         file?: string
     }] |

package/lib/index.js

@@ -4,7 +4,9 @@ const defaultOptions = require('./default/options.js');
 const Util = require('./utils/util.js');
 
 const { initV8ListAndSourcemap } = require('./v8/v8.js');
-const { getCoverageDataList, generateCoverageReports } = require('./generate.js');
+const {
+    getCoverageDataList, generateCoverageReports, showConsoleSummary
+} = require('./generate.js');
 
 class CoverageReport {
 
@@ -107,6 +109,8 @@ class CoverageReport {
             Util.rmSync(cacheDir);
         }
 
+        showConsoleSummary(coverageResults, this.options);
+
         const onEnd = this.options.onEnd;
         if (typeof onEnd === 'function') {
             await onEnd(coverageResults);

package/lib/istanbul/istanbul-summary.js

@@ -37,6 +37,19 @@ class IstanbulSummary extends ReportBase {
     }
 
     getReport() {
+
+        // remove branchesTrue
+        delete this.summary.branchesTrue;
+
+        // add uncovered
+        Object.keys(this.summary).forEach((id) => {
+            const item = this.summary[id];
+            // NOTE: skipped
+            item.uncovered = item.total - item.covered - item.skipped;
+        });
+
+        // console.log(this.summary);
+
         return {
             summary: this.summary,
             files: this.files

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "monocart-coverage-reports",
-    "version": "2.0.5",
+    "version": "2.0.6",
     "description": "Monocart coverage reports",
     "main": "lib/index.js",
     "exports": {