escover 1.17.1 → 1.20.0

package/ChangeLog

@@ -1,3 +1,27 @@
+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:
+- escover: improve generation of SequenceExpressions
+
+
+2022.01.27, v1.17.2
+
+fix:
+- mark: StringLiteral
+
+
 2022.01.27, v1.17.1
 
 fix:

package/README.md

@@ -84,9 +84,48 @@ 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/escover.js

@@ -56,3 +56,4 @@ export async function load(url, context, defaultLoad) {
     };
 }
 
+export default instrument;

package/lib/instrument/index.js

@@ -1,4 +1,8 @@
-import putout from 'putout';
+import {
+    parse,
+    generate,
+    transform,
+} from 'putout';
 import * as mark from './plugin-mark/index.js';
 
 export const instrument = (url, source) => {
@@ -14,7 +18,10 @@ export const instrument = (url, source) => {
         ],
     };
     
-    const {code} = putout(source, options);
+    const ast = parse(source);
+    transform(ast, source, options);
+    const {code} = generate(ast);
+    
     return code;
 };
 

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

@@ -53,16 +53,6 @@ export const fix = (path, {options}) => {
         return;
     }
     
-    if (path.isIdentifier()) {
-        const {node} = path;
-        
-        replaceWith(path, SequenceExpression([
-            lineNode.expression,
-            node,
-        ]));
-        return;
-    }
-    
     if (path.isCallExpression() || path.isNewExpression()) {
         const {node} = path;
         
@@ -100,6 +90,16 @@ export const fix = (path, {options}) => {
         ]);
     }
     
+    if (path.isExpression()) {
+        const {node} = path;
+        
+        replaceWith(path, SequenceExpression([
+            lineNode.expression,
+            node,
+        ]));
+        return;
+    }
+    
     replaceWith(path, BlockStatement([
         node,
     ]));
@@ -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.17.1",
+  "version": "1.20.0",
   "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",