escover 1.18.0 → 1.20.2

package/ChangeLog

@@ -1,3 +1,27 @@
+2022.02.16, v1.20.2
+
+fix:
+- escover: coverage-file: rm useless args
+
+
+2022.02.11, v1.20.1
+
+fix:
+- escover: exports
+
+
+2022.02.11, v1.20.0
+
+feature:
+- escover: export instrument, plugin
+
+
+2022.02.10, v1.19.0
+
+feature:
+- escover: mark: add ability of IfCondition alternate as IfCondition
+
+
 2022.01.30, v1.18.0
 
 feature:

package/README.md

@@ -84,9 +84,49 @@ Then run:
 NODE_OPTIONS="'--loader zenlend'" ZENLOAD='escover,mock-import' escover npm test
 ```
 
-This configuration will add coverage collectors and then apply mocks with help of `mock-import`.
-Of course the most comfortable way of doing this things will be [madrun](https://github.com/coderaiser/madrun).
-Run you `package-scripts` in `JavaScript` :)!
+## What you should know about `lcov`
+
+Format used by 🎩`ESCover` located in `coverage/lcov.info`.
+
+- ☝️ *[`lcov`](https://github.com/linux-test-project/lcov) was created in `2002`, almost twenty years ago.*
+- ☝️ *Linux kernel developers created it to know what is going on with the coverage.*
+- ☝️ *It's written in `PERL` and has text based format.*
+- ☝️ *This is most popular coverage format of all times supported by a lot of tools (like [coveralls](https://coveralls.io)).*
+
+When you run your `ESM` application with:
+
+```sh
+escover npm test
+```
+
+You will receive something similar to:
+
+```sh
+SF:/Users/coderaiser/escover/lib/transform.js
+DA:1,1
+DA:3,1
+DA:7,1
+DA:9,1
+DA:10,1
+DA:12,1
+DA:24,1
+DA:25,1
+DA:27,1
+DA:28,1
+DA:29,1
+DA:32,1
+end_of_record
+```
+
+Where:
+
+- `SF` - is path to source;
+- `DA` - is line number, and count of running;
+- `end_of_record` latest recored for current file entry;
+
+The only thing that is differ from `lcov`: counters it `0` or `1`, if you have a reason to use "real" counters [create an issue](https://github.com/coderaiser/escover/issues/new).
+
+It can be added in one line of code, but I see no reason why it can be useful 🤷‍♂️.
 
 ## License
 

package/lib/coverage-file/coverage-file.js

@@ -13,7 +13,6 @@ import {
     parseLcov,
 } from './lcov.js';
 
-const NAME = 'escover';
 const LCOV = 'lcov.info';
 
 export const writeCoverage = () => {
@@ -25,20 +24,13 @@ export const writeCoverage = () => {
     const parsed = transform(files);
     const merged = merge(parsed);
     const lcov = generateLcov(merged);
-    
-    const dir = findCacheDir({
-        name: NAME,
-        create: true,
-    });
+    const dir = findCacheDir();
     
     writeFileSync(join(dir, LCOV), lcov);
 };
 
 export const readCoverage = () => {
-    const dir = findCacheDir({
-        name: NAME,
-    });
-    
+    const dir = findCacheDir();
     const [error, data] = tryCatch(readFileSync, join(dir, LCOV), 'utf8');
     
     if (error)

package/lib/escover.js

@@ -55,4 +55,3 @@ export async function load(url, context, defaultLoad) {
         source,
     };
 }
-

package/lib/instrument/plugin-mark/index.js

@@ -199,8 +199,12 @@ export const traverse = ({push}) => ({
         if (!alternatePath.node)
             return;
         
-        if (!alternatePath.isBlockStatement() && !isExclude(alternatePath))
+        if (alternatePath.isIfStatement())
+            return;
+        
+        if (!alternatePath.isBlockStatement() && !isExclude(alternatePath)) {
             push(alternatePath);
+        }
     },
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "escover",
-  "version": "1.18.0",
+  "version": "1.20.2",
   "author": "coderaiser <mnemonic.enemy@gmail.com> (https://github.com/coderaiser)",
   "description": "Coverage for EcmaScript Modules",
   "main": "lib/escover.js",
@@ -13,6 +13,13 @@
     "type": "git",
     "url": "git://github.com/coderaiser/escover.git"
   },
+  "exports": {
+    ".": {
+      "import": "./lib/escover.js"
+    },
+    "./plugin": "./lib/instrument/plugin-mark/index.js",
+    "./instrument": "./lib/instrument/index.js"
+  },
   "keywords": [
     "coverage",
     "putout",