1.0.11

update to latest standards

See merge request !1

README.md

@@ -18,22 +18,6 @@ tap bundled for tapbuffer
 [![node](https://img.shields.io/badge/node->=%206.x.x-blue.svg)](https://nodejs.org/dist/latest-v6.x/docs/api/)
 [![JavaScript Style Guide](https://img.shields.io/badge/code%20style-standard-brightgreen.svg)](http://standardjs.com/)
 
-## Usage
-Use TypeScript for best in class instellisense.
-
-note this package includes
-
-* tap
-* chai
-* chai-as-promised
-* @types/tap
-* @types/chai
-* @types/chai-as-promised
-
-```javascript
-import {tap, expect} from 'tapbundle' // has typings in place
-```
-
 For further information read the linked docs at the top of this README.
 
 > MIT licensed | **©** [Lossless GmbH](https://lossless.gmbh)

dist/index.d.ts

@@ -1,4 +1,4 @@
 import 'typings-global';
 import { expect } from 'smartchai';
-import { tap } from './tapbundle.tap';
+import { tap } from './tapbundle.classes.tap';
 export { tap, expect };

dist/index.js

@@ -3,6 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 require("typings-global");
 const smartchai_1 = require("smartchai");
 exports.expect = smartchai_1.expect;
-const tapbundle_tap_1 = require("./tapbundle.tap");
-exports.tap = tapbundle_tap_1.tap;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQUFBLDBCQUF1QjtBQUN2Qix5Q0FBa0M7QUFNaEMsaUJBTk8sa0JBQU0sQ0FNUDtBQUxSLG1EQUFxQztBQUluQyxjQUpPLG1CQUFHLENBSVAifQ==
+const tapbundle_classes_tap_1 = require("./tapbundle.classes.tap");
+exports.tap = tapbundle_classes_tap_1.tap;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQUFBLDBCQUF1QjtBQUN2Qix5Q0FBa0M7QUFLaEMsaUJBTE8sa0JBQU0sQ0FLUDtBQUpSLG1FQUE2QztBQUczQyxjQUhPLDJCQUFHLENBR1AifQ==

dist/tapbundle.classes.tap.d.ts

@@ -1,34 +1,15 @@
-export declare type TTestStatus = 'success' | 'error' | 'pending' | 'errorAfterSuccess';
-export interface ITestFunction {
-    (): Promise<any>;
-}
-export declare class TapTest {
-    description: string;
-    testFunction: ITestFunction;
-    status: TTestStatus;
-    parallel: boolean;
-    returnValue: any;
-    /**
-     * constructor
-     */
-    constructor(optionsArg: {
-        description: string;
-        testFunction: ITestFunction;
-        parallel: boolean;
-    });
-    /**
-     * run the test
-     */
-    run(testKeyArg: number): Promise<void>;
-}
+import { TapTest, ITestFunction } from './tapbundle.classes.taptest';
 export declare class Tap {
+    skip: {
+        test: (...args: any[]) => void;
+    };
     private _tests;
     /**
      * Normal test function, will run one by one
      * @param testDescription - A description of what the test does
      * @param testFunction - A Function that returns a Promise and resolves or rejects
      */
-    test(testDescription: string, testFunction: ITestFunction): Promise<void>;
+    test(testDescription: string, testFunction: ITestFunction): Promise<TapTest>;
     /**
      * A parallel test that will not be waited for before the next starts.
      * @param testDescription - A description of what the test does

dist/tapbundle.classes.tap.js

@@ -0,0 +1,90 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : new P(function (resolve) { resolve(result.value); }).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const tapbundle_classes_taptest_1 = require("./tapbundle.classes.taptest");
+class Tap {
+    constructor() {
+        this.skip = {
+            test: (...args) => {
+                console.log('skipped');
+            }
+        };
+        this._tests = [];
+    }
+    /**
+     * Normal test function, will run one by one
+     * @param testDescription - A description of what the test does
+     * @param testFunction - A Function that returns a Promise and resolves or rejects
+     */
+    test(testDescription, testFunction) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let localTest = new tapbundle_classes_taptest_1.TapTest({
+                description: testDescription,
+                testFunction: testFunction,
+                parallel: false
+            });
+            this._tests.push(localTest);
+            return localTest;
+        });
+    }
+    /**
+     * A parallel test that will not be waited for before the next starts.
+     * @param testDescription - A description of what the test does
+     * @param testFunction - A Function that returns a Promise and resolves or rejects
+     */
+    testParallel(testDescription, testFunction) {
+        this._tests.push(new tapbundle_classes_taptest_1.TapTest({
+            description: testDescription,
+            testFunction: testFunction,
+            parallel: true
+        }));
+    }
+    /**
+     * tests leakage
+     * @param testDescription - A description of what the test does
+     * @param testFunction - A Function that returns a Promise and resolves or rejects
+     */
+    testLeakage(testDescription, testFunction) {
+    }
+    /**
+     * starts the test evaluation
+     */
+    start() {
+        return __awaiter(this, void 0, void 0, function* () {
+            let promiseArray = [];
+            // safeguard against empty test array
+            if (this._tests.length === 0) {
+                console.log('no tests specified. Ending here!');
+                return;
+            }
+            console.log(`1..${this._tests.length}`);
+            for (let testKey = 0; testKey < this._tests.length; testKey++) {
+                let currentTest = this._tests[testKey];
+                let testPromise = currentTest.run(testKey);
+                if (currentTest.parallel) {
+                    promiseArray.push(testPromise);
+                }
+                else {
+                    yield testPromise;
+                }
+            }
+            yield Promise.all(promiseArray);
+        });
+    }
+    /**
+     * handle errors
+     */
+    threw(err) {
+        console.log(err);
+    }
+}
+exports.Tap = Tap;
+exports.tap = new Tap();
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGFwYnVuZGxlLmNsYXNzZXMudGFwLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvdGFwYnVuZGxlLmNsYXNzZXMudGFwLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7QUFFQSwyRUFBb0U7QUFFcEU7SUFBQTtRQUNFLFNBQUksR0FBRztZQUNMLElBQUksRUFBRSxDQUFDLEdBQUcsSUFBSTtnQkFDWixPQUFPLENBQUMsR0FBRyxDQUFDLFNBQVMsQ0FBQyxDQUFBO1lBQ3hCLENBQUM7U0FDRixDQUFBO1FBRU8sV0FBTSxHQUFjLEVBQUUsQ0FBQTtJQXNFaEMsQ0FBQztJQXBFQzs7OztPQUlHO0lBQ0csSUFBSSxDQUFDLGVBQXVCLEVBQUUsWUFBMkI7O1lBQzdELElBQUksU0FBUyxHQUFHLElBQUksbUNBQU8sQ0FBQztnQkFDMUIsV0FBVyxFQUFFLGVBQWU7Z0JBQzVCLFlBQVksRUFBRSxZQUFZO2dCQUMxQixRQUFRLEVBQUUsS0FBSzthQUNoQixDQUFDLENBQUE7WUFDRixJQUFJLENBQUMsTUFBTSxDQUFDLElBQUksQ0FBQyxTQUFTLENBQUMsQ0FBQTtZQUMzQixNQUFNLENBQUMsU0FBUyxDQUFBO1FBQ2xCLENBQUM7S0FBQTtJQUVEOzs7O09BSUc7SUFDSCxZQUFZLENBQUMsZUFBdUIsRUFBRSxZQUEyQjtRQUMvRCxJQUFJLENBQUMsTUFBTSxDQUFDLElBQUksQ0FBQyxJQUFJLG1DQUFPLENBQUM7WUFDM0IsV0FBVyxFQUFFLGVBQWU7WUFDNUIsWUFBWSxFQUFFLFlBQVk7WUFDMUIsUUFBUSxFQUFFLElBQUk7U0FDZixDQUFDLENBQUMsQ0FBQTtJQUNMLENBQUM7SUFFRDs7OztPQUlHO0lBQ0gsV0FBVyxDQUFDLGVBQXVCLEVBQUUsWUFBMkI7SUFFaEUsQ0FBQztJQUVEOztPQUVHO0lBQ0csS0FBSzs7WUFDVCxJQUFJLFlBQVksR0FBbUIsRUFBRSxDQUFBO1lBRXJDLHFDQUFxQztZQUNyQyxFQUFFLENBQUMsQ0FBQyxJQUFJLENBQUMsTUFBTSxDQUFDLE1BQU0sS0FBSyxDQUFDLENBQUMsQ0FBQyxDQUFDO2dCQUM3QixPQUFPLENBQUMsR0FBRyxDQUFDLGtDQUFrQyxDQUFDLENBQUE7Z0JBQy9DLE1BQU0sQ0FBQTtZQUNSLENBQUM7WUFFRCxPQUFPLENBQUMsR0FBRyxDQUFDLE1BQU0sSUFBSSxDQUFDLE1BQU0sQ0FBQyxNQUFNLEVBQUUsQ0FBQyxDQUFBO1lBQ3ZDLEdBQUcsQ0FBQyxDQUFDLElBQUksT0FBTyxHQUFHLENBQUMsRUFBRSxPQUFPLEdBQUcsSUFBSSxDQUFDLE1BQU0sQ0FBQyxNQUFNLEVBQUUsT0FBTyxFQUFFLEVBQUUsQ0FBQztnQkFDOUQsSUFBSSxXQUFXLEdBQUcsSUFBSSxDQUFDLE1BQU0sQ0FBRSxPQUFPLENBQUUsQ0FBQTtnQkFDeEMsSUFBSSxXQUFXLEdBQUcsV0FBVyxDQUFDLEdBQUcsQ0FBQyxPQUFPLENBQUMsQ0FBQTtnQkFDMUMsRUFBRSxDQUFDLENBQUMsV0FBVyxDQUFDLFFBQVEsQ0FBQyxDQUFDLENBQUM7b0JBQ3pCLFlBQVksQ0FBQyxJQUFJLENBQUMsV0FBVyxDQUFDLENBQUE7Z0JBQ2hDLENBQUM7Z0JBQUMsSUFBSSxDQUFDLENBQUM7b0JBQ04sTUFBTSxXQUFXLENBQUE7Z0JBQ25CLENBQUM7WUFDSCxDQUFDO1lBQ0QsTUFBTSxPQUFPLENBQUMsR0FBRyxDQUFDLFlBQVksQ0FBQyxDQUFBO1FBQ2pDLENBQUM7S0FBQTtJQUVEOztPQUVHO0lBQ0gsS0FBSyxDQUFDLEdBQUc7UUFDUCxPQUFPLENBQUMsR0FBRyxDQUFDLEdBQUcsQ0FBQyxDQUFBO0lBQ2xCLENBQUM7Q0FDRjtBQTdFRCxrQkE2RUM7QUFFVSxRQUFBLEdBQUcsR0FBRyxJQUFJLEdBQUcsRUFBRSxDQUFBIn0=

dist/tapbundle.classes.taptest.d.ts

@@ -0,0 +1,30 @@
+import { TapTools } from './tapbundle.classes.taptools';
+import { HrtMeasurement } from 'early';
+import { Deferred } from 'smartq';
+export declare type TTestStatus = 'success' | 'error' | 'pending' | 'errorAfterSuccess' | 'timeout';
+export interface ITestFunction {
+    (tapTools?: TapTools): Promise<any>;
+}
+export declare class TapTest {
+    description: string;
+    failureAllowed: boolean;
+    hrtMeasurement: HrtMeasurement;
+    parallel: boolean;
+    status: TTestStatus;
+    tapTools: TapTools;
+    testFunction: ITestFunction;
+    testDeferred: Deferred<TapTest>;
+    testPromise: Promise<TapTest>;
+    /**
+     * constructor
+     */
+    constructor(optionsArg: {
+        description: string;
+        testFunction: ITestFunction;
+        parallel: boolean;
+    });
+    /**
+     * run the test
+     */
+    run(testKeyArg: number): Promise<void>;
+}

dist/tapbundle.classes.taptest.js

@@ -0,0 +1,64 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : new P(function (resolve) { resolve(result.value); }).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const plugins = require("./tapbundle.plugins");
+const tapbundle_classes_taptools_1 = require("./tapbundle.classes.taptools");
+// imported interfaces
+const early_1 = require("early");
+class TapTest {
+    /**
+     * constructor
+     */
+    constructor(optionsArg) {
+        this.testDeferred = plugins.smartq.defer();
+        this.testPromise = this.testDeferred.promise;
+        this.description = optionsArg.description;
+        this.hrtMeasurement = new early_1.HrtMeasurement();
+        this.parallel = optionsArg.parallel;
+        this.status = 'pending';
+        this.tapTools = new tapbundle_classes_taptools_1.TapTools(this);
+        this.testFunction = optionsArg.testFunction;
+    }
+    /**
+     * run the test
+     */
+    run(testKeyArg) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.hrtMeasurement.start();
+            try {
+                yield this.testFunction(this.tapTools);
+                if (this.status === 'timeout') {
+                    throw new Error('Test succeeded, but timed out...');
+                }
+                this.hrtMeasurement.stop();
+                console.log(`ok ${testKeyArg + 1} - ${this.description} # time=${this.hrtMeasurement.milliSeconds}ms`);
+                this.status = 'success';
+                this.testDeferred.resolve(this);
+            }
+            catch (err) {
+                this.hrtMeasurement.stop();
+                console.log(`not ok ${testKeyArg + 1} - ${this.description} # time=${this.hrtMeasurement.milliSeconds}ms`);
+                this.testDeferred.reject();
+                // if the test has already succeeded before
+                if (this.status === 'success') {
+                    this.status = 'errorAfterSuccess';
+                    console.log('!!! ALERT !!!: weird behaviour, since test has been already successfull');
+                }
+                // if the test is allowed to fail
+                if (this.failureAllowed) {
+                    console.log(`please note: failure allowed!`);
+                }
+                console.log(err);
+            }
+        });
+    }
+}
+exports.TapTest = TapTest;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGFwYnVuZGxlLmNsYXNzZXMudGFwdGVzdC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL3RhcGJ1bmRsZS5jbGFzc2VzLnRhcHRlc3QudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7OztBQUFBLCtDQUE4QztBQUU5Qyw2RUFBdUQ7QUFFdkQsc0JBQXNCO0FBQ3RCLGlDQUFzQztBQVd0QztJQVVFOztPQUVHO0lBQ0gsWUFBYSxVQUlaO1FBVEQsaUJBQVksR0FBc0IsT0FBTyxDQUFDLE1BQU0sQ0FBQyxLQUFLLEVBQUUsQ0FBQTtRQUN4RCxnQkFBVyxHQUFxQixJQUFJLENBQUMsWUFBWSxDQUFDLE9BQU8sQ0FBQTtRQVN2RCxJQUFJLENBQUMsV0FBVyxHQUFHLFVBQVUsQ0FBQyxXQUFXLENBQUE7UUFDekMsSUFBSSxDQUFDLGNBQWMsR0FBRyxJQUFJLHNCQUFjLEVBQUUsQ0FBQTtRQUMxQyxJQUFJLENBQUMsUUFBUSxHQUFHLFVBQVUsQ0FBQyxRQUFRLENBQUE7UUFDbkMsSUFBSSxDQUFDLE1BQU0sR0FBRyxTQUFTLENBQUE7UUFDdkIsSUFBSSxDQUFDLFFBQVEsR0FBRyxJQUFJLHFDQUFRLENBQUMsSUFBSSxDQUFDLENBQUE7UUFDbEMsSUFBSSxDQUFDLFlBQVksR0FBRyxVQUFVLENBQUMsWUFBWSxDQUFBO0lBQzdDLENBQUM7SUFFRDs7T0FFRztJQUNHLEdBQUcsQ0FBRSxVQUFrQjs7WUFDM0IsSUFBSSxDQUFDLGNBQWMsQ0FBQyxLQUFLLEVBQUUsQ0FBQTtZQUMzQixJQUFJLENBQUM7Z0JBQ0gsTUFBTSxJQUFJLENBQUMsWUFBWSxDQUFDLElBQUksQ0FBQyxRQUFRLENBQUMsQ0FBQTtnQkFDdEMsRUFBRSxDQUFDLENBQUMsSUFBSSxDQUFDLE1BQU0sS0FBSyxTQUFTLENBQUMsQ0FBQyxDQUFDO29CQUM5QixNQUFNLElBQUksS0FBSyxDQUFFLGtDQUFrQyxDQUFDLENBQUE7Z0JBQ3RELENBQUM7Z0JBQ0QsSUFBSSxDQUFDLGNBQWMsQ0FBQyxJQUFJLEVBQUUsQ0FBQTtnQkFDMUIsT0FBTyxDQUFDLEdBQUcsQ0FBQyxNQUFNLFVBQVUsR0FBRyxDQUFDLE1BQU0sSUFBSSxDQUFDLFdBQVcsV0FBVyxJQUFJLENBQUMsY0FBYyxDQUFDLFlBQVksSUFBSSxDQUFDLENBQUE7Z0JBQ3RHLElBQUksQ0FBQyxNQUFNLEdBQUcsU0FBUyxDQUFBO2dCQUN2QixJQUFJLENBQUMsWUFBWSxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQTtZQUNqQyxDQUFDO1lBQUMsS0FBSyxDQUFDLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBQztnQkFDYixJQUFJLENBQUMsY0FBYyxDQUFDLElBQUksRUFBRSxDQUFBO2dCQUMxQixPQUFPLENBQUMsR0FBRyxDQUFDLFVBQVUsVUFBVSxHQUFHLENBQUMsTUFBTSxJQUFJLENBQUMsV0FBVyxXQUFXLElBQUksQ0FBQyxjQUFjLENBQUMsWUFBWSxJQUFJLENBQUMsQ0FBQTtnQkFDMUcsSUFBSSxDQUFDLFlBQVksQ0FBQyxNQUFNLEVBQUUsQ0FBQTtnQkFFMUIsMkNBQTJDO2dCQUMzQyxFQUFFLENBQUMsQ0FBQyxJQUFJLENBQUMsTUFBTSxLQUFLLFNBQVMsQ0FBQyxDQUFDLENBQUM7b0JBQzlCLElBQUksQ0FBQyxNQUFNLEdBQUcsbUJBQW1CLENBQUE7b0JBQ2pDLE9BQU8sQ0FBQyxHQUFHLENBQUMseUVBQXlFLENBQUMsQ0FBQTtnQkFDeEYsQ0FBQztnQkFFRCxpQ0FBaUM7Z0JBQ2pDLEVBQUUsQ0FBQyxDQUFDLElBQUksQ0FBQyxjQUFjLENBQUMsQ0FBQyxDQUFDO29CQUN4QixPQUFPLENBQUMsR0FBRyxDQUFDLCtCQUErQixDQUFDLENBQUE7Z0JBQzlDLENBQUM7Z0JBQ0QsT0FBTyxDQUFDLEdBQUcsQ0FBQyxHQUFHLENBQUMsQ0FBQTtZQUNsQixDQUFDO1FBQ0gsQ0FBQztLQUFBO0NBQ0Y7QUExREQsMEJBMERDIn0=

