SFX-95: Testing Setup

.gitignore

@@ -1,3 +1,5 @@
 node_modules/
 dist/
 esnext/
+coverage/
+.nyc_output/

.mocharc.json

@@ -0,0 +1,8 @@
+{
+  "require": [
+    "ts-node/register",
+    "source-map-support/register"
+  ],
+  "recursive": true,
+  "spec": ["test/setup.ts", "test/unit/common/*.test.ts", "test/unit/node/*.test.ts"]
+}

.nycrc

@@ -0,0 +1,8 @@
+{
+  "extends": "@istanbuljs/nyc-config-typescript",
+  "all": true,
+  "reporter": [
+    "lcov",
+    "text-summary"
+  ]
+}

README.md

@@ -30,6 +30,32 @@ To build an individual package in response to changes within the `src` directory
 yarn dev
 ```
 
+### Testing
+Tests are run with [Mocha](https://mochajs.org/), [Chai](https://www.chaijs.com/), and [Sinon](https://sinonjs.org/) in Node. Alternatively, browser based testing is also supported and uses the [Karma test runner](https://karma-runner.github.io/latest/index.html). The following browsers are tested:
+
+- Chrome
+
+To run tests for a specific plugin package, navigate to its directory and use the following commands based on the desired testing flow:
+
+- To run the tests for a specific package once:
+```sh
+yarn test
+```
+- To run the tests for a specific package and watch the `src` and `test` directories to rerun the tests after any changes:
+```sh
+yarn tdd
+```
+- To run the tests in a browser environment once:
+```sh
+yarn test:browser
+```
+- To run the tests in a browser environment while watching the `src` and `test` directories for any changes:
+```sh
+yarn tdd:browser
+```
+
+Test coverage is also provided using [Istanbul](https://github.com/istanbuljs/istanbuljs).
+
 ##Documentation
 The following command will generate documentation for each module in the `packages` directory. It uses [TypeDoc](https://typedoc.org/) and outputs to the `docs` directory.
 ```sh

karma.conf.js

@@ -0,0 +1,34 @@
+const webpackConfig = require('./webpack.config.js');
+
+module.exports = function(config) {
+  config.set({
+    basePath: '',
+    browsers: ['ChromeHeadless'],
+    files: [
+      'test/setup.ts',
+      'test/unit/common/**/*.test.ts',
+      'test/unit/browser/**/*.test.ts',
+    ],
+    frameworks: ['mocha', 'chai', 'sinon', 'karma-typescript'],
+    reporters: ['mocha', 'karma-typescript'],
+    karmaTypescriptConfig: {
+      compilerOptions: {
+        module: "commonjs"
+      },
+      tsconfig: "./tsconfig.json"
+    },
+    preprocessors: {
+      '**/*.ts': ['webpack']
+    },
+    webpack: webpackConfig,
+    webpackMiddleware: {
+      stats: 'errors-only',
+    },
+    autoWatch: true,
+    singleRun: true,
+    concurrency: Infinity,
+    port: 9876,
+    logLevel: config.LOG_INFO,
+    colors: true,
+  })
+}

nodemon.json

@@ -0,0 +1,4 @@
+{
+  "ext": "ts,json",
+  "watch": "src"
+}

nodemon.test.json

@@ -0,0 +1,4 @@
+{
+  "ext": "ts,json",
+  "watch": ["src", "test"]
+}

package.json

