3.0.12

update to latest standards

See merge request !1

.gitignore

@@ -1,4 +1,22 @@
-node_modules/
+.nogit/
+
+# artifacts
 coverage/
 public/
 pages/
+
+# installs
+node_modules/
+
+# caches
+.yarn/
+.cache/
+.rpt2_cache
+
+# builds
+dist/
+dist_web/
+dist_serve/
+dist_ts_web/
+
+# custom

.gitlab-ci.yml

@@ -1,63 +1,105 @@
-# gitzone standard
-image: hosttoday/ht-docker-node:npmts
+# gitzone ci_default
+image: registry.gitlab.com/hosttoday/ht-docker-node:npmci
+
+cache:
+  paths:
+  - .npmci_cache/
+  key: "$CI_BUILD_STAGE"
 
 stages:
+- security
 - test
 - release
-- trigger
-- pages
+- metadata
 
-testLEGACY:
-  stage: test
+# ====================
+# security stage
+# ====================
+mirror:
+  stage: security
   script:
-    - npmci test legacy
-  coverage: /\d+.?\d+?\%\s*coverage/
+  - npmci git mirror
   tags:
-    - docker
-  allow_failure: true
+  - docker
+  - notpriv
+
+snyk:
+  stage: security
+  script:
+    - npmci npm prepare
+    - npmci command npm install -g snyk
+    - npmci command npm install --ignore-scripts
+    - npmci command snyk test
+  tags:
+  - docker
+  - notpriv
+
+# ====================
+# test stage
+# ====================
 
 testLTS:
   stage: test
   script:
-    - npmci test lts
+  - npmci npm prepare
+  - npmci node install lts
+  - npmci npm install
+  - npmci npm test
   coverage: /\d+.?\d+?\%\s*coverage/
   tags:
-    - docker
-    
-testSTABLE:
-  stage: test
-  script:
-    - npmci test stable
-  coverage: /\d+.?\d+?\%\s*coverage/
-  tags:
-    - docker
+  - docker
+  - notpriv
 
 release:
   stage: release
   script:
-    - npmci publish
+  - npmci node install lts
+  - npmci npm publish
   only:
-    - tags
+  - tags
   tags:
-    - docker
+  - docker
+  - notpriv
+
+# ====================
+# metadata stage
+# ====================
+codequality:
+  stage: metadata
+  allow_failure: true
+  script:
+    - npmci command npm install -g tslint typescript
+    - npmci npm install
+    - npmci command "tslint -c tslint.json ./ts/**/*.ts"
+  tags:
+  - docker
+  - priv
 
 trigger:
-  stage: trigger
+  stage: metadata
   script:
-    - npmci trigger
+  - npmci trigger
   only:
-    - tags
+  - tags
   tags:
-    - docker
+  - docker
+  - notpriv
 
 pages:
-  image: hosttoday/ht-docker-node:npmpage
-  stage: pages
+  image: hosttoday/ht-docker-node:npmci
+  stage: metadata
   script:
-    - npmci command npmpage --publish gitlab
+    - npmci command npm install -g @gitzone/tsdoc
+    - npmci npm prepare
+    - npmci npm install
+    - npmci command tsdoc
+  tags:
+    - docker
+    - notpriv
   only:
     - tags
   artifacts:
     expire_in: 1 week
     paths:
     - public
+  allow_failure: true

.snyk

@@ -0,0 +1,15 @@
+# Snyk (https://snyk.io) policy file, patches or ignores known vulnerabilities.
+version: v1.12.0
+# ignores vulnerabilities until expiry date; change duration by modifying expiry date
+ignore:
+  'npm:shelljs:20140723':
+    - smartdelay > typings-global > smartshell > shelljs:
+        reason: None given
+        expires: '2018-07-28T21:47:33.536Z'
+    - early > typings-global > smartshell > shelljs:
+        reason: None given
+        expires: '2018-07-28T21:47:33.537Z'
+    - early > beautycolor > typings-global > smartshell > shelljs:
+        reason: None given
+        expires: '2018-07-28T21:47:33.537Z'
+patch: {}