dist/tapbundle.classes.taptools.d.ts

@@ -0,0 +1,16 @@
+export declare class TapTools {
+    /**
+     * the referenced TapTest
+     */
+    private _tapTest;
+    constructor(TapTestArg: any);
+    /**
+     * allow failure
+     */
+    allowFailure(): void;
+    /**
+     * async/await delay method
+     */
+    delayFor(timeMilliArg: any): Promise<void>;
+    timeout(timeMilliArg: number): Promise<void>;
+}

dist/tapbundle.classes.taptools.js

@@ -0,0 +1,40 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : new P(function (resolve) { resolve(result.value); }).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const plugins = require("./tapbundle.plugins");
+class TapTools {
+    constructor(TapTestArg) {
+        this._tapTest = TapTestArg;
+    }
+    /**
+     * allow failure
+     */
+    allowFailure() {
+        this._tapTest.failureAllowed = true;
+    }
+    /**
+     * async/await delay method
+     */
+    delayFor(timeMilliArg) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield plugins.smartdelay.delayFor(timeMilliArg);
+        });
+    }
+    timeout(timeMilliArg) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield plugins.smartdelay.delayFor(timeMilliArg);
+            if (this._tapTest.status === 'pending') {
+                this._tapTest.status = 'timeout';
+            }
+        });
+    }
+}
+exports.TapTools = TapTools;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGFwYnVuZGxlLmNsYXNzZXMudGFwdG9vbHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy90YXBidW5kbGUuY2xhc3Nlcy50YXB0b29scy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7O0FBQUEsK0NBQThDO0FBRzlDO0lBT0UsWUFBWSxVQUFVO1FBQ3BCLElBQUksQ0FBQyxRQUFRLEdBQUcsVUFBVSxDQUFBO0lBQzVCLENBQUM7SUFFRDs7T0FFRztJQUNILFlBQVk7UUFDVixJQUFJLENBQUMsUUFBUSxDQUFDLGNBQWMsR0FBRyxJQUFJLENBQUE7SUFDckMsQ0FBQztJQUVEOztPQUVHO0lBQ0csUUFBUSxDQUFDLFlBQVk7O1lBQ3pCLE1BQU0sT0FBTyxDQUFDLFVBQVUsQ0FBQyxRQUFRLENBQUMsWUFBWSxDQUFDLENBQUE7UUFDakQsQ0FBQztLQUFBO0lBRUssT0FBTyxDQUFFLFlBQW9COztZQUNqQyxNQUFNLE9BQU8sQ0FBQyxVQUFVLENBQUMsUUFBUSxDQUFDLFlBQVksQ0FBQyxDQUFBO1lBQy9DLEVBQUUsQ0FBQyxDQUFDLElBQUksQ0FBQyxRQUFRLENBQUMsTUFBTSxLQUFLLFNBQVMsQ0FBQyxDQUFDLENBQUM7Z0JBQ3ZDLElBQUksQ0FBQyxRQUFRLENBQUMsTUFBTSxHQUFHLFNBQVMsQ0FBQTtZQUNsQyxDQUFDO1FBQ0gsQ0FBQztLQUFBO0NBRUY7QUFoQ0QsNEJBZ0NDIn0=