@@ -21,10 +21,28 @@
   },
   "homepage": "https://github.com/groupby/sfx-logic#readme",
   "devDependencies": {
+    "@istanbuljs/nyc-config-typescript": "^0.1.3",
     "@strictsoftware/typedoc-plugin-monorepo": "^0.2.1",
+    "@types/mocha": "^5.2.7",
     "@types/node": "^12.0.8",
+    "chai": "^4.2.0",
+    "karma": "^4.1.0",
+    "karma-chai": "^0.1.0",
+    "karma-chrome-launcher": "^2.2.0",
+    "karma-mocha": "^1.3.0",
+    "karma-mocha-reporter": "^2.2.5",
+    "karma-sinon": "^1.0.5",
+    "karma-typescript": "^4.1.0",
+    "karma-typescript-preprocessor": "^0.4.0",
+    "karma-webpack": "^4.0.2",
+    "mocha": "^6.1.4",
     "nodemon": "^1.19.1",
+    "nyc": "^14.1.1",
+    "sinon": "^7.3.2",
+    "sinon-chai": "^3.3.0",
+    "source-map-support": "^0.5.12",
     "ts-loader": "^6.0.3",
+    "ts-node": "^8.3.0",
     "typedoc": "^0.14.2",
     "typedoc-plugin-nojekyll": "^1.0.1",
     "typescript": "^3.5.2",

packages/@sfx/sayt-plugin/karma.conf.js

@@ -0,0 +1 @@
+module.exports = require('../../../karma.conf.js');

packages/@sfx/sayt-plugin/package.json

@@ -5,8 +5,11 @@
   "main": "src/index.ts",
   "scripts": {
     "build": "../../../scripts/build.sh",
-    "dev": "nodemon --watch src --exec npm run build",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "dev": "nodemon --config ../../../nodemon.json --exec npm run build",
+    "test": "nyc mocha",
+    "tdd": "nodemon --config ../../../nodemon.test.json --exec npm test",
+    "test:browser": "karma start karma.conf.js",
+    "tdd:browser": "karma start karma.conf.js --no-single-run"
   },
   "repository": {
     "type": "git",

packages/@sfx/sayt-plugin/src/index.ts

@@ -3,14 +3,18 @@
  */
 const testObj = {
   label: 'test text',
+  number: 6,
 }
 
-const testFunc = (text: TestInterface) => {
-  console.log(`I am logging out ${ text.label }`);
+export const testFunc = (data: DummyInterface) => {
+  return exports.getLabel(data).toUpperCase();
 }
 
-testFunc(testObj);
+export const getLabel = (data: DummyInterface) => {
+  return data.label;
+}
 
-interface TestInterface {
+export interface DummyInterface {
   label: string;
+  number: number;
 }

packages/@sfx/sayt-plugin/test/setup.ts

@@ -0,0 +1 @@
+import '../../../../test/setup';

packages/@sfx/sayt-plugin/test/unit/browser/index.test.ts

@@ -0,0 +1,20 @@
+import { expect, stub } from '../../utils';
+import * as Sample from '../../../src';
+
+describe('Test Import Browser', () => {
+  let testData: Sample.DummyInterface = {
+    label: 'test',
+    number: 6,
+  };
+  it('should return the label string capitalized', () => {
+    expect(Sample.testFunc(testData)).to.equal('TEST');
+  });
+  it('should call a function to get the label value', () => {
+    const getLabelStub = stub(Sample, 'getLabel').returns('other return string');
+    Sample.testFunc(testData);
+    expect(getLabelStub).to.be.calledOnce;
+  });
+  it('test', () => {
+    expect(Sample.getLabel(testData)).to.equal('test');
+  });
+});

packages/@sfx/sayt-plugin/test/unit/common/index.test.ts

@@ -0,0 +1,20 @@
+import { expect, stub } from '../../utils';
+import * as Sample from '../../../src';
+
+describe('Test Import Common', () => {
+  let testData: Sample.DummyInterface = {
+    label: 'test',
+    number: 6,
+  };
+  it('should return the label string capitalized', () => {
+    expect(Sample.testFunc(testData)).to.equal('TEST');
+  });
+  it('should call a function to get the label value', () => {
+    const getLabelStub = stub(Sample, 'getLabel').returns('other return string');
+    Sample.testFunc(testData);
+    expect(getLabelStub).to.be.calledOnce;
+  });
+  it('test', () => {
+    expect(Sample.getLabel(testData)).to.equal('test');
+  });
+});

packages/@sfx/sayt-plugin/test/unit/node/index.test.ts

@@ -0,0 +1,20 @@
+import { expect, stub } from '../../utils';
+import * as Sample from '../../../src';
+
+describe('Test Import Node', () => {
+  let testData: Sample.DummyInterface = {
+    label: 'test',
+    number: 6,
+  };
+  it('should return the label string capitalized', () => {
+    expect(Sample.testFunc(testData)).to.equal('TEST');
+  });
+  it('should call a function to get the label value', () => {
+    const getLabelStub = stub(Sample, 'getLabel').returns('other return string');
+    Sample.testFunc(testData);
+    expect(getLabelStub).to.be.calledOnce;
+  });
+  it('test', () => {
+    expect(Sample.getLabel(testData)).to.equal('test');
+  });
+});

packages/@sfx/sayt-plugin/test/utils.ts

@@ -0,0 +1 @@
+export * from '../../../../test/utils';

packages/@sfx/sayt-plugin/tsconfig.json

@@ -7,7 +7,8 @@
       "dom"
     ],
     "types": [
-      "node"
+      "node",
+      "mocha"
     ],
     "module": "commonjs",
     "moduleResolution": "node",

test/setup.ts

@@ -0,0 +1,8 @@
+import { chai, sinon } from './utils';
+import * as sinonChai from 'sinon-chai';
+
+chai.use(sinonChai);
+
+afterEach(() => {
+  sinon.restore();
+});

test/utils.ts

@@ -0,0 +1,10 @@
+import * as sinonImport from 'sinon';
+import * as chaiImport from 'chai';
+
+declare var global: any;
+
+export const sinon = global.sinon || sinonImport;
+export const chai = global.chai || chaiImport;
+export const expect = chai.expect;
+export const stub = sinon.stub;
+export const spy = sinon.spy;

tsconfig.json

@@ -7,7 +7,8 @@
       "dom"
     ],
     "types": [
-      "node"
+      "node",
+      "mocha"
     ],
     "module": "commonjs",
     "moduleResolution": "node",

webpack.config.js

@@ -5,7 +5,7 @@ module.exports = {
   mode: 'development',
 
   entry: {
-    plugins: './presets/plugins.ts',
+    plugins: path.resolve(__dirname, 'presets/plugins.ts'),
   },
 
   devtool: 'source-map',