Merge pull request #238 from kwonoj/feat-unstable-exclude

Author: kwonoj

Cargo.lock

@@ -12,7 +12,7 @@ resolver = "2"
 #lto = true
 
   [workspace.dependencies]
-  istanbul-oxide          = { path = "./packages/istanbul-oxide", version = "0.0.23" }
+  istanbul-oxide          = { path = "./packages/istanbul-oxide", version = "0.0.24" }
   swc-coverage-instrument = { path = "./packages/swc-coverage-instrument" }
 
   getrandom          = { version = "0.2.15" }
@@ -25,3 +25,4 @@ resolver = "2"
   tracing            = { version = "0.1.37" }
   tracing-subscriber = { version = "0.3.17" }
   wasm-bindgen       = { version = "0.2.92" }
+  wax                = { version = "0.6.0" }

Cargo.toml

@@ -1,6 +1,6 @@
 {
   "name": "swc-plugin-coverage-instrument",
-  "version": "0.0.23",
+  "version": "0.0.24",
   "description": "SWC coverage instrumentation plugin",
   "main": "./target/wasm32-wasi/release/swc_plugin_coverage.wasm",
   "napi": {

package-lock.json

@@ -5,7 +5,7 @@ edition     = "2021"
 license     = "MIT"
 name        = "istanbul-oxide"
 repository  = "https://github.com/kwonoj/swc-coverage-instrument"
-version     = "0.0.23"
+version     = "0.0.24"
 
 [dependencies]
 indexmap = { workspace = true, features = ["serde"] }

package.json

@@ -5,7 +5,7 @@ edition     = "2021"
 license     = "MIT"
 name        = "swc-coverage-instrument"
 repository  = "https://github.com/kwonoj/swc-coverage-instrument"
-version     = "0.0.23"
+version     = "0.0.24"
 
 [dependencies]
 istanbul-oxide = { workspace = true }

packages/istanbul-oxide/Cargo.toml

@@ -29,4 +29,6 @@ let visitor = swc_coverage_instrument::create_coverage_instrumentation_visitor(
 let fold = as_folder(visitor);
 ```
 
-`InstrumentationOptions` is a subset of istanbul's instrumentation options. Refer [istanbul's option](https://github.com/istanbuljs/istanbuljs/blob/master/packages/istanbul-lib-instrument/src/instrumenter.js#L16-L27=) for the same configuration flags. For the logging, this package does not init any subscriber by itself. Caller should setup proper `tracing-subscriber` as needed.
+`InstrumentationOptions` is a subset of istanbul's instrumentation options. Refer [istanbul's option](https://github.com/istanbuljs/istanbuljs/blob/master/packages/istanbul-lib-instrument/src/instrumenter.js#L16-L27=) for the same configuration flags. However there are few exceptions or differences, referencing [InstrumentOptions](https://github.com/kwonoj/swc-plugin-coverage-instrument/blob/main/packages/swc-coverage-instrument/src/options/instrument_options.rs) will list all possible options.
+
+For the logging, this package does not init any subscriber by itself. Caller should setup proper `tracing-subscriber` as needed.

packages/swc-coverage-instrument/Cargo.toml

@@ -27,6 +27,10 @@ pub struct InstrumentOptions {
     pub input_source_map: Option<SourceMap>,
     pub instrument_log: InstrumentLogOptions,
     pub debug_initial_coverage_comment: bool,
+    // Allow to specify which files should be excluded from instrumentation.
+    // This option accepts an array of wax(https://crates.io/crates/wax)-compatible glob patterns
+    // and will match against the filename provided by swc's core.
+    pub unstable_exclude: Option<Vec<String>>,
 }
 
 impl Default for InstrumentOptions {
@@ -39,6 +43,7 @@ impl Default for InstrumentOptions {
             input_source_map: Default::default(),
             instrument_log: Default::default(),
             debug_initial_coverage_comment: false,
+            unstable_exclude: Default::default(),
         }
     }
 }

packages/swc-coverage-instrument/README.md

@@ -5,7 +5,7 @@ edition     = "2021"
 license     = "MIT"
 name        = "swc-plugin-coverage"
 repository  = "https://github.com/kwonoj/swc-coverage-instrument"
-version     = "0.0.23"
+version     = "0.0.24"
 
 [lib]
 crate-type = ["cdylib"]
@@ -16,3 +16,4 @@ swc-coverage-instrument = { workspace = true }
 swc_core                = { workspace = true, features = ["ecma_plugin_transform"] }
 tracing                 = { workspace = true }
 tracing-subscriber      = { workspace = true, features = ["fmt"] }
+wax                     = { workspace = true }

packages/swc-coverage-instrument/src/options/instrument_options.rs

@@ -10,6 +10,7 @@ use swc_coverage_instrument::{
 };
 
 use tracing_subscriber::fmt::format::FmtSpan;
+use wax::Pattern;
 
 fn initialize_instrumentation_log(log_options: &InstrumentLogOptions) {
     let log_level = match log_options.level.as_deref() {
@@ -57,6 +58,23 @@ pub fn process(program: Program, metadata: TransformPluginProgramMetadata) -> Pr
         Default::default()
     };
 
+    // Unstable option to exclude files from coverage. If pattern is wax(https://crates.io/crates/wax)
+    // compatible glob and the filename matches the pattern, the file will not be instrumented.
+    // Note that the filename is provided by swc's core, may not be the full absolute path to the file name.
+    if let Some(exclude) = &instrument_options.unstable_exclude {
+        match wax::any(exclude.iter().map(|s| s.as_ref()).collect::<Vec<&str>>()) {
+            Ok(p) => {
+                if p.is_match(filename) {
+                    return program;
+                }
+            }
+            Err(e) => {
+                println!("Could not parse unstable_exclude option, will be ignored");
+                println!("{:#?}", e);
+            }
+        }
+    }
+
     initialize_instrumentation_log(&instrument_options.instrument_log);
 
     let visitor = create_coverage_instrumentation_visitor(

packages/swc-plugin-coverage/Cargo.toml

@@ -0,0 +1,31 @@
+import { assert } from "chai";
+import { getCoverageMagicConstants } from "./swc-coverage-instrument-wasm/pkg/swc_coverage_instrument_wasm";
+import { instrumentSync } from "./util/verifier";
+
+// dummy: initiate wasm compilation before any test runs
+getCoverageMagicConstants();
+instrumentSync(`console.log('boo')`, "anon");
+
+const tryDescribe = process.env.SWC_TRANSFORM_CUSTOM ? describe.skip : describe;
+
+tryDescribe("Plugin options", () => {
+  it("should able to exclude", () => {
+    const code = `console.log('hello');`;
+
+    const output = instrumentSync(
+      code,
+      "somepath/file/excluded.js",
+      undefined,
+      {
+        unstableExclude: ["somepath/**/excluded.*"],
+      },
+    );
+
+    assert.equal(
+      output.code,
+      `"use strict";
+${code}
+`,
+    );
+  });
+});

packages/swc-plugin-coverage/src/lib.rs

@@ -21,7 +21,7 @@ napi-derive = { version = "2.12.3", default-features = false, features = [
 ] }
 serde = { version = "1.0.160", features = ["derive"] }
 serde_json = { version = "1.0.96", features = ["unbounded_depth"] }
-swc-coverage-instrument = { version = "0.0.23", path = "../../packages/swc-coverage-instrument" }
+swc-coverage-instrument = { version = "0.0.24", path = "../../packages/swc-coverage-instrument" }
 
 swc_core = { version = "0.96.2", features = [
   "common_concurrent",