8.0.7

See merge request !6

.gitlab-ci.yml

@@ -1,6 +1,11 @@
-# standard ci
+# gitzone standard
 image: hosttoday/ht-docker-node:npmci
 
+cache:
+  paths:
+  - .yarn/
+  key: "$CI_BUILD_STAGE"
+
 stages:
 - test
 - release
@@ -11,6 +16,7 @@ testLEGACY:
   stage: test
   script:
     - npmci test legacy
+  coverage: /\d+.?\d+?\%\s*coverage/
   tags:
     - docker
   allow_failure: true
@@ -19,6 +25,7 @@ testLTS:
   stage: test
   script:
     - npmci test lts
+  coverage: /\d+.?\d+?\%\s*coverage/
   tags:
     - docker
     
@@ -26,6 +33,7 @@ testSTABLE:
   stage: test
   script:
     - npmci test stable
+  coverage: /\d+.?\d+?\%\s*coverage/
   tags:
     - docker
 
@@ -48,10 +56,13 @@ trigger:
     - docker
 
 pages:
-  image: hosttoday/ht-docker-node:npmpage
+  image: hosttoday/ht-docker-node:npmci
   stage: pages
   script:
+    - npmci command yarn global add npmpage
     - npmci command npmpage --publish gitlab
+  tags:
+    - docker
   only:
     - tags
   artifacts:

CHANGELOG

@@ -1,5 +0,0 @@
-Please view this file on the master branch, on stable branches it's out of date.
-
-v 6.0.0 (released)
-    - remove TypeDoc, please look at npmpage
-    - check package.json

README.md