dist/tapbundle.plugins.d.ts

@@ -1,4 +1,6 @@
 import 'typings-global';
-import * as smartq from 'smartq';
+import * as early from 'early';
 import * as leakage from 'leakage';
-export { smartq, leakage };
+import * as smartdelay from 'smartdelay';
+import * as smartq from 'smartq';
+export { early, smartdelay, smartq, leakage };

dist/tapbundle.plugins.js

@@ -1,8 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 require("typings-global");
-const smartq = require("smartq");
-exports.smartq = smartq;
+const early = require("early");
+exports.early = early;
 const leakage = require("leakage");
 exports.leakage = leakage;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGFwYnVuZGxlLnBsdWdpbnMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy90YXBidW5kbGUucGx1Z2lucy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQUFBLDBCQUF1QjtBQUN2QixpQ0FBZ0M7QUFJOUIsd0JBQU07QUFIUixtQ0FBa0M7QUFJaEMsMEJBQU8ifQ==
+const smartdelay = require("smartdelay");
+exports.smartdelay = smartdelay;
+const smartq = require("smartq");
+exports.smartq = smartq;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGFwYnVuZGxlLnBsdWdpbnMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy90YXBidW5kbGUucGx1Z2lucy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQUFBLDBCQUF1QjtBQUN2QiwrQkFBOEI7QUFNNUIsc0JBQUs7QUFMUCxtQ0FBa0M7QUFRaEMsMEJBQU87QUFQVCx5Q0FBd0M7QUFLdEMsZ0NBQVU7QUFKWixpQ0FBZ0M7QUFLOUIsd0JBQU0ifQ==