README.md

@@ -1,29 +1,72 @@
-# tapbundle
+# @pushrocks/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/)
+## Availabililty and Links
+* [npmjs.org (npm package)](https://www.npmjs.com/package/@pushrocks/tapbundle)
+* [gitlab.com (source)](https://gitlab.com/pushrocks/tapbundle)
+* [github.com (source mirror)](https://github.com/pushrocks/tapbundle)
+* [docs (typedoc)](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/)
+[![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/@pushrocks/tapbundle.svg)](https://www.npmjs.com/package/@pushrocks/tapbundle)
+[![Known Vulnerabilities](https://snyk.io/test/npm/@pushrocks/tapbundle/badge.svg)](https://snyk.io/test/npm/@pushrocks/tapbundle)
+[![TypeScript](https://img.shields.io/badge/TypeScript->=%203.x-blue.svg)](https://nodejs.org/dist/latest-v10.x/docs/api/)
+[![node](https://img.shields.io/badge/node->=%2010.x.x-blue.svg)](https://nodejs.org/dist/latest-v10.x/docs/api/)
+[![JavaScript Style Guide](https://img.shields.io/badge/code%20style-prettier-ff69b4.svg)](https://prettier.io/)
 
 ## Usage
+
 Use TypeScript for best in class instellisense.
 
-For further information read the linked docs at the top of this README.
+A few words on TypeScript
+
+### Included in this package
+
+- tap compatible testing framework written in TypeScript
+- a collection of test tools
+- **code** testing framework with typings
+
+### Write your first tests
+
+```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.eventually.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)
+[![repo-footer](https://pushrocks.gitlab.io/assets/repo-footer.svg)](https://maintainedby.lossless.com)

dist/index.d.ts

@@ -1,4 +0,0 @@
-import 'typings-global';
-import * as tap from 'tap';
-import { expect } from 'smartchai';
-export { tap, expect };

dist/index.js

@@ -1,8 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-require("typings-global");
-const tap = require("tap");
-exports.tap = tap;
-const smartchai_1 = require("smartchai");
-exports.expect = smartchai_1.expect;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQUFBLDBCQUF1QjtBQUN2QiwyQkFBMEI7QUFJeEIsa0JBQUc7QUFITCx5Q0FBa0M7QUFJaEMsb0NBQU0ifQ==

docs/mkdocs.yml

@@ -0,0 +1,87 @@
+# Copyright (c) 2016-2017 Martin Donath <martin.donath@squidfunk.com>
+
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to
+# deal in the Software without restriction, including without limitation the
+# rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
+# sell copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+# IN THE SOFTWARE.
+
+# Project information
+site_name: tapbundle | docs
+site_description: a taprunner
+site_author: Lossless GmbH
+site_url: https://push.rocks
+
+# Repository
+repo_name: pushrocks/tapbundle
+repo_url: https://gitlab.com/pushrocks/tapbundle
+
+# Copyright
+copyright: 'Copyright &copy; 2014 Lossless GmbH'
+
+# Theme directory
+theme: material
+theme_dir: 'theme'
+
+# Options
+extra:
+  feature:
+    tabs: false
+  palette:
+    primary: indigo
+    accent: indigo
+  social:
+    - type: globe
+      link: http://lossless.com
+    - type: github-alt
+      link: https://github.com/philkunz
+    - type: twitter
+      link: https://twitter.com/philkunzcom
+    - type: linkedin
+      link: https://linkedin.com/in/philippkunz
+
+# Extensions
+markdown_extensions:
+  - markdown.extensions.admonition
+  - markdown.extensions.codehilite(guess_lang=false, linenums=true)
+  - markdown.extensions.def_list
+  - markdown.extensions.footnotes
+  - markdown.extensions.meta
+  - markdown.extensions.toc(permalink=true)
+  - pymdownx.arithmatex
+  - pymdownx.betterem(smart_enable=all)
+  - pymdownx.caret
+  - pymdownx.critic
+  - pymdownx.details
+  - pymdownx.emoji:
+      emoji_generator: !!python/name:pymdownx.emoji.to_svg
+  - pymdownx.inlinehilite
+  - pymdownx.magiclink
+  - pymdownx.mark
+  - pymdownx.smartsymbols
+  - pymdownx.superfences
+  - pymdownx.tasklist(custom_checkbox=true)
+  - pymdownx.tilde
+
+# Page tree
+pages:
+  - Repo Readme: index.md
+  - Get Started: getstarted.md
+  - License: license.md
+
+# Google Analytics
+google_analytics:
+  - !!python/object/apply:os.getenv ["GOOGLE_ANALYTICS_KEY"]
+  - auto

docs/theme/partials/footer.html

@@ -0,0 +1,56 @@
+{% import "partials/language.html" as lang %}
+<footer class="md-footer">
+  {% if page.previous_page or page.next_page %}
+    <div class="md-footer-nav">
+      <nav class="md-footer-nav__inner md-grid">
+        {% if page.previous_page %}
+          <a href="{{ page.previous_page.url }}" title="{{ page.previous_page.title }}" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
+            <div class="md-flex__cell md-flex__cell--shrink">
+              <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i>
+            </div>
+            <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
+              <span class="md-flex__ellipsis">
+                <span class="md-footer-nav__direction">
+                  {{ lang.t("footer.previous") }}
+                </span>
+                {{ page.previous_page.title }}
+              </span>
+            </div>
+          </a>
+        {% endif %}
+        {% if page.next_page %}
+          <a href="{{ page.next_page.url }}" title="{{ page.next_page.title }}" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
+            <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
+              <span class="md-flex__ellipsis">
+                <span class="md-footer-nav__direction">
+                  {{ lang.t("footer.next") }}
+                </span>
+                {{ page.next_page.title }}
+              </span>
+            </div>
+            <div class="md-flex__cell md-flex__cell--shrink">
+              <i class="md-icon md-icon--arrow-forward md-footer-nav__button"></i>
+            </div>
+          </a>
+        {% endif %}
+      </nav>
+    </div>
+  {% endif %}
+  <div class="md-footer-meta md-typeset">
+    <div class="md-footer-meta__inner md-grid">
+      <div class="md-footer-copyright">
+        {% if config.copyright %}
+          <div class="md-footer-copyright__highlight">
+            {{ config.copyright }}
+          </div>
+        {% endif %}
+        <a href="https://lossless.gmbh" title="push.rocks">Impressum</a>
+        |
+        <a href="https://lossless.com" title="Lossless GmbH">Company Website</a>
+      </div>
+      {% block social %}
+        {% include "partials/social.html" %}
+      {% endblock %}
+    </div>
+  </div>
+</footer>

license

@@ -0,0 +1,22 @@
+**MIT License**
+
+Copright © 2016 Lossless GmbH
+Copyright © 2016 - 2017 Martin Donath
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to
+deal in the Software without restriction, including without limitation the
+rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
+sell copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+IN THE SOFTWARE.

npmextra.json

@@ -0,0 +1,21 @@
+{
+  "npmci": {
+    "npmGlobalTools": [],
+    "npmAccessLevel": "public"
+  },
+  "npmts": {
+    "testConfig": {
+      "parallel": false
+    }
+  },
+  "gitzone": {
+    "module": {
+      "githost": "gitlab.com",
+      "gitscope": "pushrocks",
+      "gitrepo": "tapbundle",
+      "shortDescription": "tap bundled for tapbuffer",
+      "npmPackagename": "@pushrocks/tapbundle",
+      "license": "MIT"
+    }
+  }
+}

package.json

@@ -1,11 +1,13 @@
 {
-  "name": "tapbundle",
-  "version": "1.0.1",
+  "name": "@pushrocks/tapbundle",
+  "private": false,
+  "version": "3.0.12",
   "description": "tap bundled for tapbuffer",
   "main": "dist/index.js",
-  "typings": "dsit/index.d.ts",
+  "typings": "dist/index.d.ts",
   "scripts": {
-    "test": "(npmts)"
+    "test": "(tstest test/)",
+    "build": "(tsbuild)"
   },
   "repository": {
     "type": "git",
@@ -18,8 +20,28 @@
   },
   "homepage": "https://gitlab.com/pushrocks/tapbundle#README",
   "dependencies": {
-    "smartchai": "^1.0.3",
-    "tap": "^10.3.0",
-    "typings-global": "^1.0.14"
-  }
+    "@pushrocks/early": "^3.0.3",
+    "@pushrocks/smartdelay": "^2.0.3",
+    "@pushrocks/smartpromise": "^3.0.2",
+    "smartchai": "^2.0.1"
+  },
+  "devDependencies": {
+    "@gitzone/tsbuild": "^2.1.11",
+    "@gitzone/tsrun": "^1.2.8",
+    "@gitzone/tstest": "^1.0.24",
+    "@types/node": "^12.7.2",
+    "randomstring": "^1.1.5",
+    "tslint": "^5.19.0",
+    "tslint-config-prettier": "^1.18.0"
+  },
+  "files": [
+    "ts/*",
+    "ts_web/*",
+    "dist/*",
+    "dist_web/*",
+    "assets/*",
+    "cli.js",
+    "npmextra.json",
+    "readme.md"
+  ]
 }

test/test.iterationleak.ts

@@ -0,0 +1,21 @@
+import { tap, expect } from '../ts/index';
+import * as randomstring from 'randomstring';
+
+const test1 = tap.test('my first test -> expect true to be true', async tools => {
+  await tools.checkIterationLeak(async () => {
+    const domain = randomstring.generate(1000);
+  });
+});
+
+const outsideArray = [];
+
+const test2 = tap.test('should throw', async tools => {
+  const err = await tools.returnError(async () => {
+    await tools.checkIterationLeak(async () => {
+      outsideArray.push(randomstring.generate(1000));
+    });
+  });
+  expect(err).to.be.undefined;
+});
+
+tap.start();

test/test.tapwrap.ts

@@ -0,0 +1,10 @@
+import { tap, expect } from '../ts/index';
+
+const tapwrap = tap.wrap(async () => {
+  tap.test('should do something', async () => {
+    console.log('test1');
+  });
+  tap.start();
+});
+
+tapwrap.run();

test/test.ts

@@ -0,0 +1,36 @@
+import { tap, expect } from '../ts/index';
+
+const test1 = tap.test('my first test -> expect true to be true', async () => {
+  return expect(true).to.be.true;
+});
+
+const test2 = tap.test('my second test', async tools => {
+  await tools.delayFor(1000);
+});
+
+const 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;
+  }
+);
+
+const test4 = tap.skip.test('my 4th test -> should fail', async tools => {
+  tools.allowFailure();
+  expect(false).to.be.true;
+});
+
+const test5 = tap.test('my 5th test -> should pass in about 500ms', async tools => {
+  tools.timeout(1000);
+  await tools.delayFor(500);
+});
+
+const 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,8 +1,2 @@
-import 'typings-global'
-import * as tap from 'tap'
-import { expect } from 'smartchai'
-
-export {
-  tap,
-  expect
-}
+export { expect } from 'smartchai';
+export { tap } from './tapbundle.classes.tap';

ts/tapbundle.classes.tap.ts

@@ -0,0 +1,140 @@
+import * as plugins from './tapbundle.plugins';
+
+import { TapTest, ITestFunction } from './tapbundle.classes.taptest';
+import { TapWrap, ITapWrapFunction } from './tapbundle.classes.tapwrap';
+export class Tap {
+  /**
+   * skips a test
+   * tests marked with tap.skip.test() are never executed
+   */
+  skip = {
+    test: (descriptionArg: string, functionArg: ITestFunction) => {
+      console.log(`skipped test: ${descriptionArg}`);
+    },
+    testParallel: (descriptionArg: string, functionArg: ITestFunction) => {
+      console.log(`skipped test: ${descriptionArg}`);
+    }
+  };
+
+  /**
+   * only executes tests marked as ONLY
+   */
+  only = {
+    test: (descriptionArg: string, testFunctionArg: ITestFunction) => {
+      this.test(descriptionArg, testFunctionArg, 'only');
+    }
+  };
+
+  private _tapTests: TapTest[] = [];
+  private _tapTestsOnly: TapTest[] = [];
+
+  /**
+   * 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
+   */
+  async test(
+    testDescription: string,
+    testFunction: ITestFunction,
+    modeArg: 'normal' | 'only' | 'skip' = 'normal'
+  ) {
+    let localTest = new TapTest({
+      description: testDescription,
+      testFunction: testFunction,
+      parallel: false
+    });
+    if (modeArg === 'normal') {
+      this._tapTests.push(localTest);
+    } else if (modeArg === 'only') {
+      this._tapTestsOnly.push(localTest);
+    }
+    return localTest;
+  }
+
+  /**
+   * wraps function
+   */
+  wrap(functionArg: ITapWrapFunction) {
+    return new TapWrap(functionArg);
+  }
+
+  /**
+   * 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: string, testFunction: ITestFunction) {
+    this._tapTests.push(
+      new TapTest({
+        description: testDescription,
+        testFunction: testFunction,
+        parallel: true
+      })
+    );
+  }
+
+  /**
+   * starts the test evaluation
+   */
+  async start(optionsArg?: { throwOnError: boolean }) {
+    let promiseArray: Promise<any>[] = [];
+
+    // safeguard against empty test array
+    if (this._tapTests.length === 0) {
+      console.log('no tests specified. Ending here!');
+      return;
+    }
+
+    // determine which tests to run
+    let concerningTests: TapTest[];
+    if (this._tapTestsOnly.length > 0) {
+      concerningTests = this._tapTestsOnly;
+    } else {
+      concerningTests = this._tapTests;
+    }
+
+    console.log(`1..${concerningTests.length}`);
+    for (let testKey = 0; testKey < concerningTests.length; testKey++) {
+      let currentTest = concerningTests[testKey];
+      let testPromise = currentTest.run(testKey);
+      if (currentTest.parallel) {
+        promiseArray.push(testPromise);
+      } else {
+        await testPromise;
+      }
+    }
+    await Promise.all(promiseArray);
+
+    // when tests have been run and all promises are fullfilled
+    let failReasons: string[] = [];
+    let executionNotes: string[] = [];
+    // collect failed tests
+    for (let tapTest of concerningTests) {
+      if (tapTest.status !== 'success') {
+        failReasons.push(
+          `Test ${tapTest.testKey + 1} failed with status ${tapTest.status}:\n` +
+            `|| ${tapTest.description}\n` +
+            `|| for more information please take a look the logs above`
+        );
+      }
+    }
+
+    // render fail Reasons
+    for (let failReason of failReasons) {
+      console.log(failReason);
+    }
+
+    if (optionsArg && optionsArg.throwOnError && failReasons.length > 0) {
+      process.exit(1);
+    }
+  }
+
+  /**
+   * handle errors
+   */
+  threw(err) {
+    console.log(err);
+  }
+}
+
+export let tap = new Tap();

ts/tapbundle.classes.taptest.ts

@@ -0,0 +1,79 @@
+import * as plugins from './tapbundle.plugins';
+import { tapCreator } from './tapbundle.tapcreator';
+import { TapTools } from './tapbundle.classes.taptools';
+
+// imported interfaces
+import { HrtMeasurement } from '@pushrocks/early';
+import { Deferred } from '@pushrocks/smartpromise';
+
+// 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;
+  testKey: number; // the testKey the position in the test qeue. Set upon calling .run()
+  testDeferred: Deferred<TapTest> = plugins.smartpromise.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();
+    this.testKey = testKeyArg;
+    let testNumber = testKeyArg + 1;
+    try {
+      await this.testFunction(this.tapTools);
+      if (this.status === 'timeout') {
+        throw new Error('Test succeeded, but timed out...');
+      }
+      this.hrtMeasurement.stop();
+      console.log(
+        `ok ${testNumber} - ${this.description} # time=${this.hrtMeasurement.milliSeconds}ms`
+      );
+      this.status = 'success';
+      this.testDeferred.resolve(this);
+    } catch (err) {
+      this.hrtMeasurement.stop();
+      console.log(
+        `not ok ${testNumber} - ${this.description} # time=${this.hrtMeasurement.milliSeconds}ms`
+      );
+      this.testDeferred.resolve(this);
+
+      // 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');
+      } else {
+        this.status = 'error';
+      }
+
+      // 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,62 @@
+import * as plugins from './tapbundle.plugins';
+import { TapTest } from './tapbundle.classes.taptest';
+
+export interface IPromiseFunc {
+  (): Promise<any>;
+}
+
+export class TapTools {
+  /**
+   * the referenced TapTest
+   */
+  private _tapTest: TapTest;
+
+  constructor(TapTestArg) {
+    this._tapTest = TapTestArg;
+  }
+
+  /**
+   * allow failure
+   */
+  public allowFailure() {
+    this._tapTest.failureAllowed = true;
+  }
+
+  /**
+   * async/await delay method
+   */
+  public async delayFor(timeMilliArg) {
+    await plugins.smartdelay.delayFor(timeMilliArg);
+  }
+
+  public async delayForRandom(timeMilliMinArg, timeMilliMaxArg) {
+    await plugins.smartdelay.delayForRandom(timeMilliMinArg, timeMilliMaxArg);
+  }
+
+  public async timeout(timeMilliArg: number) {
+    const timeout = new plugins.smartdelay.Timeout(timeMilliArg);
+    timeout.makeUnrefed();
+    await timeout.promise;
+    if (this._tapTest.status === 'pending') {
+      this._tapTest.status = 'timeout';
+    }
+  }
+
+  public async checkIterationLeak(iterationfuncArg: IPromiseFunc) {
+    console.log('iteration leakage checks disabled for now due to incompatibilities with node v12');
+  }
+
+  public async returnError(throwingFuncArg: IPromiseFunc) {
+    let funcErr: Error;
+    try {
+      await throwingFuncArg();
+    } catch (err) {
+      funcErr = err;
+    }
+    return funcErr;
+  }
+
+  public defer() {
+    return plugins.smartpromise.defer();
+  }
+}

ts/tapbundle.classes.tapwrap.ts

@@ -0,0 +1,24 @@
+import * as plugins from './tapbundle.plugins';
+
+export interface ITapWrapFunction {
+  (): Promise<any>;
+}
+
+export class TapWrap {
+  wrapFunction: ITapWrapFunction;
+
+  /**
+   * the constructor
+   */
+  constructor(wrapFunctionArg: ITapWrapFunction) {
+    // nothing here
+    this.wrapFunction = wrapFunctionArg;
+  }
+
+  /**
+   * run the wrapFunction
+   */
+  async run() {
+    await this.wrapFunction();
+  }
+}

ts/tapbundle.plugins.ts

@@ -0,0 +1,11 @@
+// pushrocks
+import * as early from '@pushrocks/early';
+import * as smartdelay from '@pushrocks/smartdelay';
+import * as smartpromise from '@pushrocks/smartpromise';
+
+export { early, smartdelay, smartpromise };
+
+// third party
+/* import * as leakage from 'leakage';
+
+export { leakage }; */

ts/tapbundle.tapcreator.ts

@@ -0,0 +1,7 @@
+import * as plugins from './tapbundle.plugins';
+
+export class TapCreator {
+  // TODO:
+}
+
+export let tapCreator = new TapCreator();

tslint.json

@@ -1,3 +1,17 @@
 {
-    "extends": "tslint-config-standard"
+  "extends": ["tslint:latest", "tslint-config-prettier"],
+  "rules": {
+    "semicolon": [true, "always"],
+    "no-console": false,
+    "ordered-imports": false,
+    "object-literal-sort-keys": false,
+    "member-ordering": {
+      "options":{
+        "order": [
+          "static-method"
+        ]
+      }
+    }
+  },
+  "defaultSeverity": "warning"
 }