@@ -1,39 +0,0 @@
-# npmts
-Write npm modules with TypeScript without hassle. TypeScript ready. Fully ES6.
-
-## Availabililty
-[![npm](https://push.rocks/assets/repo-button-npm.svg)](https://www.npmjs.com/package/npmts)
-[![git](https://push.rocks/assets/repo-button-git.svg)](https://gitlab.com/pushrocks/npmts)
-[![git](https://push.rocks/assets/repo-button-mirror.svg)](https://github.com/pushrocks/npmts)
-[![docs](https://push.rocks/assets/repo-button-docs.svg)](https://pushrocks.gitlab.io/npmts/)
-
-## Status for master
-[![build status](https://gitlab.com/pushrocks/npmts/badges/master/build.svg)](https://gitlab.com/pushrocks/npmts/commits/master)
-[![coverage report](https://gitlab.com/pushrocks/npmts/badges/master/coverage.svg)](https://gitlab.com/pushrocks/npmts/commits/master)
-[![npm downloads per month](https://img.shields.io/npm/dm/npmts.svg)](https://www.npmjs.com/package/npmts)
-[![docker pulls](https://img.shields.io/docker/pulls/hosttoday/ht-docker-node.svg)](https://hub.docker.com/r/hosttoday/ht-docker-node/)
-[![Dependency Status](https://david-dm.org/pushrocks/npmts.svg)](https://david-dm.org/pushrocks/npmts)
-[![bitHound Dependencies](https://www.bithound.io/github/pushrocks/npmts/badges/dependencies.svg)](https://www.bithound.io/github/pushrocks/npmts/master/dependencies/npm)
-[![bitHound Code](https://www.bithound.io/github/pushrocks/npmts/badges/code.svg)](https://www.bithound.io/github/pushrocks/npmts)
-[![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/)
-
-## Introduction
-NPMTS is your friend when writing, testing, publishing and documenting npm modules written in TypeScript.
-
-npmts will
-    
-1. check your dependencies and package.json (unused, missing, updates, security)
-1. transpile your code with tsc,
-1. test your code with mocha (supports the fancy stuff like Promises, Generators, async/await, sourcemaps)
-1. create coverage with istanbul (supports tracing of the originating TypeScript)
-
-This works on your machine and in CI. There is a prebuild docker image available that includes npmts to make CI a breeze:  
-[hosttoday/ht-docker-node:npmts on Dockerhub](https://hub.docker.com/r/hosttoday/ht-docker-node/)
-
-For further information read the linked docs at the top of this README.
-
-> MIT licensed | **©** 2016 - 2017 [Lossless GmbH](https://lossless.gmbh)
-
-[![npm](https://push.rocks/assets/repo-header.svg)](https://push.rocks)

assets/cli.js

@@ -1,2 +1,3 @@
 #!/usr/bin/env node
+process.env.CLI_CALL = 'true'
 var index = require("../{{pathToIndex}}");

dist/index.js

@@ -1,8 +1,9 @@
+"use strict";
 /* ================================================== *
     **** NPMTS ****
     Fabulous TypeScript development
  * ================================================== */
-"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
 const early = require("early");
 early.start('NPMTS');
 const plugins = require("./npmts.plugins");

dist/mod00/index.js

@@ -1,6 +1,8 @@
 "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
 /* ------------------------------------------
- * This module compiles TypeScript files
+ * This module compiles the module's TypeScript files
+ * Note: Test files are only compiled in memory
  * -------------------------------------------- */
 const q = require("smartq");
 const plugins = require("./mod00.plugins");

dist/mod00/mod00.assets.js

@@ -1,4 +1,5 @@
 "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
 const q = require("smartq");
 const paths = require("../npmts.paths");
 const plugins = require("./mod00.plugins");
@@ -6,7 +7,7 @@ const mod00_check_1 = require("../mod00/mod00.check");
 exports.run = function (configArg) {
     let done = q.defer();
     let config = configArg;
-    plugins.beautylog.ora.text('now looking at ' + 'required assets'.yellow);
+    plugins.beautylog.ora.text('now looking at ' + 'required assets');
     if (config.cli === true) {
         let mainJsPath = mod00_check_1.projectInfo.packageJson.main;
         let cliJsString = plugins.smartfile.fs.toStringSync(plugins.path.join(paths.npmtsAssetsDir, 'cli.js'));

dist/mod00/mod00.check.d.ts

@@ -1,3 +1,4 @@
 import { ProjectinfoNpm } from 'projectinfo';
+import { INpmtsConfig } from '../npmts.config';
 export declare let projectInfo: ProjectinfoNpm;
-export declare let run: (configArg: any) => Promise<{}>;
+export declare let run: (configArg: INpmtsConfig) => Promise<INpmtsConfig>;

dist/mod00/mod00.check.js

@@ -1,4 +1,13 @@
 "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 q = require("smartq");
 const projectinfo_1 = require("projectinfo");
 const paths = require("../npmts.paths");
@@ -55,11 +64,11 @@ let checkDependencies = (configArg) => {
             process.exit(1);
         }
         for (let item in unused.invalidFiles) {
-            plugins.beautylog.warn(`Watch out: could not parse file ${item.red}`);
+            plugins.beautylog.warn(`Watch out: could not parse file ${item}`);
         }
         ;
         for (let item in unused.invalidDirs) {
-            plugins.beautylog.warn(`Watch out: could not parse directory ${item.red}`);
+            plugins.beautylog.warn(`Watch out: could not parse directory ${item}`);
         }
         done.resolve(configArg);
     });
@@ -81,20 +90,20 @@ let checkDevDependencies = (configArg) => {
     });
     plugins.depcheck(paths.cwd, depcheckOptionsMerged, (unused) => {
         for (let item of unused.devDependencies) {
-            plugins.beautylog.log(`unused devDependency ${item.red}`);
+            plugins.beautylog.log(`unused devDependency ${item}`);
         }
         for (let item in unused.missing) {
-            plugins.beautylog.error(`unused devDependency ${item.red}`);
+            plugins.beautylog.error(`missing devDependency ${item}`);
         }
         if (unused.missing.length > 0) {
             plugins.beautylog.info('exiting due to missing dependencies in package.json');
             process.exit(1);
         }
         for (let item in unused.invalidFiles) {
-            plugins.beautylog.warn(`Watch out: could not parse file ${item.red}`);
+            plugins.beautylog.warn(`Watch out: could not parse file ${item}`);
         }
         for (let item in unused.invalidDirs) {
-            plugins.beautylog.warn(`Watch out: could not parse directory ${item.red}`);
+            plugins.beautylog.warn(`Watch out: could not parse directory ${item}`);
         }
         done.resolve(configArg);
     });
@@ -106,14 +115,17 @@ let checkNodeVersion = (configArg) => {
     done.resolve(configArg);
     return done.promise;
 };
-exports.run = (configArg) => {
-    let done = q.defer();
+exports.run = (configArg) => __awaiter(this, void 0, void 0, function* () {
     plugins.beautylog.ora.text('Check Module: ...');
-    checkProjectTypings(configArg)
-        .then(checkDependencies)
-        .then(checkDevDependencies)
-        .then(checkNodeVersion)
-        .then(done.resolve)
-        .catch((err) => { console.log(err); });
-    return done.promise;
-};
+    if (configArg.checkDependencies) {
+        configArg = yield checkProjectTypings(configArg);
+        configArg = yield checkDependencies(configArg);
+        configArg = yield checkDevDependencies(configArg);
+        configArg = yield checkNodeVersion(configArg);
+        return configArg;
+    }
+    else {
+        configArg = yield checkProjectTypings(configArg);
+        return configArg;
+    }
+});

dist/mod00/mod00.clean.js

@@ -1,4 +1,5 @@
 "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
 const q = require("smartq");
 const paths = require("../npmts.paths");
 const plugins = require("./mod00.plugins");
@@ -9,17 +10,6 @@ let removeDist = function () {
     plugins.beautylog.ora.text('cleaning dist folder');
     return plugins.smartfile.fs.remove(paths.distDir);
 };
-/**
- * remove .d.ts files from testDirctory
- */
-let removeTestDeclarations = function () {
-    let done = q.defer();
-    plugins.smartfile.fs.listFileTree('./test/', '**/*.d.ts').then(fileArray => {
-        let fileArrayToRemove = plugins.smartpath.transform.toAbsolute(fileArray, process.cwd() + '//test/');
-        plugins.smartfile.fs.removeManySync(fileArrayToRemove);
-        done.resolve();
-    });
-};
 /**
  * remove old pages
  */
@@ -31,7 +21,6 @@ exports.run = function (configArg) {
     plugins.beautylog.ora.text('cleaning up from previous builds...');
     let done = q.defer();
     removeDist()
-        .then(removeTestDeclarations)
         .then(removePages)
         .then(function () {
         plugins.beautylog.ok('Cleaned up from previous builds!');

dist/mod00/mod00.compile.js

@@ -1,19 +1,15 @@
 "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
 const q = require("smartq");
 const paths = require("../npmts.paths");
 const plugins = require("./mod00.plugins");
 exports.run = function (configArg) {
     let done = q.defer();
     let config = configArg;
-    plugins.beautylog.ora.text('now compiling ' + 'TypeScript'.yellow);
+    plugins.beautylog.ora.text('now compiling ' + 'TypeScript');
     plugins.tsn.compileGlobStringObject(config.ts, config.tsOptions, paths.cwd)
         .then(() => {
-        plugins.beautylog.ok('compiled main TypeScript!');
-        plugins.beautylog.log('now compiling tests!');
-        return plugins.tsn.compileGlobStringObject(config.testTs, config.tsOptions, paths.cwd);
-    })
-        .then(function () {
-        plugins.beautylog.ok('compiled all TypeScript!');
+        plugins.beautylog.ok(`compiled the module's TypeScript!`);
         done.resolve(config);
     }).catch(err => { console.log(err); });
     return done.promise;

dist/mod00/mod00.plugins.js

@@ -2,6 +2,7 @@
 function __export(m) {
     for (var p in m) if (!exports.hasOwnProperty(p)) exports[p] = m[p];
 }
+Object.defineProperty(exports, "__esModule", { value: true });
 __export(require("../npmts.plugins"));
 const tsn = require("tsn");
 exports.tsn = tsn;

dist/mod01/index.js

@@ -1,4 +1,5 @@
 "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
 /* ------------------------------------------
  * This module creates TypeScript documentation
  * -------------------------------------------- */

dist/mod01/mod01.plugins.js

@@ -2,4 +2,5 @@
 function __export(m) {
     for (var p in m) if (!exports.hasOwnProperty(p)) exports[p] = m[p];
 }
+Object.defineProperty(exports, "__esModule", { value: true });
 __export(require("../npmts.plugins"));

dist/mod02/index.js

@@ -7,6 +7,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+Object.defineProperty(exports, "__esModule", { value: true });
 /* ------------------------------------------
  * This module tests the compiled TypeScript files
  * -------------------------------------------- */
@@ -17,12 +18,18 @@ const q = require("smartq");
  * runs mocha
  * @returns INpmtsConfig
  */
-let mocha = function (configArg) {
-    plugins.beautylog.ora.text('Instrumentalizing and testing transpiled JS');
-    plugins.beautylog.ora.end(); // end plugins.beautylog.ora for tests.
+let tap = function (configArg) {
     let done = q.defer();
-    let coverageSmartstream = new plugins.smartstream.Smartstream([
-        plugins.gulp.src([plugins.path.join(paths.cwd, './ts/**/*.ts')]),
+    /**
+     * the TabBuffer for npmts
+     */
+    let npmtsTapBuffer = new plugins.tapbuffer.TabBuffer();
+    npmtsTapBuffer.setConfig(configArg.testConfig);
+    /**
+     * handle the testable files
+     */
+    let testableFilesSmartstream = new plugins.smartstream.Smartstream([
+        plugins.smartgulp.src([plugins.path.join(paths.cwd, './ts/**/*.ts')]),
         plugins.gulpSourcemaps.init(),
         plugins.gulpTypeScript({
             target: 'ES5',
@@ -30,38 +37,34 @@ let mocha = function (configArg) {
             experimentalDecorators: true,
             lib: ['DOM', 'ES5', 'ES2015.Promise', 'ES2015.Generator', 'ES2015.Iterable']
         }),
-        plugins.gulpIstanbul({}),
         plugins.gulpSourcemaps.write(),
-        plugins.gulpFunction.forEach((file) => __awaiter(this, void 0, void 0, function* () {
-            file.path = file.path.replace(paths.tsDir, paths.distDir);
-        })),
-        plugins.gulpInjectModules(),
-        plugins.through2.obj((file, enc, cb) => {
-            cb();
-        }, (cb) => {
-            cb();
-        })
+        npmtsTapBuffer.pipeTestableFiles(),
+        plugins.smartstream.cleanPipe()
     ]);
-    let localSmartstream = new plugins.smartstream.Smartstream([
-        plugins.gulp.src([plugins.path.join(paths.cwd, 'test/test.ts')]),
+    /**
+     * handle the test files
+     */
+    let testFilesSmartstream = new plugins.smartstream.Smartstream([
+        plugins.smartgulp.src([plugins.path.join(paths.cwd, 'test/*.ts')]),
+        plugins.gulpSourcemaps.init(),
         plugins.gulpTypeScript({
             target: 'ES5',
             emitDecoratorMetadata: true,
             experimentalDecorators: true,
             lib: ['DOM', 'ES5', 'ES2015.Promise', 'ES2015.Generator', 'ES2015.Iterable']
         }),
-        plugins.gulpInjectModules(),
-        plugins.gulpMocha(),
-        plugins.gulpIstanbul.writeReports({
-            dir: plugins.path.join(paths.cwd, './coverage'),
-            reporters: ['lcovonly', 'json', 'text', 'text-summary']
-        })
+        plugins.gulpSourcemaps.write(),
+        npmtsTapBuffer.pipeTestFiles(),
+        plugins.smartstream.cleanPipe()
     ]);
-    coverageSmartstream.run()
-        .then(() => {
-        plugins.beautylog.info('code is now transpiled to ES5, instrumented with istanbul, and injected for mocha!');
-        return localSmartstream.run()
-            .then(() => { done.resolve(configArg); }, (err) => {
+    // lets run the smartstream
+    Promise.all([
+        testableFilesSmartstream.run(),
+        testFilesSmartstream.run()
+    ]).then(() => __awaiter(this, void 0, void 0, function* () {
+        configArg.runData.coverageLcovInfo = yield npmtsTapBuffer.runTests();
+        done.resolve(configArg);
+    }), (err) => {
         plugins.beautylog.error('Tests failed!');
         console.log(err);
         if (configArg.watch) {
@@ -71,22 +74,23 @@ let mocha = function (configArg) {
             process.exit(1);
         }
     });
-    }, (err) => {
-        console.log(err);
-    });
     return done.promise;
 };
-let coverage = function (configArg) {
-    let done = q.defer();
-    plugins.smartcov.get.percentage(plugins.path.join(paths.coverageDir, 'lcov.info'), 2)
-        .then(function (percentageArg) {
-        if (percentageArg >= configArg.coverageTreshold) {
-            plugins.beautylog.ok(`${percentageArg.toString()}% `
+let handleCoverageData = (configArg) => __awaiter(this, void 0, void 0, function* () {
+    let coverageResult = 0; // the coverage in percent
+    if (configArg.runData.coverageLcovInfo) {
+        coverageResult = yield plugins.smartcov.get.percentageFromLcovString(configArg.runData.coverageLcovInfo, 2);
+    }
+    else {
+        plugins.beautylog.warn('Hey... Did your tests import and use your module that you are trying to test?');
+    }
+    if (coverageResult >= configArg.coverageTreshold) {
+        plugins.beautylog.ok(`${(coverageResult).toString()}% `
             + `coverage exceeds your treshold of `
             + `${configArg.coverageTreshold.toString()}%`);
     }
     else {
-            plugins.beautylog.warn(`${percentageArg.toString()}% `
+        plugins.beautylog.warn(`${(coverageResult).toString()}% `
             + `coverage fails your treshold of `
             + `${configArg.coverageTreshold.toString()}%`);
         plugins.beautylog.error('exiting due to coverage failure');
@@ -94,24 +98,29 @@ let coverage = function (configArg) {
             process.exit(1);
         }
     }
-        done.resolve(configArg);
+    return configArg;
 });
-    return done.promise;
-};
 exports.run = function (configArg) {
     let done = q.defer();
     let config = configArg;
     if (config.test === true) {
         plugins.beautylog.ora.text('now starting tests');
-        plugins.beautylog.log('------------------------------------------------------\n' +
-            '*************************** TESTS: ***************************\n' +
-            '--------------------------------------------------------------');
-        mocha(config)
-            .then(coverage)
+        plugins.beautylog.ora.end();
+        plugins.beautylog.log('ready for tapbuffer:');
+        if (configArg.testConfig.coverage) {
+            tap(config)
+                .then(handleCoverageData)
                 .then(() => {
                 done.resolve(config);
             }).catch(err => { console.log(err); });
         }
+        else {
+            tap(config)
+                .then(() => {
+                done.resolve(config);
+            }).catch(err => { console.log(err); });
+        }
+    }
     else {
         plugins.beautylog.ora.end();
         done.resolve(config);

dist/mod02/mod02.plugins.d.ts

@@ -1,9 +1,8 @@
 export * from '../npmts.plugins';
-import * as gulp from 'gulp';
 import * as gulpFunction from 'gulp-function';
-import * as gulpIstanbul from 'gulp-istanbul';
-declare let gulpInjectModules: any;
-import * as gulpMocha from 'gulp-mocha';
 import * as gulpSourcemaps from 'gulp-sourcemaps';
 import * as gulpTypeScript from 'gulp-typescript';
-export { gulp, gulpFunction, gulpIstanbul, gulpInjectModules, gulpMocha, gulpSourcemaps, gulpTypeScript };
+import * as smartcov from 'smartcov';
+import * as smartgulp from 'smartgulp';
+import * as tapbuffer from 'tapbuffer';
+export { gulpFunction, gulpSourcemaps, gulpTypeScript, smartcov, smartgulp, tapbuffer };

dist/mod02/mod02.plugins.js

@@ -2,18 +2,17 @@
 function __export(m) {
     for (var p in m) if (!exports.hasOwnProperty(p)) exports[p] = m[p];
 }
+Object.defineProperty(exports, "__esModule", { value: true });
 __export(require("../npmts.plugins"));
-const gulp = require("gulp");
-exports.gulp = gulp;
 const gulpFunction = require("gulp-function");
 exports.gulpFunction = gulpFunction;
-const gulpIstanbul = require("gulp-istanbul");
-exports.gulpIstanbul = gulpIstanbul;
-let gulpInjectModules = require('gulp-inject-modules');
-exports.gulpInjectModules = gulpInjectModules;
-const gulpMocha = require("gulp-mocha");
-exports.gulpMocha = gulpMocha;
 const gulpSourcemaps = require("gulp-sourcemaps");
 exports.gulpSourcemaps = gulpSourcemaps;
 const gulpTypeScript = require("gulp-typescript");
 exports.gulpTypeScript = gulpTypeScript;
+const smartcov = require("smartcov");
+exports.smartcov = smartcov;
+const smartgulp = require("smartgulp");
+exports.smartgulp = smartgulp;
+const tapbuffer = require("tapbuffer");
+exports.tapbuffer = tapbuffer;

dist/npmts.cli.js

@@ -1,4 +1,5 @@
 "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
 const q = require("smartq");
 const plugins = require("./npmts.plugins");
 const paths = require("./npmts.paths");
@@ -6,9 +7,24 @@ const NpmtsConfig = require("./npmts.config");
 const NpmtsMods = require("./npmts.mods");
 const NpmtsWatch = require("./npmts.watch");
 const NpmtsShip = require("./npmts.ship");
+/**
+ * smartanalytics
+ * this data is fully anonymized (no Ips or any other personal information is tracked).
+ * It just keeps track which of our tools are really used...
+ * ... so we know where to spend our limited resources for improving them.
+ * Since yarn is out and there is heavy caching going on,
+ * pure download stats are just not reliable enough for us anymore
+ * Feel free to dig into the smartanalytics package, if you are interested in how it works.
+ * It is just an https call to Google Analytics.
+ * Our privacy policy can be found here: https://lossless.gmbh/privacy.html
+ */
+let npmtsAnalytics = new plugins.smartanalytics.AnalyticsAccount('npmts', 'UA-64087619-5');
+npmtsAnalytics.sendEvent('npm', 'exec', 'git.zone');
 exports.run = () => {
     let done = q.defer();
     let npmtsProjectInfo = new plugins.projectinfo.ProjectinfoNpm(paths.npmtsPackageRoot);
+    // check for updates
+    plugins.smartupdate.standardHandler.check('npmts', npmtsProjectInfo.version);
     let npmtsCli = new plugins.smartcli.Smartcli();
     npmtsCli.standardTask()
         .then((argvArg) => {

dist/npmts.config.d.ts

@@ -1,12 +1,25 @@
-export declare type npmtsMode = 'default' | 'custom';
+import { ITapbufferConfig } from 'tapbuffer';
+/**
+ * specifies the different modes available
+ * default -> uses default options no matterm what
+ * merge -> uses merged default + custom options
+ * custom -> only uses specified options
+ */
+export declare type npmtsMode = 'default' | 'custom' | 'merge';
 export interface INpmtsConfig {
     argv: any;
     coverageTreshold: number;
+    checkDependencies: boolean;
     mode: npmtsMode;
     test: boolean;
     testTs: any;
+    testConfig: ITapbufferConfig;
     ts: any;
     tsOptions: any;
     watch: boolean;
+    runData: {
+        coverageLcovInfo?: string;
+        coverageResult?: number;
+    };
 }
 export declare let run: (argvArg: any) => Promise<{}>;

dist/npmts.config.js

@@ -1,19 +1,25 @@
 "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
 const plugins = require("./npmts.plugins");
 const paths = require("./npmts.paths");
 const q = require("smartq");
-;
 exports.run = function (argvArg) {
     let done = q.defer();
     let defaultConfig = {
         argv: undefined,
         coverageTreshold: 70,
+        checkDependencies: true,
         mode: 'default',
         test: true,
         testTs: {},
+        testConfig: {
+            parallel: true,
+            coverage: true
+        },
         ts: {},
         tsOptions: {},
-        watch: false
+        watch: false,
+        runData: {}
     };
     // mix with configfile
     plugins.beautylog.ora.text('running npmextra');
@@ -25,16 +31,16 @@ exports.run = function (argvArg) {
     switch (config.mode) {
         case 'default':
         case 'custom':
+        case 'merge':
             plugins.beautylog.ok('mode is ' + config.mode);
             done.resolve(config);
             break;
         default:
-            plugins.beautylog.error(`mode not recognised!`);
+            plugins.beautylog.error(`mode not recognised! Can be default or custom`);
             process.exit(1);
     }
-    ;
     // handle default mode
-    if (config.mode === 'default') {
+    if (config.mode === 'default' || config.mode === 'merge') {
         config.ts = {
             './ts/**/*.ts': './dist/'
         };
@@ -42,16 +48,19 @@ exports.run = function (argvArg) {
             './test/**/*.ts': './test/'
         };
     }
-    ;
     // mix with commandline
     if (config.argv.notest) {
         config.test = false;
     }
-    ;
+    if (config.argv.nocoverage) {
+        config.testConfig.coverage = false;
+    }
+    if (config.argv.nochecks) {
+        config.checkDependencies = false;
+    }
     if (config.argv.watch) {
         config.watch = true;
     }
-    ;
     plugins.beautylog.ok('build options are ready!');
     done.resolve(config);
     return done.promise;

dist/npmts.mods.js

@@ -1,4 +1,5 @@
 "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
 const smartsystem_1 = require("smartsystem");
 exports.mod00 = new smartsystem_1.LazyModule('./mod00/index', __dirname);
 exports.mod01 = new smartsystem_1.LazyModule('./mod01/index', __dirname);

dist/npmts.paths.js

@@ -1,4 +1,5 @@
 "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
 const plugins = require("./npmts.plugins");
 // NPMTS Paths
 exports.npmtsPackageRoot = plugins.path.join(__dirname, '../');

dist/npmts.plugins.d.ts

@@ -5,14 +5,14 @@ import * as lodash from 'lodash';
 import * as npmextra from 'npmextra';
 import * as projectinfo from 'projectinfo';
 import * as path from 'path';
+import * as smartanalytics from 'smartanalytics';
 import * as smartcli from 'smartcli';
-import * as smartcov from 'smartcov';
-import * as smartenv from 'smartenv';
+import * as smarterror from 'smarterror';
 import * as smartfile from 'smartfile';
 import * as smartpath from 'smartpath';
 import * as smartstream from 'smartstream';
 import * as smartstring from 'smartstring';
 import * as smartsystem from 'smartsystem';
+import * as smartupdate from 'smartupdate';
 import * as through2 from 'through2';
-export declare let sourceMapSupport: any;
-export { beautylog, depcheck, lodash, npmextra, projectinfo, path, smartcli, smartcov, smartenv, smartfile, smartpath, smartstream, smartstring, smartsystem, through2 };
+export { beautylog, depcheck, lodash, npmextra, projectinfo, path, smartanalytics, smartcli, smarterror, smartfile, smartpath, smartstream, smartstring, smartsystem, smartupdate, through2 };

dist/npmts.plugins.js

@@ -1,4 +1,5 @@
 "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
 require("typings-global");
 const beautylog = require("beautylog");
 exports.beautylog = beautylog;
@@ -12,12 +13,12 @@ const projectinfo = require("projectinfo");
 exports.projectinfo = projectinfo;
 const path = require("path");
 exports.path = path;
+const smartanalytics = require("smartanalytics");
+exports.smartanalytics = smartanalytics;
 const smartcli = require("smartcli");
 exports.smartcli = smartcli;
-const smartcov = require("smartcov");
-exports.smartcov = smartcov;
-const smartenv = require("smartenv");
-exports.smartenv = smartenv;
+const smarterror = require("smarterror");
+exports.smarterror = smarterror;
 const smartfile = require("smartfile");
 exports.smartfile = smartfile;
 const smartpath = require("smartpath");
@@ -28,6 +29,7 @@ const smartstring = require("smartstring");
 exports.smartstring = smartstring;
 const smartsystem = require("smartsystem");
 exports.smartsystem = smartsystem;
+const smartupdate = require("smartupdate");
+exports.smartupdate = smartupdate;
 const through2 = require("through2");
 exports.through2 = through2;
-exports.sourceMapSupport = require('source-map-support').install(); // display errors correctly during testing

dist/npmts.ship.js

@@ -1,4 +1,5 @@
 "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
 const q = require("smartq");
 const plugins = require("./npmts.plugins");
 exports.run = (configArg) => {

dist/npmts.watch.js

@@ -1,4 +1,5 @@
 "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
 const q = require("smartq");
 const smartchok = require("smartchok");
 const plugins = require("./npmts.plugins");

docs/00footer.md

@@ -0,0 +1,9 @@
+[Legal Info](https://lossless.gmbh)
+[Privacy Policy](https://lossless.gmbh/privacy.html)
+///
+[Git.Zone](https://git.zone)
+<span>tools for a seamless dev workflow</span>
+
+[Lossless GmbH](https://push.rocks)
+<span>the company behind git.zone and npmts</span>
+///

docs/changelog.md

@@ -0,0 +1,9 @@
+# Changelog
+
+## 2017-07-30: Version 7.x.x -> 8.x.x
+Testfiles in ./test/ can now import files directly from the ts dir:
+
+```javascript
+// ./test/test.ts
+import * as myModule from '../ts/index
+```

docs/config.md

@@ -1,5 +1,8 @@
-# Configuration of NPMTS
-npmts can be configured to your needs:
+---
+name: config
+---
+# Configuration
+npmts can be configured to your needs.
 
 ### npmextra.json
 the npmts section in npmextra.json can be used to configure npmts.
@@ -36,11 +39,12 @@ with default behaviour.
 
 | key | default value | description |
 | --- | --- | --- |
-| `"mode"` | `"default"` | "default" will do default stuff and override , "custom" only does what you specify |
+| `"mode"` | `"default"` | "default" will do default stuff and override , "custom" only does what you specify, "merge" will merge default options with whatever you specify on your own |
 | `"test"` | `true` | test your module |
 | `"ts"` | `{"./ts/*.ts":"./","./test/test.ts":"./test/"}` | allows you to define multiple ts portions |
 | `"tsOptions"` | `{"target":"ES5", "declaration":"true"}` | specify options for tsc |
-| `"cli"` | "false" | some modules are designed to be used from cli. If set to true NPMTS will create a cli.js that wires you dist files up for cli use. |
+| `"cli"` | `"false"` | some modules are designed to be used from cli. If set to true NPMTS will create a cli.js that wires you dist files up for cli use. |
+| `"testConfig"` | `{ parallel: true, coverage: true }` | allows you to control test behaviour. `"parallel"` controls wether testfiles are run sequentially or in parallel, and `"coverage` wether to create coverage reports |
 
 ### TypeScript
 by default npmts looks for `./ts/*.ts` and `./test/test.ts` that will compile to

docs/default.md

@@ -1,7 +1,11 @@
-# Default task execution of npmts
+---
+name: Default Behaviour
+---
+# Default Behaviour
+when you don't configure it otherwise.
 
 1. **Config:** Check config in ./npmextra.json (Check out [npmextra](https://www.npmjs.com/package/npmextra))
 1. **Clean:** Clean up from any previous builds (old js files)
 1. **Check:** Check project for typings declaration in package.json, unused dependencies and missing dependencies
 1. **Transpile:** Transpile TypeScript with **inline sourcemaps** and **declaration files** to ES target
-1. **Test:** Babelify ES6 to ES5 on the fly, instrumentalize ES5 JavaScript with istanbul and run tests with Mocha.
+1. **Test:** transpile TypeScript of module to ES5 for tests (so it can be instrumentalized) and pipe it to tapbuffer. All this happens in memory.

docs/examples.md

@@ -1,13 +1,21 @@
-# Examples for npmts
+---
+name: Examples
+---
+# Examples
+modules that use npmts in theis development workflow
 
-## Example Usage in modules:
-* [gulp-browser](https://www.npmjs.com/package/gulp-browser)
+Module Name | Description
+--- | ---
+[gitzone](https://www.npmjs.com/package/gitzone) | fast npm module prototyping
+[gulp-browser](https://www.npmjs.com/package/gulp-browser) | browserify for gulp
+[npmdocker](https://www.npmjs.com/package/npmdocker) | dockerized npm development
+[smartcli](https://www.npmjs.com/package/smartcli) | easy cli tool creation
 
-> We will add more options over time.
+> There are tons more... We will add them here over time.
 
-## Tips and tricks:
+### Tips and tricks:
 
 * Use [npmts-g](https://www.npmjs.com/package/npmts-g) to use globally installed npmts and install npmts locally if no global npmts is available.
 * Use [npmpage](https://www.npmjs.com/package/npmpage) to create a webpage from coverage reports and TypeDoc for the module
-* Use [hosttoday/ht-docker-node:npmts](https://hub.docker.com/r/hosttoday/ht-docker-node/) for speedy CI builds
+* Use [hosttoday/ht-docker-node:npmci](https://hub.docker.com/r/hosttoday/ht-docker-node/) for speedy CI builds
 * Use [npmdocker](https://www.npmjs.com/package/npmdocker) for running tests consistently with docker.

docs/getstarted.md

@@ -0,0 +1,38 @@
+---
+name: Get Started
+description: learn how to quickly write npm TypeScript modules
+---
+# Get Started with NPMTS
+and learn how to quickly write npm TypeScript modules
+
+## Step1: Install the tools
+
+To use npmts install it using npm or yarn:
+
+```sh
+npm install -g npmts # install with npm
+yarn global add npmts # install with yarn
+```
+
+For the purpose of getting started quickly please also install **gitzone**.
+It'll proovide awesome scaffolding for new npmts maintained modules and also updates them later on. 
+
+```sh
+npm install -g gitzone # install with npm
+yarn global add gitzone # install with yarn
+```
+
+You can make sure npmts and gitzone are installed correctly by typing `npmts -v && gitzone -v`.
+
+## Scaffold a new module
+
+To scaffold a new module type
+
+```shell
+gitzone template npm
+```
+
+This will run you through a series of question to get gitzone to know the specifics of your module.
+Enter all information accordingly.
+
+## Run NPMTS for the first time

docs/index.md

@@ -1,44 +1,46 @@
+---
+name: Index
+description: best practice npm TypeScript modules
+---
 # npmts
-Write npm modules with TypeScript without hassle. TypeScript ready. Fully ES6.
+best practice npm TypeScript modules
 
 ## Availabililty
-[![npm](https://push.rocks/assets/repo-button-npm.svg)](https://www.npmjs.com/package/npmts)
-[![git](https://push.rocks/assets/repo-button-git.svg)](https://gitlab.com/pushrocks/npmts)
-[![git](https://push.rocks/assets/repo-button-mirror.svg)](https://github.com/pushrocks/npmts)
-[![docs](https://push.rocks/assets/repo-button-docs.svg)](https://pushrocks.gitlab.io/npmts/)
+[![npm](https://gitzone.gitlab.io/assets/repo-button-npm.svg)](https://www.npmjs.com/package/npmts)
+[![git](https://gitzone.gitlab.io/assets/repo-button-git.svg)](https://GitLab.com/gitzone/npmts)
+[![git](https://gitzone.gitlab.io/assets/repo-button-mirror.svg)](https://github.com/gitzone/npmts)
+[![docs](https://gitzone.gitlab.io/assets/repo-button-docs.svg)](https://gitzone.gitlab.io/npmts/)
 
 ## Status for master
-[![build status](https://gitlab.com/pushrocks/npmts/badges/master/build.svg)](https://gitlab.com/pushrocks/npmts/commits/master)
-[![coverage report](https://gitlab.com/pushrocks/npmts/badges/master/coverage.svg)](https://gitlab.com/pushrocks/npmts/commits/master)
+[![build status](https://GitLab.com/gitzone/npmts/badges/master/build.svg)](https://GitLab.com/gitzone/npmts/commits/master)
+[![coverage report](https://GitLab.com/gitzone/npmts/badges/master/coverage.svg)](https://GitLab.com/gitzone/npmts/commits/master)
 [![npm downloads per month](https://img.shields.io/npm/dm/npmts.svg)](https://www.npmjs.com/package/npmts)
-[![docker pulls](https://img.shields.io/docker/pulls/hosttoday/ht-docker-node.svg)](https://hub.docker.com/r/hosttoday/ht-docker-node/)
-[![Dependency Status](https://david-dm.org/pushrocks/npmts.svg)](https://david-dm.org/pushrocks/npmts)
-[![bitHound Dependencies](https://www.bithound.io/github/pushrocks/npmts/badges/dependencies.svg)](https://www.bithound.io/github/pushrocks/npmts/master/dependencies/npm)
-[![bitHound Code](https://www.bithound.io/github/pushrocks/npmts/badges/code.svg)](https://www.bithound.io/github/pushrocks/npmts)
+[![Dependency Status](https://david-dm.org/gitzonetools/npmts.svg)](https://david-dm.org/gitzonetools/npmts)
+[![bitHound Dependencies](https://www.bithound.io/github/gitzonetools/npmts/badges/dependencies.svg)](https://www.bithound.io/github/gitzonetools/npmts/master/dependencies/npm)
+[![bitHound Code](https://www.bithound.io/github/gitzonetools/npmts/badges/code.svg)](https://www.bithound.io/github/gitzonetools/npmts)
 [![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/)
 
-## Introduction
+## Quick Demo
+[![asciicast](https://asciinema.org/a/9c3assmh21i49qhe5lmi48sze.png)](https://asciinema.org/a/9c3assmh21i49qhe5lmi48sze?speed=2&t=0)
+
+## Usage
 NPMTS is your friend when writing, testing, publishing and documenting npm modules written in TypeScript.
 
 npmts will
     
-1. check your dependencies and package.json
+1. check your dependencies and package.json (unused, missing, updates, security)
 1. transpile your code with tsc,
-1. document your code with typedoc,
-1. test your code with mocha
-1. create coverage with istanbul
+1. test your code with tap (supports the fancy stuff like Promises, Generators, async/await, sourcemaps, parallel test execution in child processes)
+1. create coverage with istanbul (supports tracing of the originating TypeScript)
+
+For more information on how tests are run check out the [tapbuffer module](https://www.npmjs.com/package/tapbuffer).
 
 This works on your machine and in CI. There is a prebuild docker image available that includes npmts to make CI a breeze:  
 [hosttoday/ht-docker-node:npmts on Dockerhub](https://hub.docker.com/r/hosttoday/ht-docker-node/)
 
-For further information read the docs:
-1. [Intro](https://pushrocks.gitlab.io/npmts/index.html)
-2. [Install](https://pushrocks.gitlab.io/npmts/install.html)
-3. [Default Behaviour](https://pushrocks.gitlab.io/npmts/default.html)
-4. [Configuration](https://pushrocks.gitlab.io/npmts/config.html)
-5. [Examples](https://pushrocks.gitlab.io/npmts/examples.html)
-6. [Info](https://pushrocks.gitlab.io/npmts/info.html)
+> MIT licensed | **©** [Lossless GmbH](https://lossless.gmbh)
+| By using this npm module you agree to our [privacy policy](https://lossless.gmbH/privacy.html)
 
-[![npm](https://push.rocks/assets/repo-header.svg)](https://push.rocks)
+[![repo-footer](https://gitzone.gitlab.io/assets/repo-footer.svg)](https:/git.zone)

docs/info.md

@@ -1,14 +0,0 @@
-# Info
-
-## Future Scope:
-* automatically manage badges in README
-* manage tslint to enforce code best practices
-* tear down any differences between local and CI environments by using brand new npmdocker
-
-## About the authors:
-[![Project Phase](https://mediaserve.lossless.digital/lossless.com/img/createdby_github.svg)](https://lossless.com/)
-
-[![PayPal](https://img.shields.io/badge/Support%20us-PayPal-blue.svg)](https://paypal.me/lossless)
-
-## Legal Info
-https://lossless.gmbh

docs/install.md

@@ -1,5 +1,5 @@
 # Install npmts
-First install npmts globally, then install the npmts-g locally.
+Get started with TypeScript awesomeness.
 
 > **npmts-g* checks if the global version of npmts suffices the modules requirements.
 If not it installs npmts locally in the right version during npm install. 

docs/summary.md

@@ -1,8 +0,0 @@
-# Summary
-
-* [1. Intro](index.md)
-* [2. Install](install.md)
-* [3. Default Behaviour](default.md)
-* [4. Configuration](config.md)
-* [5. Examples](examples.md)
-* [6. Info](info.md)

package.json

@@ -1,7 +1,7 @@
 {
   "name": "npmts",
-  "version": "6.1.11",
-  "description": "Write npm modules with TypeScript without hassle. TypeScript ready. Fully ES6.",
+  "version": "8.0.7",
+  "description": "best practice npm TypeScript modules",
   "main": "dist/index.js",
   "bin": {
     "npmts": "assets/cliNpmts.js"
@@ -14,14 +14,14 @@
     "setupCheck": "(git clone https://gitlab.com/sandboxzone/sandbox-npmts.git test/)",
     "typedoc": "(typedoc --out ./pages/api --target ES6 ./ts/)",
     "npmpage": "(npmpage)",
-    "check": "(cd test && npm install && node ../dist/index.js)",
+    "check": "(cd test && yarn install && node ../dist/index.js)",
     "checkVersion": "(cd test/ && node ../dist/index.js -v)",
     "checkNoTest": "(cd test && node ../dist/index.js --notest)",
     "checkNoDocs": "(cd test && node ../dist/index.js --nodocs)"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://gitlab.com/pushrocks/npmts.git"
+    "url": "git+https://gitlab.com/gitzone/npmts.git"
   },
   "keywords": [
     "TypeScript",
@@ -30,44 +30,40 @@
   "author": "Lossless GmbH",
   "license": "MIT",
   "bugs": {
-    "url": "https://gitlab.com/pushrocks/npmts/issues"
+    "url": "https://gitlab.com/gitzone/npmts/issues"
   },
-  "homepage": "https://gitlab.com/pushrocks/npmts#readme",
+  "homepage": "https://gitlab.com/gitzone/npmts#readme",
   "dependencies": {
-    "@types/gulp": "^3.8.32",
-    "@types/gulp-istanbul": "^0.9.30",
-    "@types/gulp-mocha": "0.0.29",
-    "@types/gulp-sourcemaps": "0.0.29",
-    "@types/minimatch": "^2.0.29",
-    "@types/through2": "^2.0.32",
-    "beautylog": "6.1.1",
+    "@types/gulp-sourcemaps": "0.0.31",
+    "@types/minimatch": "^3.0.0",
+    "@types/through2": "^2.0.33",
+    "beautylog": "^6.1.10",
     "depcheck": "^0.6.7",
-    "early": "^2.0.35",
-    "gulp": "3.9.1",
-    "gulp-function": "^2.2.3",
-    "gulp-inject-modules": "^1.0.0",
-    "gulp-istanbul": "^1.1.1",
-    "gulp-mocha": "^3.0.1",
-    "gulp-sourcemaps": "^2.4.0",
-    "gulp-typescript": "^3.1.4",
+    "early": "^2.1.1",
+    "gulp-function": "^2.2.9",
+    "gulp-sourcemaps": "^2.6.0",
+    "gulp-typescript": "^3.2.1",
     "lodash": "^4.17.4",
-    "npmextra": "^2.0.3",
-    "projectinfo": "3.0.1",
-    "smartchok": "^1.0.4",
-    "smartcli": "2.0.1",
-    "smartcov": "1.0.0",
-    "smartenv": "2.0.0",
-    "smartfile": "4.1.4",
-    "smartpath": "3.2.7",
-    "smartq": "^1.1.0",
-    "smartstream": "^1.0.5",
-    "smartstring": "^2.0.22",
-    "smartsystem": "^1.0.12",
-    "source-map-support": "^0.4.11",
+    "npmextra": "^2.0.9",
+    "projectinfo": "^3.0.2",
+    "smartanalytics": "^1.0.6",
+    "smartchok": "^1.0.11",
+    "smartcli": "^2.0.7",
+    "smartcov": "^1.0.2",
+    "smarterror": "^1.0.3",
+    "smartfile": "^4.2.20",
+    "smartgulp": "^1.0.6",
+    "smartpath": "^3.2.8",
+    "smartq": "^1.1.6",
+    "smartstream": "^1.0.10",
+    "smartstring": "^2.0.24",
+    "smartsystem": "^2.0.2",
+    "smartupdate": "^1.0.4",
+    "tapbuffer": "^1.0.29",
     "through2": "^2.0.3",
     "tsn": "^2.0.15",
-    "typescript": "^2.1.5",
-    "typings-global": "^1.0.14"
+    "typescript": "^2.4.2",
+    "typings-global": "^1.0.20"
   },
   "devDependencies": {}
 }

readme.md

@@ -0,0 +1,49 @@
+# npmts
+best practice npm TypeScript modules
+
+## Availabililty
+[![npm](https://gitzone.gitlab.io/assets/repo-button-npm.svg)](https://www.npmjs.com/package/npmts)
+[![git](https://gitzone.gitlab.io/assets/repo-button-git.svg)](https://GitLab.com/gitzone/npmts)
+[![git](https://gitzone.gitlab.io/assets/repo-button-mirror.svg)](https://github.com/gitzone/npmts)
+[![docs](https://gitzone.gitlab.io/assets/repo-button-docs.svg)](https://gitzone.gitlab.io/npmts/)
+
+## Status for master
+[![build status](https://GitLab.com/gitzone/npmts/badges/master/build.svg)](https://GitLab.com/gitzone/npmts/commits/master)
+[![coverage report](https://GitLab.com/gitzone/npmts/badges/master/coverage.svg)](https://GitLab.com/gitzone/npmts/commits/master)
+[![npm downloads per month](https://img.shields.io/npm/dm/npmts.svg)](https://www.npmjs.com/package/npmts)
+[![Dependency Status](https://david-dm.org/gitzonetools/npmts.svg)](https://david-dm.org/gitzonetools/npmts)
+[![bitHound Dependencies](https://www.bithound.io/github/gitzonetools/npmts/badges/dependencies.svg)](https://www.bithound.io/github/gitzonetools/npmts/master/dependencies/npm)
+[![bitHound Code](https://www.bithound.io/github/gitzonetools/npmts/badges/code.svg)](https://www.bithound.io/github/gitzonetools/npmts)
+[![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/)
+
+## Quick Demo
+[![asciicast](https://asciinema.org/a/9c3assmh21i49qhe5lmi48sze.png)](https://asciinema.org/a/9c3assmh21i49qhe5lmi48sze?speed=2&t=0)
+
+## Usage
+NPMTS is your friend when writing, testing, publishing and documenting npm modules written in TypeScript.
+
+npmts will
+
+1. check your dependencies and package.json (unused, missing, updates, security)
+1. transpile your code with tsc,
+1. test your code with tap (supports the fancy stuff like Promises, Generators, async/await, sourcemaps, parallel test execution in child processes)
+1. create coverage with istanbul (supports tracing of the originating TypeScript)
+
+For more information on how tests are run check out the [tapbuffer module](https://www.npmjs.com/package/tapbuffer).
+
+For more information about how to best write tap tests check out the [tapbundle module's linked docs](https://www.npmjs.com/package/tapbundle).
+
+This works on your machine and in CI. There is a prebuild docker image available that includes npmts to make CI a breeze:  
+[hosttoday/ht-docker-node:npmts on Dockerhub](https://hub.docker.com/r/hosttoday/ht-docker-node/)
+
+## Changelog
+For breaking changes please see the [changelog](https://gitzone.gitlab.io/npmts/changelog.html).
+
+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://gitzone.gitlab.io/assets/repo-footer.svg)](https://push.rocks)

ts/mod00/index.ts

@@ -1,5 +1,6 @@
 /* ------------------------------------------
- * This module compiles TypeScript files
+ * This module compiles the module's TypeScript files
+ * Note: Test files are only compiled in memory
  * -------------------------------------------- */
 import * as q from 'smartq'
 

ts/mod00/mod00.assets.ts

@@ -8,7 +8,7 @@ import { projectInfo } from '../mod00/mod00.check'
 export let run = function(configArg){
     let done = q.defer()
     let config = configArg
-    plugins.beautylog.ora.text('now looking at ' + 'required assets'.yellow)
+    plugins.beautylog.ora.text('now looking at ' + 'required assets')
     if (config.cli === true) {
         let mainJsPath = projectInfo.packageJson.main
         let cliJsString: string = plugins.smartfile.fs.toStringSync(plugins.path.join(paths.npmtsAssetsDir,'cli.js'))

ts/mod00/mod00.check.ts

@@ -1,14 +1,17 @@
 import * as q from 'smartq'
 import { ProjectinfoNpm } from 'projectinfo'
 
+// interfaces
+import { INpmtsConfig } from '../npmts.config'
+
 import * as paths from '../npmts.paths'
 
 import * as plugins from './mod00.plugins'
 
 export let projectInfo: ProjectinfoNpm
 
-let checkProjectTypings = (configArg) => {
-    let done = q.defer()
+let checkProjectTypings = (configArg: INpmtsConfig) => {
+  let done = q.defer<INpmtsConfig>()
   plugins.beautylog.ora.text('Check Module: Check Project Typings...')
   projectInfo = new ProjectinfoNpm(paths.cwd)
   if (typeof projectInfo.packageJson.typings === 'undefined') {
@@ -34,8 +37,8 @@ const depcheckOptions = {
   ]
 }
 
-let checkDependencies = (configArg) => {
-    let done = q.defer()
+let checkDependencies = (configArg: INpmtsConfig) => {
+  let done = q.defer<INpmtsConfig>()
   plugins.beautylog.ora.text('Check Module: Check Dependencies...')
   let depcheckOptionsMerged = plugins.lodash.merge(depcheckOptions, {
     ignoreDirs: [ // folder with these names will be ignored
@@ -60,18 +63,18 @@ let checkDependencies = (configArg) => {
       process.exit(1)
     }
     for (let item in unused.invalidFiles) {
-            plugins.beautylog.warn(`Watch out: could not parse file ${item.red}`)
+      plugins.beautylog.warn(`Watch out: could not parse file ${item}`)
     };
     for (let item in unused.invalidDirs) {
-            plugins.beautylog.warn(`Watch out: could not parse directory ${item.red}`)
+      plugins.beautylog.warn(`Watch out: could not parse directory ${item}`)
     }
     done.resolve(configArg)
   })
   return done.promise
 }
 
-let checkDevDependencies = (configArg) => {
-    let done = q.defer()
+let checkDevDependencies = (configArg: INpmtsConfig) => {
+  let done = q.defer<INpmtsConfig>()
   plugins.beautylog.ora.text('Check Module: Check devDependencies...')
   let depcheckOptionsMerged = plugins.lodash.merge(depcheckOptions, {
     ignoreDirs: [ // folder with these names will be ignored
@@ -86,41 +89,44 @@ let checkDevDependencies = (configArg) => {
   })
   plugins.depcheck(paths.cwd, depcheckOptionsMerged, (unused) => {
     for (let item of unused.devDependencies) {
-            plugins.beautylog.log(`unused devDependency ${item.red}`)
+      plugins.beautylog.log(`unused devDependency ${item}`)
     }
     for (let item in unused.missing) {
-            plugins.beautylog.error(`unused devDependency ${item.red}`)
+      plugins.beautylog.error(`missing devDependency ${item}`)
     }
     if (unused.missing.length > 0) {
       plugins.beautylog.info('exiting due to missing dependencies in package.json')
       process.exit(1)
     }
     for (let item in unused.invalidFiles) {
-            plugins.beautylog.warn(`Watch out: could not parse file ${item.red}`)
+      plugins.beautylog.warn(`Watch out: could not parse file ${item}`)
     }
     for (let item in unused.invalidDirs) {
-            plugins.beautylog.warn(`Watch out: could not parse directory ${item.red}`)
+      plugins.beautylog.warn(`Watch out: could not parse directory ${item}`)
     }
     done.resolve(configArg)
   })
   return done.promise
 }
 
-let checkNodeVersion = (configArg) => {
-    let done = q.defer()
+let checkNodeVersion = (configArg: INpmtsConfig) => {
+  let done = q.defer<INpmtsConfig>()
   plugins.beautylog.ora.text('checking node version')
   done.resolve(configArg)
   return done.promise
 }
 
-export let run = (configArg) => {
-    let done = q.defer()
+export let run = async (configArg: INpmtsConfig) => {
   plugins.beautylog.ora.text('Check Module: ...')
-    checkProjectTypings(configArg)
-        .then(checkDependencies)
-        .then(checkDevDependencies)
-        .then(checkNodeVersion)
-        .then(done.resolve)
-        .catch((err) => { console.log(err) })
-    return done.promise
+
+  if (configArg.checkDependencies) {
+    configArg = await checkProjectTypings(configArg)
+    configArg = await checkDependencies(configArg)
+    configArg = await checkDevDependencies(configArg)
+    configArg = await checkNodeVersion(configArg)
+    return configArg
+  } else {
+    configArg = await checkProjectTypings(configArg)
+    return configArg
+  }
 }

ts/mod00/mod00.clean.ts

@@ -11,18 +11,6 @@ let removeDist = function () {
   return plugins.smartfile.fs.remove(paths.distDir)
 }
 
-/**
- * remove .d.ts files from testDirctory
- */
-let removeTestDeclarations = function () {
-    let done = q.defer()
-    plugins.smartfile.fs.listFileTree('./test/', '**/*.d.ts').then(fileArray => {
-        let fileArrayToRemove = plugins.smartpath.transform.toAbsolute(fileArray, process.cwd() + '//test/')
-        plugins.smartfile.fs.removeManySync(fileArrayToRemove)
-        done.resolve()
-    })
-}
-
 /**
  * remove old pages
  */
@@ -35,7 +23,6 @@ export let run = function (configArg) {
   plugins.beautylog.ora.text('cleaning up from previous builds...')
   let done = q.defer()
   removeDist()
-        .then(removeTestDeclarations)
     .then(removePages)
     .then(function () {
       plugins.beautylog.ok('Cleaned up from previous builds!')

ts/mod00/mod00.compile.ts

@@ -7,15 +7,10 @@ import * as plugins from './mod00.plugins'
 export let run = function (configArg) {
   let done = q.defer()
   let config = configArg
-    plugins.beautylog.ora.text('now compiling ' + 'TypeScript'.yellow)
+  plugins.beautylog.ora.text('now compiling ' + 'TypeScript')
   plugins.tsn.compileGlobStringObject(config.ts, config.tsOptions, paths.cwd)
     .then(() => {
-            plugins.beautylog.ok('compiled main TypeScript!')
-            plugins.beautylog.log('now compiling tests!')
-            return plugins.tsn.compileGlobStringObject(config.testTs,config.tsOptions,paths.cwd)
-        })
-        .then(function () {
-            plugins.beautylog.ok('compiled all TypeScript!')
+      plugins.beautylog.ok(`compiled the module's TypeScript!`)
       done.resolve(config)
     }).catch(err => { console.log(err) })
   return done.promise

ts/mod02/index.ts

@@ -6,19 +6,29 @@ import paths = require('../npmts.paths')
 
 import * as q from 'smartq'
 
+// interfaces
 import { INpmtsConfig } from '../npmts.config'
+import { Smartfile } from 'smartfile'
 
 /**
  * runs mocha
  * @returns INpmtsConfig
  */
-let mocha = function (configArg: INpmtsConfig) {
-    plugins.beautylog.ora.text('Instrumentalizing and testing transpiled JS')
-    plugins.beautylog.ora.end() // end plugins.beautylog.ora for tests.
+let tap = function (configArg: INpmtsConfig) {
   let done = q.defer()
 
-    let coverageSmartstream = new plugins.smartstream.Smartstream([
-        plugins.gulp.src([plugins.path.join(paths.cwd, './ts/**/*.ts')]),
+  /**
+   * the TabBuffer for npmts
+   */
+  let npmtsTapBuffer = new plugins.tapbuffer.TabBuffer()
+
+  npmtsTapBuffer.setConfig(configArg.testConfig)
+
+  /**
+   * handle the testable files
+   */
+  let testableFilesSmartstream = new plugins.smartstream.Smartstream([
+    plugins.smartgulp.src([ plugins.path.join(paths.cwd, './ts/**/*.ts') ]),
     plugins.gulpSourcemaps.init(),
     plugins.gulpTypeScript({
       target: 'ES5',
@@ -26,44 +36,37 @@ let mocha = function (configArg: INpmtsConfig) {
       experimentalDecorators: true,
       lib: [ 'DOM', 'ES5', 'ES2015.Promise', 'ES2015.Generator', 'ES2015.Iterable' ]
     }),
-        plugins.gulpIstanbul({
-        }),
     plugins.gulpSourcemaps.write(),
-        plugins.gulpFunction.forEach(async file => {
-            file.path = file.path.replace(paths.tsDir, paths.distDir)
-        }),
-        plugins.gulpInjectModules(),
-        plugins.through2.obj(
-            (file, enc, cb) => {
-                cb()
-            },
-            (cb) => {
-                cb()
-            }
-        )
+    npmtsTapBuffer.pipeTestableFiles(),
+    plugins.smartstream.cleanPipe()
   ])
 
-    let localSmartstream = new plugins.smartstream.Smartstream([
-        plugins.gulp.src([plugins.path.join(paths.cwd, 'test/test.ts')]),
+  /**
+   * handle the test files
+   */
+  let testFilesSmartstream = new plugins.smartstream.Smartstream([
+    plugins.smartgulp.src([ plugins.path.join(paths.cwd, 'test/*.ts') ]),
+    plugins.gulpSourcemaps.init(),
     plugins.gulpTypeScript({
       target: 'ES5',
       emitDecoratorMetadata: true,
       experimentalDecorators: true,
       lib: [ 'DOM', 'ES5', 'ES2015.Promise', 'ES2015.Generator', 'ES2015.Iterable' ]
     }),
-        plugins.gulpInjectModules(),
-        plugins.gulpMocha(),
-        plugins.gulpIstanbul.writeReports({
-            dir: plugins.path.join(paths.cwd, './coverage'),
-            reporters: ['lcovonly', 'json', 'text', 'text-summary']
-        })
+    plugins.gulpSourcemaps.write(),
+    npmtsTapBuffer.pipeTestFiles(),
+    plugins.smartstream.cleanPipe()
   ])
-    coverageSmartstream.run()
-        .then(
-        () => {
-            plugins.beautylog.info('code is now transpiled to ES5, instrumented with istanbul, and injected for mocha!')
-            return localSmartstream.run()
-                .then(() => { done.resolve(configArg) }, (err) => {
+
+  // lets run the smartstream
+  Promise.all([
+    testableFilesSmartstream.run(),
+    testFilesSmartstream.run()
+  ]).then(
+    async () => {
+      configArg.runData.coverageLcovInfo = await npmtsTapBuffer.runTests()
+      done.resolve(configArg)
+    }, (err) => {
       plugins.beautylog.error('Tests failed!')
       console.log(err)
       if (configArg.watch) {
@@ -72,35 +75,37 @@ let mocha = function (configArg: INpmtsConfig) {
         process.exit(1)
       }
     })
-        },
-        (err) => {
-            console.log(err)
-        })
+
   return done.promise
 }
 
-let coverage = function (configArg: INpmtsConfig) {
-    let done = q.defer()
-    plugins.smartcov.get.percentage(plugins.path.join(paths.coverageDir, 'lcov.info'), 2)
-        .then(function (percentageArg) {
-            if (percentageArg >= configArg.coverageTreshold) {
+let handleCoverageData = async (configArg: INpmtsConfig) => {
+  let coverageResult: number = 0 // the coverage in percent
+  if (configArg.runData.coverageLcovInfo) {
+    coverageResult = await plugins.smartcov.get.percentageFromLcovString(
+      configArg.runData.coverageLcovInfo,
+      2
+    )
+  } else {
+    plugins.beautylog.warn('Hey... Did your tests import and use your module that you are trying to test?')
+  }
+
+  if (coverageResult >= configArg.coverageTreshold) {
     plugins.beautylog.ok(
-                    `${percentageArg.toString()}% `
+      `${(coverageResult).toString()}% `
       + `coverage exceeds your treshold of `
       + `${configArg.coverageTreshold.toString()}%`
     )
   } else {
     plugins.beautylog.warn(
-                    `${percentageArg.toString()}% `
+      `${(coverageResult).toString()}% `
       + `coverage fails your treshold of `
       + `${configArg.coverageTreshold.toString()}%`
     )
     plugins.beautylog.error('exiting due to coverage failure')
     if (!configArg.watch) { process.exit(1) }
   }
-            done.resolve(configArg)
-        })
-    return done.promise
+  return configArg
 }
 
 export let run = function (configArg: INpmtsConfig) {
@@ -108,17 +113,21 @@ export let run = function (configArg: INpmtsConfig) {
   let config = configArg
   if (config.test === true) {
     plugins.beautylog.ora.text('now starting tests')
-        plugins.beautylog.log(
-            '------------------------------------------------------\n' +
-            '*************************** TESTS: ***************************\n' +
-            '--------------------------------------------------------------'
-        )
-
-        mocha(config)
-            .then(coverage)
+    plugins.beautylog.ora.end()
+    plugins.beautylog.log('ready for tapbuffer:')
+    if (configArg.testConfig.coverage) {
+      tap(config)
+        .then(handleCoverageData)
         .then(() => {
           done.resolve(config)
         }).catch(err => { console.log(err) })
+    } else {
+      tap(config)
+        .then(() => {
+          done.resolve(config)
+        }).catch(err => { console.log(err) })
+    }
+
   } else {
     plugins.beautylog.ora.end()
     done.resolve(config)

ts/mod02/mod02.plugins.ts

@@ -1,19 +1,17 @@
 export * from '../npmts.plugins'
 
-import * as gulp from 'gulp'
 import * as gulpFunction from 'gulp-function'
-import * as gulpIstanbul from 'gulp-istanbul'
-let gulpInjectModules = require('gulp-inject-modules')
-import * as gulpMocha from 'gulp-mocha'
 import * as gulpSourcemaps from 'gulp-sourcemaps'
 import * as gulpTypeScript from 'gulp-typescript'
+import * as smartcov from 'smartcov'
+import * as smartgulp from 'smartgulp'
+import * as tapbuffer from 'tapbuffer'
 
 export {
-    gulp,
     gulpFunction,
-    gulpIstanbul,
-    gulpInjectModules,
-    gulpMocha,
     gulpSourcemaps,
-    gulpTypeScript
+    gulpTypeScript,
+    smartcov,
+    smartgulp,
+    tapbuffer
 }

ts/npmts.cli.ts

@@ -7,9 +7,25 @@ import * as NpmtsMods from './npmts.mods'
 import * as NpmtsWatch from './npmts.watch'
 import * as NpmtsShip from './npmts.ship'
 
+/**
+ * smartanalytics
+ * this data is fully anonymized (no Ips or any other personal information is tracked).
+ * It just keeps track which of our tools are really used...
+ * ... so we know where to spend our limited resources for improving them.
+ * Since yarn is out and there is heavy caching going on,
+ * pure download stats are just not reliable enough for us anymore
+ * Feel free to dig into the smartanalytics package, if you are interested in how it works.
+ * It is just an https call to Google Analytics.
+ * Our privacy policy can be found here: https://lossless.gmbh/privacy.html
+ */
+let npmtsAnalytics = new plugins.smartanalytics.AnalyticsAccount('npmts','UA-64087619-5')
+npmtsAnalytics.sendEvent('npm','exec','git.zone')
+
 export let run = () => {
   let done = q.defer()
   let npmtsProjectInfo = new plugins.projectinfo.ProjectinfoNpm(paths.npmtsPackageRoot)
+  // check for updates
+  plugins.smartupdate.standardHandler.check('npmts', npmtsProjectInfo.version)
   let npmtsCli = new plugins.smartcli.Smartcli()
   npmtsCli.standardTask()
     .then((argvArg) => {

ts/npmts.config.ts

@@ -3,31 +3,51 @@ import paths = require('./npmts.paths')
 
 import * as q from 'smartq'
 
-export type npmtsMode = 'default' | 'custom'
+// interfaces
+import { ITapbufferConfig } from 'tapbuffer'
+
+/**
+ * specifies the different modes available
+ * default -> uses default options no matterm what
+ * merge -> uses merged default + custom options
+ * custom -> only uses specified options
+ */
+export type npmtsMode = 'default' | 'custom' | 'merge'
 
 export interface INpmtsConfig {
-    argv: any,
-    coverageTreshold: number,
-    mode: npmtsMode,
-    test: boolean,
-    testTs: any,
-    ts: any,
-    tsOptions: any,
+  argv: any
+  coverageTreshold: number
+  checkDependencies: boolean
+  mode: npmtsMode
+  test: boolean
+  testTs: any
+  testConfig: ITapbufferConfig
+  ts: any
+  tsOptions: any
   watch: boolean
-
-};
+  runData: {
+    coverageLcovInfo?: string
+    coverageResult?: number
+  }
+}
 
 export let run = function (argvArg) {
   let done = q.defer()
   let defaultConfig: INpmtsConfig = {
     argv: undefined,
     coverageTreshold: 70,
+    checkDependencies: true,
     mode: 'default',
     test: true,
     testTs: {},
+    testConfig: {
+      parallel: true,
+      coverage: true
+    },
     ts: {},
     tsOptions: {},
-        watch: false
+    watch: false,
+    runData: {}
   }
 
   // mix with configfile
@@ -46,31 +66,41 @@ export let run = function (argvArg) {
   switch (config.mode) {
     case 'default':
     case 'custom':
+    case 'merge':
       plugins.beautylog.ok('mode is ' + config.mode)
       done.resolve(config)
       break
     default:
-            plugins.beautylog.error(`mode not recognised!`)
+      plugins.beautylog.error(`mode not recognised! Can be default or custom`)
       process.exit(1)
-    };
+  }
 
   // handle default mode
-    if (config.mode === 'default') {
+  if (config.mode === 'default' || config.mode === 'merge') {
     config.ts = {
       './ts/**/*.ts': './dist/'
     }
     config.testTs = {
       './test/**/*.ts': './test/'
     }
-    };
+  }
 
   // mix with commandline
   if (config.argv.notest) {
     config.test = false
-    };
+  }
+
+  if (config.argv.nocoverage) {
+    config.testConfig.coverage = false
+  }
+
+  if (config.argv.nochecks) {
+    config.checkDependencies = false
+  }
+
   if (config.argv.watch) {
     config.watch = true
-    };
+  }
 
   plugins.beautylog.ok('build options are ready!')
   done.resolve(config)

ts/npmts.plugins.ts

@@ -6,16 +6,16 @@ import * as lodash from 'lodash'
 import * as npmextra from 'npmextra'
 import * as projectinfo from 'projectinfo'
 import * as path from 'path'
+import * as smartanalytics from 'smartanalytics'
 import * as smartcli from 'smartcli'
-import * as smartcov from 'smartcov'
-import * as smartenv from 'smartenv'
+import * as smarterror from 'smarterror'
 import * as smartfile from 'smartfile'
 import * as smartpath from 'smartpath'
 import * as smartstream from 'smartstream'
 import * as smartstring from 'smartstring'
 import * as smartsystem from 'smartsystem'
+import * as smartupdate from 'smartupdate'
 import * as through2 from 'through2'
-export let sourceMapSupport = require('source-map-support').install() // display errors correctly during testing
 
 export {
     beautylog,
@@ -24,13 +24,14 @@ export {
     npmextra,
     projectinfo,
     path,
+    smartanalytics,
     smartcli,
-    smartcov,
-    smartenv,
+    smarterror,
     smartfile,
     smartpath,
     smartstream,
     smartstring,
     smartsystem,
+    smartupdate,
     through2
 }