dist/tapbundle.tap.js

@@ -1,114 +0,0 @@
-"use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : new P(function (resolve) { resolve(result.value); }).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-class TapTest {
-    /**
-     * constructor
-     */
-    constructor(optionsArg) {
-        this.description = optionsArg.description;
-        this.testFunction = optionsArg.testFunction;
-        this.parallel = optionsArg.parallel;
-        this.status = 'pending';
-    }
-    /**
-     * run the test
-     */
-    run(testKeyArg) {
-        return __awaiter(this, void 0, void 0, function* () {
-            try {
-                yield this.testFunction();
-                console.log(`ok ${testKeyArg + 1} - ${this.description} # time=20.040ms`);
-                this.status = 'success';
-            }
-            catch (err) {
-                console.log(`not ok ${testKeyArg + 1} - ${this.description} # time=20.040ms`);
-                if (this.status === 'success') {
-                    this.status = 'errorAfterSuccess';
-                    console.log('!!! ALERT !!!: weird behaviour, since test has been already successfull');
-                }
-                console.log(err);
-            }
-        });
-    }
-}
-exports.TapTest = TapTest;
-class Tap {
-    constructor() {
-        this._tests = [];
-    }
-    /**
-     * Normal test function, will run one by one
-     * @param testDescription - A description of what the test does
-     * @param testFunction - A Function that returns a Promise and resolves or rejects
-     */
-    test(testDescription, testFunction) {
-        return __awaiter(this, void 0, void 0, function* () {
-            this._tests.push(new TapTest({
-                description: testDescription,
-                testFunction: testFunction,
-                parallel: false
-            }));
-        });
-    }
-    /**
-     * A parallel test that will not be waited for before the next starts.
-     * @param testDescription - A description of what the test does
-     * @param testFunction - A Function that returns a Promise and resolves or rejects
-     */
-    testParallel(testDescription, testFunction) {
-        this._tests.push(new TapTest({
-            description: testDescription,
-            testFunction: testFunction,
-            parallel: true
-        }));
-    }
-    /**
-     * tests leakage
-     * @param testDescription - A description of what the test does
-     * @param testFunction - A Function that returns a Promise and resolves or rejects
-     */
-    testLeakage(testDescription, testFunction) {
-    }
-    /**
-     * starts the test evaluation
-     */
-    start() {
-        return __awaiter(this, void 0, void 0, function* () {
-            let promiseArray = [];
-            // safeguard against empty test array
-            if (this._tests.length === 0) {
-                console.log('no tests specified. Ending here!');
-                return;
-            }
-            console.log(`1..${this._tests.length}`);
-            for (let testKey = 0; testKey < this._tests.length; testKey++) {
-                let currentTest = this._tests[testKey];
-                let testPromise = currentTest.run(testKey);
-                if (currentTest.parallel) {
-                    promiseArray.push(testPromise);
-                }
-                else {
-                    yield testPromise;
-                }
-            }
-            yield Promise.all(promiseArray);
-        });
-    }
-    /**
-     * handle errors
-     */
-    threw(err) {
-        console.log(err);
-    }
-}
-exports.Tap = Tap;
-exports.tap = new Tap();
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGFwYnVuZGxlLnRhcC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL3RhcGJ1bmRsZS50YXAudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7OztBQVlBO0lBT0U7O09BRUc7SUFDSCxZQUFhLFVBSVo7UUFDQyxJQUFJLENBQUMsV0FBVyxHQUFHLFVBQVUsQ0FBQyxXQUFXLENBQUE7UUFDekMsSUFBSSxDQUFDLFlBQVksR0FBRyxVQUFVLENBQUMsWUFBWSxDQUFBO1FBQzNDLElBQUksQ0FBQyxRQUFRLEdBQUcsVUFBVSxDQUFDLFFBQVEsQ0FBQTtRQUNuQyxJQUFJLENBQUMsTUFBTSxHQUFHLFNBQVMsQ0FBQTtJQUN6QixDQUFDO0lBRUQ7O09BRUc7SUFDRyxHQUFHLENBQUUsVUFBa0I7O1lBQzNCLElBQUksQ0FBQztnQkFDSCxNQUFNLElBQUksQ0FBQyxZQUFZLEVBQUUsQ0FBQTtnQkFDekIsT0FBTyxDQUFDLEdBQUcsQ0FBQyxNQUFNLFVBQVUsR0FBRyxDQUFDLE1BQU0sSUFBSSxDQUFDLFdBQVcsa0JBQWtCLENBQUMsQ0FBQTtnQkFDekUsSUFBSSxDQUFDLE1BQU0sR0FBRyxTQUFTLENBQUE7WUFDekIsQ0FBQztZQUFDLEtBQUssQ0FBQyxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUM7Z0JBQ2IsT0FBTyxDQUFDLEdBQUcsQ0FBQyxVQUFVLFVBQVUsR0FBRyxDQUFDLE1BQU0sSUFBSSxDQUFDLFdBQVcsa0JBQWtCLENBQUMsQ0FBQTtnQkFDN0UsRUFBRSxDQUFDLENBQUMsSUFBSSxDQUFDLE1BQU0sS0FBSyxTQUFTLENBQUMsQ0FBQyxDQUFDO29CQUM5QixJQUFJLENBQUMsTUFBTSxHQUFHLG1CQUFtQixDQUFBO29CQUNqQyxPQUFPLENBQUMsR0FBRyxDQUFDLHlFQUF5RSxDQUFDLENBQUE7Z0JBQ3hGLENBQUM7Z0JBQ0QsT0FBTyxDQUFDLEdBQUcsQ0FBQyxHQUFHLENBQUMsQ0FBQTtZQUNsQixDQUFDO1FBQ0gsQ0FBQztLQUFBO0NBQ0Y7QUF0Q0QsMEJBc0NDO0FBRUQ7SUFBQTtRQUNVLFdBQU0sR0FBYyxFQUFFLENBQUE7SUFvRWhDLENBQUM7SUFsRUM7Ozs7T0FJRztJQUNHLElBQUksQ0FBRSxlQUF1QixFQUFFLFlBQTJCOztZQUM5RCxJQUFJLENBQUMsTUFBTSxDQUFDLElBQUksQ0FBQyxJQUFJLE9BQU8sQ0FBQztnQkFDM0IsV0FBVyxFQUFFLGVBQWU7Z0JBQzVCLFlBQVksRUFBRSxZQUFZO2dCQUMxQixRQUFRLEVBQUUsS0FBSzthQUNoQixDQUFDLENBQUMsQ0FBQTtRQUNMLENBQUM7S0FBQTtJQUVEOzs7O09BSUc7SUFDSCxZQUFZLENBQUUsZUFBdUIsRUFBRSxZQUEyQjtRQUNoRSxJQUFJLENBQUMsTUFBTSxDQUFDLElBQUksQ0FBQyxJQUFJLE9BQU8sQ0FBQztZQUMzQixXQUFXLEVBQUUsZUFBZTtZQUM1QixZQUFZLEVBQUUsWUFBWTtZQUMxQixRQUFRLEVBQUUsSUFBSTtTQUNmLENBQUMsQ0FBQyxDQUFBO0lBQ0wsQ0FBQztJQUVEOzs7O09BSUc7SUFDSCxXQUFXLENBQUUsZUFBdUIsRUFBRSxZQUEyQjtJQUVqRSxDQUFDO0lBRUQ7O09BRUc7SUFDRyxLQUFLOztZQUNULElBQUksWUFBWSxHQUFtQixFQUFFLENBQUE7WUFFckMscUNBQXFDO1lBQ3JDLEVBQUUsQ0FBQyxDQUFDLElBQUksQ0FBQyxNQUFNLENBQUMsTUFBTSxLQUFLLENBQUMsQ0FBQyxDQUFDLENBQUM7Z0JBQzdCLE9BQU8sQ0FBQyxHQUFHLENBQUMsa0NBQWtDLENBQUMsQ0FBQTtnQkFDL0MsTUFBTSxDQUFBO1lBQ1IsQ0FBQztZQUVELE9BQU8sQ0FBQyxHQUFHLENBQUMsTUFBTSxJQUFJLENBQUMsTUFBTSxDQUFDLE1BQU0sRUFBRSxDQUFDLENBQUE7WUFDdkMsR0FBRyxDQUFDLENBQUMsSUFBSSxPQUFPLEdBQUcsQ0FBQyxFQUFFLE9BQU8sR0FBRyxJQUFJLENBQUMsTUFBTSxDQUFDLE1BQU0sRUFBRSxPQUFPLEVBQUUsRUFBRSxDQUFDO2dCQUM5RCxJQUFJLFdBQVcsR0FBRyxJQUFJLENBQUMsTUFBTSxDQUFDLE9BQU8sQ0FBQyxDQUFBO2dCQUN0QyxJQUFJLFdBQVcsR0FBRyxXQUFXLENBQUMsR0FBRyxDQUFDLE9BQU8sQ0FBQyxDQUFBO2dCQUMxQyxFQUFFLENBQUMsQ0FBQyxXQUFXLENBQUMsUUFBUSxDQUFDLENBQUMsQ0FBQztvQkFDekIsWUFBWSxDQUFDLElBQUksQ0FBQyxXQUFXLENBQUMsQ0FBQTtnQkFDaEMsQ0FBQztnQkFBQyxJQUFJLENBQUMsQ0FBQztvQkFDTixNQUFNLFdBQVcsQ0FBQTtnQkFDbkIsQ0FBQztZQUNILENBQUM7WUFDRCxNQUFNLE9BQU8sQ0FBQyxHQUFHLENBQUMsWUFBWSxDQUFDLENBQUE7UUFDakMsQ0FBQztLQUFBO0lBRUQ7O09BRUc7SUFDSCxLQUFLLENBQUUsR0FBRztRQUNSLE9BQU8sQ0FBQyxHQUFHLENBQUMsR0FBRyxDQUFDLENBQUE7SUFDbEIsQ0FBQztDQUNGO0FBckVELGtCQXFFQztBQUVVLFFBQUEsR0FBRyxHQUFHLElBQUksR0FBRyxFQUFFLENBQUEifQ==

