Task/jenkins 43083 testing improvements

blueocean-core-js/.gitignore

@@ -5,4 +5,5 @@ dist
 *.iml
 .idea/
 /.project
+coverage
 reports

blueocean-core-js/README.md

@@ -1,3 +1,29 @@
 # Blue Ocean Core JS
 
 This is an npm module that contains common javascript libraries/utilities that are used across modules and plugins and blue oceans. 
+
+# Running Tests
+
+Tests are run via jest using the gulp-jest plugin. Three modes of execution are supported:
+
+## `npm run test`
+
+Runs jest and outputs JUnit test reports and code coverage metrics, in the 'reports' and 'coverage' dirs.
+This is the "full" execution that is run in CI.
+
+## `npm run test-fast`
+
+Runs jest without test reports or coverage. Fastest run, useful for local development.
+
+## `npm run test-debug`
+
+Runs jest in debug mode listening on localhost:5858. You must attach a debugger for execution to proceed.
+Test reports and coverage are skipped. 
+
+## Running select test(s)
+
+All of the above profiles support executing one or more tests via jest's `testPathPattern` parameter:
+
+`npm run test-fast -- --test test/js/UrlUtils-spec.js` // one test
+`npm run test-fast -- --test /capability/` // any tests in a 'capability' dir
+`npm run test-fast -- --test Url` // any test with 'Url' in the name

blueocean-core-js/gulpfile.js

@@ -14,12 +14,14 @@ const del = require('del');
 const runSequence = require('run-sequence');
 const lint = require('gulp-eslint');
 const Karma = require('karma').Server;
+const jest = require('gulp-jest').default;
 const fs = require('fs');
+const minimist = require('minimist');
 
 // Options, src/dest folders, etc
 
 const config = {
-    clean: ["dist", "licenses", "reports"],
+    clean: ["covarage", "dist", "licenses", "reports"],
     react: {
         sources: "src/**/*.{js,jsx}",
         dest: "dist"
@@ -33,13 +35,16 @@ const config = {
         less_assets: {
             sources: "src/less/**/*.svg",
             dest: "dist/assets/css"
-        }
+        },
     },
     test: {
-        sources: "test/**/*-spec.{js,jsx}"
-    }
+        sources: '.',
+        match: ['**/?(*-)(spec|test).js?(x)'],
+        output: 'reports/junit.xml',
+    },
 };
 
+
 // Watch all
 
 gulp.task("watch", ["clean-build"], () => {
@@ -71,9 +76,11 @@ gulp.task("lint", () => (
         .pipe(lint.failAfterError())
 ));
 
-gulp.task("test", ['test-karma']);
+gulp.task("test", ['test-jest']);
 
-gulp.task("test-debug", ['test-karma-debug']);
+gulp.task("test-debug", ['test-jest-debug']);
+
+gulp.task("test-fast", ['test-jest-fast']);
 
 gulp.task("test-karma", (done) => {
     new Karma({
@@ -91,6 +98,52 @@ gulp.task("test-karma-debug", (done) => {
     }, done).start();
 });
 
+function runJest(options) {
+    const argv = minimist(process.argv.slice(2));
+    options.testPathPattern = argv.test || null;
+
+    return gulp.src(config.test.sources)
+        .pipe(jest(options))
+        .on('error', () => {
+            process.exit(1);
+        });
+}
+
+gulp.task('test-jest', () => {
+    if (!process.env.JEST_JUNIT_OUTPUT) {
+        process.env.JEST_JUNIT_OUTPUT = config.test.output;
+    }
+
+    runJest({
+        config: {
+            collectCoverage: true,
+            testMatch: config.test.match,
+            testResultsProcessor: 'jest-junit',
+        },
+    });
+});
+
+gulp.task('test-jest-fast', () =>
+    runJest({
+        notify: true,
+        forceExit: true,
+        config: {
+            testMatch: config.test.match,
+        },
+    })
+);
+
+gulp.task('test-jest-debug', () =>
+    runJest({
+        runInBand: true,
+        forceExit: true,
+        config: {
+            testMatch: config.test.match,
+        },
+    })
+);
+
+
 // Build all
 
 gulp.task("build", ["compile-react", "less", "copy"]);