7.1.9

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
 
@@ -52,11 +60,11 @@ pages:
   stage: pages
   script:
     - npmci command yarn global add npmpage
-    - npmci command npmpage
-  only:
-    - tags
+    - npmci command npmpage --publish gitlab
   tags:
     - docker
+  only:
+    - tags
   artifacts:
     expire_in: 1 week
     paths:

dist/index.js

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

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,12 @@
 "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");
@@ -85,7 +93,7 @@ let checkDevDependencies = (configArg) => {
             plugins.beautylog.log(`unused devDependency ${item}`);
         }
         for (let item in unused.missing) {
-            plugins.beautylog.error(`unused devDependency ${item}`);
+            plugins.beautylog.error(`missing devDependency ${item}`);
         }
         if (unused.missing.length > 0) {
             plugins.beautylog.info('exiting due to missing dependencies in package.json');
@@ -107,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

@@ -10,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
  */
@@ -32,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/mod02/index.js

@@ -24,11 +24,31 @@ let tap = function (configArg) {
      * 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.gulp.src([plugins.path.join(paths.cwd, './ts/**/*.ts')]),
+        plugins.smartgulp.src([plugins.path.join(paths.cwd, './ts/**/*.ts')]),
+        plugins.gulpSourcemaps.init(),
+        plugins.gulpTypeScript({
+            target: 'ES5',
+            emitDecoratorMetadata: true,
+            experimentalDecorators: true,
+            lib: ['DOM', 'ES5', 'ES2015.Promise', 'ES2015.Generator', 'ES2015.Iterable']
+        }),
+        plugins.gulpFunction.forEach((file) => __awaiter(this, void 0, void 0, function* () {
+            file.path = file.path.replace(paths.tsDir, paths.distDir);
+        })),
+        plugins.gulpSourcemaps.write(),
+        npmtsTapBuffer.pipeTestableFiles(),
+        plugins.smartstream.cleanPipe()
+    ]);
+    /**
+     * 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',
@@ -37,23 +57,6 @@ let tap = function (configArg) {
             lib: ['DOM', 'ES5', 'ES2015.Promise', 'ES2015.Generator', 'ES2015.Iterable']
         }),
         plugins.gulpSourcemaps.write(),
-        plugins.gulpFunction.forEach((file) => __awaiter(this, void 0, void 0, function* () {
-            file.path = file.path.replace(paths.tsDir, paths.distDir);
-        })),
-        npmtsTapBuffer.pipeTestableFiles(),
-        plugins.smartstream.cleanPipe()
-    ]);
-    /**
-     * handle the test files
-     */
-    let testFilesSmartstream = new plugins.smartstream.Smartstream([
-        plugins.gulp.src([plugins.path.join(paths.cwd, 'test/*.ts')]),
-        plugins.gulpTypeScript({
-            target: 'ES5',
-            emitDecoratorMetadata: true,
-            experimentalDecorators: true,
-            lib: ['DOM', 'ES5', 'ES2015.Promise', 'ES2015.Generator', 'ES2015.Iterable']
-        }),
         npmtsTapBuffer.pipeTestFiles(),
         plugins.smartstream.cleanPipe()
     ]);