docs/index.md

@@ -0,0 +1,79 @@
+# tapbundle
+tap bundled for tapbuffer
+
+## Availabililty
+[![npm](https://pushrocks.gitlab.io/assets/repo-button-npm.svg)](https://www.npmjs.com/package/tapbundle)
+[![git](https://pushrocks.gitlab.io/assets/repo-button-git.svg)](https://GitLab.com/pushrocks/tapbundle)
+[![git](https://pushrocks.gitlab.io/assets/repo-button-mirror.svg)](https://github.com/pushrocks/tapbundle)
+[![docs](https://pushrocks.gitlab.io/assets/repo-button-docs.svg)](https://pushrocks.gitlab.io/tapbundle/)
+
+## Status for master
+[![build status](https://GitLab.com/pushrocks/tapbundle/badges/master/build.svg)](https://GitLab.com/pushrocks/tapbundle/commits/master)
+[![coverage report](https://GitLab.com/pushrocks/tapbundle/badges/master/coverage.svg)](https://GitLab.com/pushrocks/tapbundle/commits/master)
+[![npm downloads per month](https://img.shields.io/npm/dm/tapbundle.svg)](https://www.npmjs.com/package/tapbundle)
+[![Dependency Status](https://david-dm.org/pushrocks/tapbundle.svg)](https://david-dm.org/pushrocks/tapbundle)
+[![bitHound Dependencies](https://www.bithound.io/github/pushrocks/tapbundle/badges/dependencies.svg)](https://www.bithound.io/github/pushrocks/tapbundle/master/dependencies/npm)
+[![bitHound Code](https://www.bithound.io/github/pushrocks/tapbundle/badges/code.svg)](https://www.bithound.io/github/pushrocks/tapbundle)
+[![TypeScript](https://img.shields.io/badge/TypeScript-2.x-blue.svg)](https://nodejs.org/dist/latest-v6.x/docs/api/)
+[![node](https://img.shields.io/badge/node->=%206.x.x-blue.svg)](https://nodejs.org/dist/latest-v6.x/docs/api/)
+[![JavaScript Style Guide](https://img.shields.io/badge/code%20style-standard-brightgreen.svg)](http://standardjs.com/)
+
+## Usage
+Use TypeScript for best in class instellisense.
+
+This package includes
+
+* tap compatible testing framework written in TypeScript
+* npm package chai (through smartchai)
+* npm package chai-as-promised (through smartchai)
+* npm package chai-string (through smartchai)
+* npm pacakge @types/chai (through smartchi)
+* npm package @types/chai-as-promised (through smartchai)
+* npm package @types/chai-string (through smartchai)
+
+It also implements its own tap testing engine, that is fully typed.
+
+In other words: This package is fully typed :)
+
+
+### Get started with writing your first test file.
+```javascript
+import {tap, expect} from 'tapbundle' // has typings in place
+
+import * as myAwesomeModuleToTest from '../dist/index' // '../dist/index' is the standard path for npmts modules
+
+tap.test('my awesome description', async (tools) => { // tools are optional parameter
+  tools.timeout(2000) // test will fail if it takes longer than 2000 millisenconds
+})
+
+let myTest2 = tap.test('my awesome test 2', async (tools) => {
+  myAwsomeModuleToTest.doSomethingAsync() // we don't wait here
+  await tools.delayFor(3000) // yay. promise based timeouts :)
+  console.log('This gets logged 3000 ms into the test')
+})
+
+tap.test('my awesome test 3', async (tools) => {
+  expect(true).to.be.true // will not throw
+  await expect(tools.delayFor(2000)).to.eventuall.be.fulfilled // yay expect promises :)
+  expect((await myTest2.promise).hrtMeasurement.milliSeconds > 1000).to.be.true // access other tests metadata :)
+})
+
+let myTest4 = tap.testParallel('my awesome test 4', async (tools) => {
+  await tools.delayFor(4000)
+  console.log('logs to console after 4 seconds into this test')
+})
+
+tap.test('my awesome test 5', async () => {
+  expect(myTest4.status).to.equal('pending') // since this test will likely finish before myTest4.
+})
+
+tap.start() // start the test, will automtically plan tests for you (so the tap parser knows when tests exit bofore they are finished)
+
+```
+
+For further information read the linked docs at the top of this README.
+
+> MIT licensed | **©** [Lossless GmbH](https://lossless.gmbh)
+| By using this npm module you agree to our [privacy policy](https://lossless.gmbH/privacy.html)
+
+[![repo-footer](https://pushrocks.gitlab.io/assets/repo-footer.svg)](https://push.rocks)

package.json

@@ -1,6 +1,6 @@
 {
   "name": "tapbundle",
-  "version": "1.0.7",
+  "version": "1.0.11",
   "description": "tap bundled for tapbuffer",
   "main": "dist/index.js",
   "typings": "dist/index.d.ts",
@@ -18,8 +18,10 @@
   },
   "homepage": "https://gitlab.com/pushrocks/tapbundle#README",
   "dependencies": {
+    "early": "^2.1.1",
     "leakage": "^0.2.0",
     "smartchai": "^1.0.3",
+    "smartdelay": "^1.0.1",
     "smartq": "^1.1.1",
     "typings-global": "^1.0.16"
   }

test/test.ts

@@ -1,7 +1,32 @@
 import { tap, expect } from '../dist/index'
 
-tap.test('my first test', async () => {
+let test1 = tap.test('my first test -> expect true to be true', async () => {
   return expect(true).to.be.true
 })
 
+let test2 = tap.test('my second test', async (tools) => {
+  await tools.delayFor(1000)
+})
+
+let test3 = tap.test('my third test -> test2 should take longer than test1 and endure at least 1000ms', async () => {
+  expect((await test1).hrtMeasurement.milliSeconds < (await test2).hrtMeasurement.milliSeconds).to.be.true
+  expect((await test2).hrtMeasurement.milliSeconds > 1000).to.be.true
+})
+
+let test4 = tap.skip.test('my 4th test -> should fail', async (tools) => {
+  tools.allowFailure()
+  expect(false).to.be.true
+})
+
+let test5 = tap.test('my 5th test -> should pass in about 500ms', async (tools) => {
+  tools.timeout(1000)
+  await tools.delayFor(500)
+})
+
+let test6 = tap.skip.test('my 6th test -> should fail after 1000ms', async (tools) => {
+  tools.allowFailure()
+  tools.timeout(1000)
+  await tools.delayFor(2000)
+})
+
 tap.start()

ts/index.ts

@@ -1,7 +1,6 @@
 import 'typings-global'
 import { expect } from 'smartchai'
-import { tap } from './tapbundle.tap'
-
+import { tap } from './tapbundle.classes.tap'
 
 export {
   tap,

ts/tapbundle.classes.tap.ts

@@ -1,56 +1,14 @@
 import * as plugins from './tapbundle.plugins'
 
-import { tapCreator } from './tapbundle.tapcreator'
-
-// interfaces
-export type TTestStatus = 'success' | 'error' | 'pending' | 'errorAfterSuccess'
-
-export interface ITestFunction {
-  (): Promise<any>
-}
-
-
-export class TapTest {
-  description: string
-  testFunction: ITestFunction
-  status: TTestStatus
-  parallel: boolean
-  returnValue
-
-  /**
-   * constructor
-   */
-  constructor (optionsArg: {
-    description: string,
-    testFunction: ITestFunction,
-    parallel: boolean
-  }) {
-    this.description = optionsArg.description
-    this.testFunction = optionsArg.testFunction
-    this.parallel = optionsArg.parallel
-    this.status = 'pending'
-  }
-
-  /**
-   * run the test
-   */
-  async run (testKeyArg: number) {
-    try {
-      await this.testFunction()
-      console.log(`ok ${testKeyArg + 1} - ${this.description} # time=20.040ms`)
-      this.status = 'success'
-    } catch (err) {
-      console.log(`not ok ${testKeyArg + 1} - ${this.description} # time=20.040ms`)
-      if (this.status === 'success') {
-        this.status = 'errorAfterSuccess'
-        console.log('!!! ALERT !!!: weird behaviour, since test has been already successfull')
-      }
-      console.log(err)
-    }
-  }
-}
+import { TapTest, ITestFunction } from './tapbundle.classes.taptest'
 
 export class Tap {
+  skip = {
+    test: (...args) => {
+      console.log('skipped')
+    }
+  }
+
   private _tests: TapTest[] = []
 
   /**
@@ -58,12 +16,14 @@ export class Tap {
    * @param testDescription - A description of what the test does
    * @param testFunction - A Function that returns a Promise and resolves or rejects
    */
-  async test (testDescription: string, testFunction: ITestFunction) {
-    this._tests.push(new TapTest({
+  async test(testDescription: string, testFunction: ITestFunction) {
+    let localTest = new TapTest({
       description: testDescription,
       testFunction: testFunction,
       parallel: false
-    }))
+    })
+    this._tests.push(localTest)
+    return localTest
   }
 
   /**
@@ -71,7 +31,7 @@ export class Tap {
    * @param testDescription - A description of what the test does
    * @param testFunction - A Function that returns a Promise and resolves or rejects
    */
-  testParallel (testDescription: string, testFunction: ITestFunction) {
+  testParallel(testDescription: string, testFunction: ITestFunction) {
     this._tests.push(new TapTest({
       description: testDescription,
       testFunction: testFunction,
@@ -84,14 +44,14 @@ export class Tap {
    * @param testDescription - A description of what the test does
    * @param testFunction - A Function that returns a Promise and resolves or rejects
    */
-  testLeakage (testDescription: string, testFunction: ITestFunction) {
+  testLeakage(testDescription: string, testFunction: ITestFunction) {
 
   }
 
   /**
    * starts the test evaluation
    */
-  async start () {
+  async start() {
     let promiseArray: Promise<any>[] = []
 
     // safeguard against empty test array
@@ -102,7 +62,7 @@ export class Tap {
 
     console.log(`1..${this._tests.length}`)
     for (let testKey = 0; testKey < this._tests.length; testKey++) {
-      let currentTest = this._tests[testKey]
+      let currentTest = this._tests[ testKey ]
       let testPromise = currentTest.run(testKey)
       if (currentTest.parallel) {
         promiseArray.push(testPromise)
@@ -116,7 +76,7 @@ export class Tap {
   /**
    * handle errors
    */
-  threw (err) {
+  threw(err) {
     console.log(err)
   }
 }

ts/tapbundle.classes.taptest.ts

@@ -0,0 +1,75 @@
+import * as plugins from './tapbundle.plugins'
+import { tapCreator } from './tapbundle.tapcreator'
+import { TapTools } from './tapbundle.classes.taptools'
+
+// imported interfaces
+import { HrtMeasurement } from 'early'
+import { Deferred } from 'smartq'
+
+// interfaces
+export type TTestStatus = 'success' | 'error' | 'pending' | 'errorAfterSuccess' | 'timeout'
+
+export interface ITestFunction {
+  (tapTools?: TapTools): Promise<any>
+}
+
+
+export class TapTest {
+  description: string
+  failureAllowed: boolean
+  hrtMeasurement: HrtMeasurement
+  parallel: boolean
+  status: TTestStatus
+  tapTools: TapTools
+  testFunction: ITestFunction
+  testDeferred: Deferred<TapTest> = plugins.smartq.defer()
+  testPromise: Promise<TapTest> = this.testDeferred.promise
+  /**
+   * constructor
+   */
+  constructor (optionsArg: {
+    description: string,
+    testFunction: ITestFunction,
+    parallel: boolean
+  }) {
+    this.description = optionsArg.description
+    this.hrtMeasurement = new HrtMeasurement()
+    this.parallel = optionsArg.parallel
+    this.status = 'pending'
+    this.tapTools = new TapTools(this)
+    this.testFunction = optionsArg.testFunction
+  }
+
+  /**
+   * run the test
+   */
+  async run (testKeyArg: number) {
+    this.hrtMeasurement.start()
+    try {
+      await this.testFunction(this.tapTools)
+      if (this.status === 'timeout') {
+        throw new Error ('Test succeeded, but timed out...')
+      }
+      this.hrtMeasurement.stop()
+      console.log(`ok ${testKeyArg + 1} - ${this.description} # time=${this.hrtMeasurement.milliSeconds}ms`)
+      this.status = 'success'
+      this.testDeferred.resolve(this)
+    } catch (err) {
+      this.hrtMeasurement.stop()
+      console.log(`not ok ${testKeyArg + 1} - ${this.description} # time=${this.hrtMeasurement.milliSeconds}ms`)
+      this.testDeferred.reject()
+
+      // if the test has already succeeded before
+      if (this.status === 'success') {
+        this.status = 'errorAfterSuccess'
+        console.log('!!! ALERT !!!: weird behaviour, since test has been already successfull')
+      }
+
+      // if the test is allowed to fail
+      if (this.failureAllowed) {
+        console.log(`please note: failure allowed!`)
+      }
+      console.log(err)
+    }
+  }
+}

ts/tapbundle.classes.taptools.ts

@@ -0,0 +1,36 @@
+import * as plugins from './tapbundle.plugins'
+import { TapTest } from './tapbundle.classes.taptest'
+
+export class TapTools {
+
+  /**
+   * the referenced TapTest
+   */
+  private _tapTest: TapTest
+
+  constructor(TapTestArg) {
+    this._tapTest = TapTestArg
+  }
+
+  /**
+   * allow failure
+   */
+  allowFailure() {
+    this._tapTest.failureAllowed = true
+  }
+
+  /**
+   * async/await delay method
+   */
+  async delayFor(timeMilliArg) {
+    await plugins.smartdelay.delayFor(timeMilliArg)
+  }
+
+  async timeout (timeMilliArg: number) {
+    await plugins.smartdelay.delayFor(timeMilliArg)
+    if (this._tapTest.status === 'pending') {
+      this._tapTest.status = 'timeout'
+    }
+  }
+
+}

ts/tapbundle.plugins.ts

@@ -1,8 +1,12 @@
 import 'typings-global'
-import * as smartq from 'smartq'
+import * as early from 'early'
 import * as leakage from 'leakage'
+import * as smartdelay from 'smartdelay'
+import * as smartq from 'smartq'
 
 export {
+  early,
+  smartdelay,
   smartq,
   leakage
 }

yarn.lock

@@ -23,6 +23,10 @@
   version "0.0.27"
   resolved "https://registry.yarnpkg.com/@types/promises-a-plus/-/promises-a-plus-0.0.27.tgz#c64651134614c84b8f5d7114ce8901d36a609780"
 
+ansi-256-colors@^1.1.0:
+  version "1.1.0"
+  resolved "https://registry.yarnpkg.com/ansi-256-colors/-/ansi-256-colors-1.1.0.tgz#910de50efcc7c09e3d82f2f87abd6b700c18818a"
+
 assertion-error@^1.0.1:
   version "1.0.2"
   resolved "https://registry.yarnpkg.com/assertion-error/-/assertion-error-1.0.2.tgz#13ca515d86206da0bac66e834dd397d87581094c"
@@ -31,6 +35,13 @@ balanced-match@^0.4.1:
   version "0.4.2"
   resolved "https://registry.yarnpkg.com/balanced-match/-/balanced-match-0.4.2.tgz#cb3f3e3c732dc0f01ee70b403f302e61d7709838"
 
+beautycolor@^1.0.7:
+  version "1.0.7"
+  resolved "https://registry.yarnpkg.com/beautycolor/-/beautycolor-1.0.7.tgz#a4715738ac4c8221371e9cbeb5a6cc6d11ecbf7c"
+  dependencies:
+    ansi-256-colors "^1.1.0"
+    typings-global "^1.0.14"
+
 bindings@^1.2.1:
   version "1.2.1"
   resolved "https://registry.yarnpkg.com/bindings/-/bindings-1.2.1.tgz#14ad6113812d2d37d72e67b4cacb4bb726505f11"
@@ -74,6 +85,14 @@ deep-eql@^0.1.3:
   dependencies:
     type-detect "0.1.1"
 
+early@^2.1.1:
+  version "2.1.1"
+  resolved "https://registry.yarnpkg.com/early/-/early-2.1.1.tgz#841e23254ea5dc54d8afaeee82f5ab65c00ee23c"
+  dependencies:
+    beautycolor "^1.0.7"
+    smartq "^1.1.1"
+    typings-global "^1.0.16"
+
 fs.realpath@^1.0.0:
   version "1.0.0"
   resolved "https://registry.yarnpkg.com/fs.realpath/-/fs.realpath-1.0.0.tgz#1504ad2523158caa40db4a2787cb01411994ea4f"
@@ -191,6 +210,12 @@ smartchai@^1.0.3:
     chai-as-promised "^6.0.0"
     chai-string "^1.3.0"
 
+smartdelay@^1.0.1:
+  version "1.0.1"
+  resolved "https://registry.yarnpkg.com/smartdelay/-/smartdelay-1.0.1.tgz#687f8bcc09d7c62c9c5a8a1771c1aba3aff54156"
+  dependencies:
+    typings-global "^1.0.14"
+
 smartq@^1.1.1:
   version "1.1.1"
   resolved "https://registry.yarnpkg.com/smartq/-/smartq-1.1.1.tgz#efb358705260d41ae18aef7ffd815f7b6fe17dd3"