@@ -77,7 +80,13 @@ let tap = function (configArg) {
     return done.promise;
 };
 let handleCoverageData = (configArg) => __awaiter(this, void 0, void 0, function* () {
-    let coverageResult = yield plugins.smartcov.get.percentageFromLcovString(configArg.runData.coverageLcovInfo, 2);
+    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 `
@@ -101,11 +110,19 @@ exports.run = function (configArg) {
         plugins.beautylog.ora.text('now starting tests');
         plugins.beautylog.ora.end();
         plugins.beautylog.log('ready for tapbuffer:');
-        tap(config)
-            .then(handleCoverageData)
-            .then(() => {
-            done.resolve(config);
-        }).catch(err => { console.log(err); });
+        if (configArg.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();

dist/mod02/mod02.plugins.d.ts

@@ -1,8 +1,8 @@
 export * from '../npmts.plugins';
-import * as gulp from 'gulp';
 import * as gulpFunction from 'gulp-function';
 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, gulpSourcemaps, gulpTypeScript, smartcov, tapbuffer };
+export { gulpFunction, gulpSourcemaps, gulpTypeScript, smartcov, smartgulp, tapbuffer };

dist/mod02/mod02.plugins.js

@@ -4,8 +4,6 @@ function __export(m) {
 }
 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 gulpSourcemaps = require("gulp-sourcemaps");
@@ -14,5 +12,7 @@ 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.config.d.ts

@@ -1,10 +1,19 @@
-export declare type npmtsMode = 'default' | 'custom';
+/**
+ * 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;
+    coverage: boolean;
     coverageTreshold: number;
+    checkDependencies: boolean;
     mode: npmtsMode;
     test: boolean;
     testTs: any;
+    testConfig: any;
     ts: any;
     tsOptions: any;
     watch: boolean;

dist/npmts.config.js

@@ -3,15 +3,19 @@ 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,
+        coverage: true,
         coverageTreshold: 70,
+        checkDependencies: true,
         mode: 'default',
         test: true,
         testTs: {},
+        testConfig: {
+            parallel: true
+        },
         ts: {},
         tsOptions: {},
         watch: false,
@@ -27,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/'
         };
@@ -44,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.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.plugins.d.ts

@@ -7,12 +7,11 @@ import * as projectinfo from 'projectinfo';
 import * as path from 'path';
 import * as smartanalytics from 'smartanalytics';
 import * as smartcli from 'smartcli';
-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 through2 from 'through2';
-export declare let sourceMapSupport: any;
-export { beautylog, depcheck, lodash, npmextra, projectinfo, path, smartanalytics, smartcli, smartenv, smartfile, smartpath, smartstream, smartstring, smartsystem, through2 };
+export { beautylog, depcheck, lodash, npmextra, projectinfo, path, smartanalytics, smartcli, smarterror, smartfile, smartpath, smartstream, smartstring, smartsystem, through2 };

dist/npmts.plugins.js

@@ -17,8 +17,8 @@ const smartanalytics = require("smartanalytics");
 exports.smartanalytics = smartanalytics;
 const smartcli = require("smartcli");
 exports.smartcli = smartcli;
-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");
@@ -31,4 +31,3 @@ const smartsystem = require("smartsystem");
 exports.smartsystem = smartsystem;
 const through2 = require("through2");
 exports.through2 = through2;
-exports.sourceMapSupport = require('source-map-support').install(); // display errors correctly during testing

docs/config.md

@@ -2,9 +2,7 @@
 name: config
 ---
 # Configuration
-## of npmts
-
-npmts can be configured to your needs:
+npmts can be configured to your needs.
 
 ### npmextra.json
 the npmts section in npmextra.json can be used to configure npmts.

docs/default.md

@@ -2,7 +2,7 @@
 name: Default Behaviour
 ---
 # Default Behaviour
-## of npmts
+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)

docs/examples.md

@@ -2,14 +2,16 @@
 name: Examples
 ---
 # Examples
-## of modules that use npmts
+modules that use npmts in theis development workflow
 
 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:
 

docs/index.md

@@ -2,7 +2,7 @@
 name: Start
 ---
 # npmts
-## Write npm modules with TypeScript without hassle. TypeScript ready. Fully ES6.
+Write npm modules with TypeScript without hassle. TypeScript ready. Fully ES6.
 
 ## Availabililty
 [![npm](https://gitzone.gitlab.io/assets/repo-button-npm.svg)](https://www.npmjs.com/package/npmts)
@@ -14,13 +14,16 @@ name: Start
 [![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/gitzone/npmts.svg)](https://david-dm.org/gitzone/npmts)
-[![bitHound Dependencies](https://www.bithound.io/github/gitzone/npmts/badges/dependencies.svg)](https://www.bithound.io/github/gitzone/npmts/master/dependencies/npm)
-[![bitHound Code](https://www.bithound.io/github/gitzone/npmts/badges/code.svg)](https://www.bithound.io/github/gitzone/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.
 
@@ -39,4 +42,4 @@ This works on your machine and in CI. There is a prebuild docker image available
 > 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)
+[![repo-footer](https://gitzone.gitlab.io/assets/repo-footer.svg)](https:/git.zone)

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. 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "npmts",
-  "version": "7.0.8",
+  "version": "7.1.9",
   "description": "Write npm modules with TypeScript without hassle. TypeScript ready. Fully ES6.",
   "main": "dist/index.js",
   "bin": {
@@ -34,37 +34,35 @@
   },
   "homepage": "https://gitlab.com/gitzone/npmts#readme",
   "dependencies": {
-    "@types/gulp": "^4.0.2",
-    "@types/gulp-sourcemaps": "0.0.30",
+    "@types/gulp-sourcemaps": "0.0.31",
     "@types/minimatch": "^2.0.29",
-    "@types/through2": "^2.0.32",
-    "beautylog": "6.1.5",
+    "@types/through2": "^2.0.33",
+    "beautylog": "^6.1.10",
     "depcheck": "^0.6.7",
-    "early": "^2.0.38",
-    "gulp": "3.9.1",
-    "gulp-function": "^2.2.3",
-    "gulp-sourcemaps": "^2.5.0",
-    "gulp-typescript": "^3.1.6",
+    "early": "^2.1.1",
+    "gulp-function": "^2.2.9",
+    "gulp-sourcemaps": "^2.6.0",
+    "gulp-typescript": "^3.1.7",
     "lodash": "^4.17.4",
     "npmextra": "^2.0.5",
     "projectinfo": "^3.0.2",
-    "smartanalytics": "^1.0.3",
-    "smartchok": "^1.0.5",
-    "smartcli": "^2.0.1",
+    "smartanalytics": "^1.0.6",
+    "smartchok": "^1.0.10",
+    "smartcli": "^2.0.7",
     "smartcov": "^1.0.2",
-    "smartenv": "2.0.0",
-    "smartfile": "^4.1.9",
+    "smarterror": "^1.0.3",
+    "smartfile": "^4.2.17",
+    "smartgulp": "^1.0.6",
     "smartpath": "^3.2.8",
     "smartq": "^1.1.1",
-    "smartstream": "^1.0.8",
+    "smartstream": "^1.0.10",
     "smartstring": "^2.0.24",
-    "smartsystem": "^1.0.12",
-    "source-map-support": "^0.4.14",
-    "tapbuffer": "^1.0.10",
+    "smartsystem": "^1.0.18",
+    "tapbuffer": "^1.0.15",
     "through2": "^2.0.3",
     "tsn": "^2.0.15",
-    "typescript": "^2.2.2",
-    "typings-global": "^1.0.14"
+    "typescript": "^2.4.1",
+    "typings-global": "^1.0.19"
   },
   "devDependencies": {}
 }

readme.md

@@ -11,18 +11,21 @@ Write npm modules with TypeScript without hassle. TypeScript ready. Fully ES6.
 [![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/gitzone/npmts.svg)](https://david-dm.org/gitzone/npmts)
-[![bitHound Dependencies](https://www.bithound.io/github/gitzone/npmts/badges/dependencies.svg)](https://www.bithound.io/github/gitzone/npmts/master/dependencies/npm)
-[![bitHound Code](https://www.bithound.io/github/gitzone/npmts/badges/code.svg)](https://www.bithound.io/github/gitzone/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)
@@ -33,7 +36,9 @@ For more information on how tests are run check out the [tapbuffer module](https
 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 | **©** [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://git.zone)
+[![repo-footer](https://gitzone.gitlab.io/assets/repo-footer.svg)](https://push.rocks)

ts/mod00/mod00.check.ts

@@ -1,126 +1,132 @@
 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()
-    plugins.beautylog.ora.text('Check Module: Check Project Typings...')
-    projectInfo = new ProjectinfoNpm(paths.cwd)
-    if (typeof projectInfo.packageJson.typings === 'undefined') {
-        plugins.beautylog.error(`please add typings field to package.json`)
-        process.exit(1)
-    };
-    done.resolve(configArg)
-    return done.promise
+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') {
+    plugins.beautylog.error(`please add typings field to package.json`)
+    process.exit(1)
+  };
+  done.resolve(configArg)
+  return done.promise
 }
 
 const depcheckOptions = {
-    ignoreBinPackage: false, // ignore the packages with bin entry
-    parsers: { // the target parsers
-        '*.ts': plugins.depcheck.parser.typescript
-    },
-    detectors: [ // the target detectors
-        plugins.depcheck.detector.requireCallExpression,
-        plugins.depcheck.detector.importDeclaration
+  ignoreBinPackage: false, // ignore the packages with bin entry
+  parsers: { // the target parsers
+    '*.ts': plugins.depcheck.parser.typescript
+  },
+  detectors: [ // the target detectors
+    plugins.depcheck.detector.requireCallExpression,
+    plugins.depcheck.detector.importDeclaration
+  ],
+  specials: [ // the target special parsers
+    plugins.depcheck.special.eslint,
+    plugins.depcheck.special.webpack
+  ]
+}
+
+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
+      'test',
+      'dist',
+      'bower_components'
     ],
-    specials: [ // the target special parsers
-        plugins.depcheck.special.eslint,
-        plugins.depcheck.special.webpack
+    ignoreMatches: [ // ignore dependencies that matches these globs
+      '@types/*',
+      'babel-preset-*'
     ]
-}
-
-let checkDependencies = (configArg) => {
-    let done = q.defer()
-    plugins.beautylog.ora.text('Check Module: Check Dependencies...')
-    let depcheckOptionsMerged = plugins.lodash.merge(depcheckOptions, {
-        ignoreDirs: [ // folder with these names will be ignored
-            'test',
-            'dist',
-            'bower_components'
-        ],
-        ignoreMatches: [ // ignore dependencies that matches these globs
-            '@types/*',
-            'babel-preset-*'
-        ]
-    })
-    plugins.depcheck(paths.cwd, depcheckOptionsMerged, (unused) => {
-        for (let item of unused.dependencies) {
-            plugins.beautylog.warn(`Watch out: unused dependency "${item}"`)
-        }
-        for (let item in unused.missing) {
-            plugins.beautylog.error(`missing dependency "${item}" in package.json`)
-        }
-        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}`)
-        };
-        for (let item in unused.invalidDirs) {
-            plugins.beautylog.warn(`Watch out: could not parse directory ${item}`)
-        }
-        done.resolve(configArg)
-    })
-    return done.promise
-}
-
-let checkDevDependencies = (configArg) => {
-    let done = q.defer()
-    plugins.beautylog.ora.text('Check Module: Check devDependencies...')
-    let depcheckOptionsMerged = plugins.lodash.merge(depcheckOptions, {
-        ignoreDirs: [ // folder with these names will be ignored
-            'ts',
-            'dist',
-            'bower_components'
-        ],
-        ignoreMatches: [ // ignore dependencies that matches these globs
-            '@types/*',
-            'babel-preset-*'
-        ]
-    })
-    plugins.depcheck(paths.cwd, depcheckOptionsMerged, (unused) => {
-        for (let item of unused.devDependencies) {
-            plugins.beautylog.log(`unused devDependency ${item}`)
-        }
-        for (let item in unused.missing) {
-            plugins.beautylog.error(`unused 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}`)
-        }
-        for (let item in unused.invalidDirs) {
-            plugins.beautylog.warn(`Watch out: could not parse directory ${item}`)
-        }
-        done.resolve(configArg)
-    })
-    return done.promise
-}
-
-let checkNodeVersion = (configArg) => {
-    let done = q.defer()
-    plugins.beautylog.ora.text('checking node version')
+  })
+  plugins.depcheck(paths.cwd, depcheckOptionsMerged, (unused) => {
+    for (let item of unused.dependencies) {
+      plugins.beautylog.warn(`Watch out: unused dependency "${item}"`)
+    }
+    for (let item in unused.missing) {
+      plugins.beautylog.error(`missing dependency "${item}" in package.json`)
+    }
+    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}`)
+    };
+    for (let item in unused.invalidDirs) {
+      plugins.beautylog.warn(`Watch out: could not parse directory ${item}`)
+    }
     done.resolve(configArg)
-    return done.promise
+  })
+  return done.promise
 }
 
-export let run = (configArg) => {
-    let done = q.defer()
-    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
+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
+      'ts',
+      'dist',
+      'bower_components'
+    ],
+    ignoreMatches: [ // ignore dependencies that matches these globs
+      '@types/*',
+      'babel-preset-*'
+    ]
+  })
+  plugins.depcheck(paths.cwd, depcheckOptionsMerged, (unused) => {
+    for (let item of unused.devDependencies) {
+      plugins.beautylog.log(`unused devDependency ${item}`)
+    }
+    for (let item in unused.missing) {
+      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}`)
+    }
+    for (let item in unused.invalidDirs) {
+      plugins.beautylog.warn(`Watch out: could not parse directory ${item}`)
+    }
+    done.resolve(configArg)
+  })
+  return done.promise
+}
+
+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 = async (configArg: INpmtsConfig) => {
+  plugins.beautylog.ora.text('Check Module: ...')
+
+  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

@@ -7,39 +7,26 @@ import plugins = require('./mod00.plugins')
  * removes the  dist directory which will be entirely rebuild
  */
 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()
-    })
+  plugins.beautylog.ora.text('cleaning dist folder')
+  return plugins.smartfile.fs.remove(paths.distDir)
 }
 
 /**
  * remove old pages
  */
 let removePages = function () {
-    plugins.beautylog.ora.text('cleaning pages folder')
-    return plugins.smartfile.fs.remove(paths.pagesDir)
+  plugins.beautylog.ora.text('cleaning pages folder')
+  return plugins.smartfile.fs.remove(paths.pagesDir)
 }
 
 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!')
-            done.resolve(configArg)
-        })
-    return done.promise
+  plugins.beautylog.ora.text('cleaning up from previous builds...')
+  let done = q.defer()
+  removeDist()
+    .then(removePages)
+    .then(function () {
+      plugins.beautylog.ok('Cleaned up from previous builds!')
+      done.resolve(configArg)
+    })
+  return done.promise
 }

ts/mod02/index.ts

@@ -20,11 +20,13 @@ let tap = function (configArg: INpmtsConfig) {
    */
   let npmtsTapBuffer = new plugins.tapbuffer.TabBuffer()
 
+  npmtsTapBuffer.setConfig(configArg.testConfig)
+
   /**
    * handle the testable files
    */
   let testableFilesSmartstream = new plugins.smartstream.Smartstream([
-    plugins.gulp.src([ plugins.path.join(paths.cwd, './ts/**/*.ts') ]),
+    plugins.smartgulp.src([ plugins.path.join(paths.cwd, './ts/**/*.ts') ]),
     plugins.gulpSourcemaps.init(),
     plugins.gulpTypeScript({
       target: 'ES5',
@@ -32,10 +34,10 @@ let tap = function (configArg: INpmtsConfig) {
       experimentalDecorators: true,
       lib: [ 'DOM', 'ES5', 'ES2015.Promise', 'ES2015.Generator', 'ES2015.Iterable' ]
     }),
-    plugins.gulpSourcemaps.write(),
     plugins.gulpFunction.forEach(async file => {
       file.path = file.path.replace(paths.tsDir, paths.distDir)
     }),
+    plugins.gulpSourcemaps.write(),
     npmtsTapBuffer.pipeTestableFiles(),
     plugins.smartstream.cleanPipe()
   ])
@@ -44,13 +46,15 @@ let tap = function (configArg: INpmtsConfig) {
    * handle the test files
    */
   let testFilesSmartstream = new plugins.smartstream.Smartstream([
-    plugins.gulp.src([ plugins.path.join(paths.cwd, 'test/*.ts') ]),
+    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.gulpSourcemaps.write(),
     npmtsTapBuffer.pipeTestFiles(),
     plugins.smartstream.cleanPipe()
   ])
@@ -77,10 +81,16 @@ let tap = function (configArg: INpmtsConfig) {
 }
 
 let handleCoverageData = async (configArg: INpmtsConfig) => {
-  let coverageResult = await plugins.smartcov.get.percentageFromLcovString(
-    configArg.runData.coverageLcovInfo,
-    2
-  )
+  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(
       `${(coverageResult).toString()}% `
@@ -106,12 +116,19 @@ export let run = function (configArg: INpmtsConfig) {
     plugins.beautylog.ora.text('now starting tests')
     plugins.beautylog.ora.end()
     plugins.beautylog.log('ready for tapbuffer:')
+    if (configArg.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) })
+    }
 
-    tap(config)
-      .then(handleCoverageData)
-      .then(() => {
-        done.resolve(config)
-      }).catch(err => { console.log(err) })
   } else {
     plugins.beautylog.ora.end()
     done.resolve(config)

ts/mod02/mod02.plugins.ts

@@ -1,17 +1,17 @@
 export * from '../npmts.plugins'
 
-import * as gulp from 'gulp'
 import * as gulpFunction from 'gulp-function'
 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,
     gulpSourcemaps,
     gulpTypeScript,
     smartcov,
+    smartgulp,
     tapbuffer
 }

ts/npmts.config.ts

@@ -3,31 +3,45 @@ import paths = require('./npmts.paths')
 
 import * as q from 'smartq'
 
-export type npmtsMode = 'default' | 'custom'
+/**
+ * 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
+  coverage: boolean
+  coverageTreshold: number
+  checkDependencies: boolean
+  mode: npmtsMode
+  test: boolean
+  testTs: any
+  testConfig: any
+  ts: any
+  tsOptions: any
   watch: boolean
   runData: {
-    coverageLcovInfo?: string,
+    coverageLcovInfo?: string
     coverageResult?: number
   }
-};
+}
 
 export let run = function (argvArg) {
   let done = q.defer()
   let defaultConfig: INpmtsConfig = {
     argv: undefined,
+    coverage: true,
     coverageTreshold: 70,
+    checkDependencies: true,
     mode: 'default',
     test: true,
     testTs: {},
+    testConfig: {
+      parallel: true
+    },
     ts: {},
     tsOptions: {},
     watch: false,
@@ -50,31 +64,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.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

@@ -8,14 +8,13 @@ import * as projectinfo from 'projectinfo'
 import * as path from 'path'
 import * as smartanalytics from 'smartanalytics'
 import * as smartcli from 'smartcli'
-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 through2 from 'through2'
-export let sourceMapSupport = require('source-map-support').install() // display errors correctly during testing
 
 export {
     beautylog,
@@ -26,7 +25,7 @@ export {
     path,
     smartanalytics,
     smartcli,
-    smartenv,
+    smarterror,
     smartfile,
     smartpath,
     smartstream,