4.2.5

update to latest standards

See merge request !2

.gitlab-ci.yml

@@ -1,5 +1,10 @@
 # gitzone standard
-image: hosttoday/ht-docker-node:npmts
+image: hosttoday/ht-docker-node:npmci
+
+cache:
+  paths:
+  - .yarn/
+  key: "$CI_BUILD_STAGE"
 
 stages:
 - test
@@ -51,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:

dist/smartfile.classes.smartfile.d.ts

@@ -1,16 +1,69 @@
 /// <reference types="node" />
 export interface ISmartfileConstructorOptions {
     path?: string;
-    contentsString?: string;
+    contentString?: string;
     contentBuffer?: Buffer;
+    base?: string;
 }
+/**
+ * class Smartfile
+ * -> is vinyl file compatible
+ */
 export declare class Smartfile {
+    /**
+     * the full path of the file on disk
+     */
     path: string;
-    contents: Buffer;
+    /**
+     * the content of the file as Buffer
+     */
+    contentBuffer: Buffer;
+    /**
+     * The current working directory of the file
+     */
+    base: string;
+    /**
+     * sync the file with disk
+     */
+    sync: boolean;
+    /**
+     * the constructor of Smartfile
+     * @param optionsArg
+     */
     constructor(optionsArg: ISmartfileConstructorOptions);
     /**
      * set contents from string
      * @param contentString
      */
-    setContentFromString(contentString: string): void;
+    setContentsFromString(contentString: string): void;
+    /**
+     * write file to disk
+     */
+    write(): Promise<void>;
+    /**
+     * read file from disk
+     */
+    read(): Promise<void>;
+    /**
+     * vinyl-compatibility: alias of this.contentBuffer
+     */
+    contents: Buffer;
+    /**
+     * vinyl-compatibility
+     */
+    readonly cwd: string;
+    /**
+     * return relative path of file
+     */
+    readonly relative: string;
+    /**
+     * return truw when the file has content
+     */
+    isNull(): boolean;
+    /**
+     * return true if contents are Buffer
+     */
+    isBuffer(): boolean;
+    isDirectory(): boolean;
+    isStream(): boolean;
 }

dist/smartfile.classes.smartfile.js

@@ -1,22 +1,104 @@
 "use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : new P(function (resolve) { resolve(result.value); }).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
 Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * class Smartfile
+ * -> is vinyl file compatible
+ */
 class Smartfile {
+    /**
+     * the constructor of Smartfile
+     * @param optionsArg
+     */
     constructor(optionsArg) {
         if (optionsArg.contentBuffer) {
-            this.contents = optionsArg.contentBuffer;
+            this.contentBuffer = optionsArg.contentBuffer;
         }
-        else if (optionsArg.contentsString) {
+        else if (optionsArg.contentString) {
-            this.contents = new Buffer(optionsArg.contentsString);
+            this.setContentsFromString(optionsArg.contentString);
+        }
+        else {
+            console.log('created empty Smartfile?');
         }
         this.path = optionsArg.path;
+        this.base = optionsArg.base;
     }
     /**
      * set contents from string
      * @param contentString
      */
-    setContentFromString(contentString) {
+    setContentsFromString(contentString) {
         this.contents = new Buffer(contentString);
     }
+    /**
+     * write file to disk
+     */
+    write() {
+        return __awaiter(this, void 0, void 0, function* () {
+        });
+    }
+    /**
+     * read file from disk
+     */
+    read() {
+        return __awaiter(this, void 0, void 0, function* () {
+        });
+    }
+    // -----------------------------------------------
+    // vinyl compatibility
+    // -----------------------------------------------
+    /**
+     * vinyl-compatibility: alias of this.contentBuffer
+     */
+    get contents() {
+        return this.contentBuffer;
+    }
+    set contents(contentsArg) {
+        this.contentBuffer = contentsArg;
+    }
+    /**
+     * vinyl-compatibility
+     */
+    get cwd() {
+        return this.base;
+    }
+    /**
+     * return relative path of file
+     */
+    get relative() {
+        return this.path;
+    }
+    /**
+     * return truw when the file has content
+     */
+    isNull() {
+        if (!this.contentBuffer) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * return true if contents are Buffer
+     */
+    isBuffer() {
+        if (this.contents instanceof Buffer) {
+            return true;
+        }
+        return false;
+    }
+    isDirectory() {
+        return false;
+    }
+    isStream() {
+        return false;
+    }
 }
 exports.Smartfile = Smartfile;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic21hcnRmaWxlLmNsYXNzZXMuc21hcnRmaWxlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvc21hcnRmaWxlLmNsYXNzZXMuc21hcnRmaWxlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBUUE7SUFHRSxZQUFZLFVBQXdDO1FBQ2xELEVBQUUsQ0FBQyxDQUFDLFVBQVUsQ0FBQyxhQUFhLENBQUMsQ0FBQyxDQUFDO1lBQzdCLElBQUksQ0FBQyxRQUFRLEdBQUcsVUFBVSxDQUFDLGFBQWEsQ0FBQTtRQUMxQyxDQUFDO1FBQUMsSUFBSSxDQUFDLEVBQUUsQ0FBQSxDQUFDLFVBQVUsQ0FBQyxjQUFjLENBQUMsQ0FBQyxDQUFDO1lBQ3BDLElBQUksQ0FBQyxRQUFRLEdBQUcsSUFBSSxNQUFNLENBQUMsVUFBVSxDQUFDLGNBQWMsQ0FBQyxDQUFBO1FBQ3ZELENBQUM7UUFDRCxJQUFJLENBQUMsSUFBSSxHQUFHLFVBQVUsQ0FBQyxJQUFJLENBQUE7SUFDN0IsQ0FBQztJQUVEOzs7T0FHRztJQUNILG9CQUFvQixDQUFDLGFBQXFCO1FBQ3hDLElBQUksQ0FBQyxRQUFRLEdBQUcsSUFBSSxNQUFNLENBQUMsYUFBYSxDQUFDLENBQUE7SUFDM0MsQ0FBQztDQUNGO0FBbkJELDhCQW1CQyJ9
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic21hcnRmaWxlLmNsYXNzZXMuc21hcnRmaWxlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvc21hcnRmaWxlLmNsYXNzZXMuc21hcnRmaWxlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7QUFTQTs7O0dBR0c7QUFDSDtJQXFCRTs7O09BR0c7SUFDSCxZQUFhLFVBQXdDO1FBQ25ELEVBQUUsQ0FBQyxDQUFDLFVBQVUsQ0FBQyxhQUFhLENBQUMsQ0FBQyxDQUFDO1lBQzdCLElBQUksQ0FBQyxhQUFhLEdBQUcsVUFBVSxDQUFDLGFBQWEsQ0FBQTtRQUMvQyxDQUFDO1FBQUMsSUFBSSxDQUFDLEVBQUUsQ0FBQyxDQUFDLFVBQVUsQ0FBQyxhQUFhLENBQUMsQ0FBQyxDQUFDO1lBQ3BDLElBQUksQ0FBQyxxQkFBcUIsQ0FBQyxVQUFVLENBQUMsYUFBYSxDQUFDLENBQUE7UUFDdEQsQ0FBQztRQUFDLElBQUksQ0FBQyxDQUFDO1lBQ04sT0FBTyxDQUFDLEdBQUcsQ0FBQywwQkFBMEIsQ0FBQyxDQUFBO1FBQ3pDLENBQUM7UUFDRCxJQUFJLENBQUMsSUFBSSxHQUFHLFVBQVUsQ0FBQyxJQUFJLENBQUE7UUFDM0IsSUFBSSxDQUFDLElBQUksR0FBRyxVQUFVLENBQUMsSUFBSSxDQUFBO0lBQzdCLENBQUM7SUFHRDs7O09BR0c7SUFDSCxxQkFBcUIsQ0FBQyxhQUFxQjtRQUN6QyxJQUFJLENBQUMsUUFBUSxHQUFHLElBQUksTUFBTSxDQUFDLGFBQWEsQ0FBQyxDQUFBO0lBQzNDLENBQUM7SUFFRDs7T0FFRztJQUNHLEtBQUs7O1FBRVgsQ0FBQztLQUFBO0lBRUQ7O09BRUc7SUFDRyxJQUFJOztRQUNWLENBQUM7S0FBQTtJQUVELGtEQUFrRDtJQUNsRCxzQkFBc0I7SUFDdEIsa0RBQWtEO0lBQ2xEOztPQUVHO0lBQ0gsSUFBSSxRQUFRO1FBQ1YsTUFBTSxDQUFDLElBQUksQ0FBQyxhQUFhLENBQUE7SUFDM0IsQ0FBQztJQUNELElBQUksUUFBUSxDQUFFLFdBQVc7UUFDdkIsSUFBSSxDQUFDLGFBQWEsR0FBRyxXQUFXLENBQUE7SUFDbEMsQ0FBQztJQUVEOztPQUVHO0lBQ0gsSUFBSSxHQUFHO1FBQ0wsTUFBTSxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUE7SUFDbEIsQ0FBQztJQUVEOztPQUVHO0lBQ0gsSUFBSSxRQUFRO1FBQ1YsTUFBTSxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUE7SUFDbEIsQ0FBQztJQUVEOztPQUVHO0lBQ0gsTUFBTTtRQUNKLEVBQUUsQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDLGFBQWEsQ0FBQyxDQUFDLENBQUM7WUFDeEIsTUFBTSxDQUFDLElBQUksQ0FBQTtRQUNiLENBQUM7UUFDRCxNQUFNLENBQUMsS0FBSyxDQUFBO0lBQ2QsQ0FBQztJQUVEOztPQUVHO0lBQ0gsUUFBUTtRQUNOLEVBQUUsQ0FBQyxDQUFDLElBQUksQ0FBQyxRQUFRLFlBQVksTUFBTSxDQUFDLENBQUMsQ0FBQztZQUNwQyxNQUFNLENBQUMsSUFBSSxDQUFBO1FBQ2IsQ0FBQztRQUNELE1BQU0sQ0FBQyxLQUFLLENBQUE7SUFDZCxDQUFDO0lBRUQsV0FBVztRQUNULE1BQU0sQ0FBQyxLQUFLLENBQUE7SUFDZCxDQUFDO0lBRUQsUUFBUTtRQUNOLE1BQU0sQ0FBQyxLQUFLLENBQUE7SUFDZCxDQUFDO0NBQ0Y7QUFqSEQsOEJBaUhDIn0=

dist/smartfile.fs.d.ts

@@ -90,7 +90,7 @@ export declare let toObjectSync: (filePathArg: any, fileTypeArg?: any) => any;
  * @param filePath
  * @returns {string|Buffer|any}
  */
-export declare let toStringSync: (filePath: any) => any;
+export declare let toStringSync: (filePath: string) => string;
 export declare let fileTreeToObject: (dirPathArg: string, miniMatchFilter: string) => Promise<Smartfile[]>;
 /**
  *

dist/smartfile.memory.d.ts

@@ -5,14 +5,6 @@ export interface IVinylFile {
     base: string;
     path: string;
 }
-/**
- * allows you to create a gulp stream
- * from String, from an Array of Strings, from Vinyl File, from an Array of VinylFiles
- * @param fileArg
- * @returns stream.Readable
- * @TODO: make it async;
- */
-export declare let toGulpStream: (fileArg: string | string[] | IVinylFile | IVinylFile[], baseArg?: string) => any;
 /**
  * converts file to Object
  * @param fileStringArg

docs/index.md

@@ -0,0 +1,38 @@
+# smartfile
+make files easily accessible for processing in javascript.
+
+## Availabililty
+[![npm](https://pushrocks.gitlab.io/assets/repo-button-npm.svg)](https://www.npmjs.com/package/smartfile)
+[![git](https://pushrocks.gitlab.io/assets/repo-button-git.svg)](https://gitlab.com/pushrocks/smartfile)
+[![git](https://pushrocks.gitlab.io/assets/repo-button-mirror.svg)](https://github.com/pushrocks/smartfile)
+[![docs](https://pushrocks.gitlab.io/assets/repo-button-docs.svg)](https://pushrocks.gitlab.io/smartfile/)
+
+## Status for master
+[![build status](https://gitlab.com/pushrocks/smartfile/badges/master/build.svg)](https://gitlab.com/pushrocks/smartfile/commits/master)
+[![coverage report](https://gitlab.com/pushrocks/smartfile/badges/master/coverage.svg)](https://gitlab.com/pushrocks/smartfile/commits/master)
+[![Dependency Status](https://david-dm.org/pushrocks/smartfile.svg)](https://david-dm.org/pushrocks/smartfile)
+[![bitHound Dependencies](https://www.bithound.io/github/pushrocks/smartfile/badges/dependencies.svg)](https://www.bithound.io/github/pushrocks/smartfile/master/dependencies/npm)
+[![bitHound Code](https://www.bithound.io/github/pushrocks/smartfile/badges/code.svg)](https://www.bithound.io/github/pushrocks/smartfile)
+[![TypeScript](https://img.shields.io/badge/TypeScript-2.x-blue.svg)](https://nodejs.org/dist/latest-v6.x/docs/api/)
+[![node](https://img.shields.io/badge/node->=%206.x.x-blue.svg)](https://nodejs.org/dist/latest-v6.x/docs/api/)
+[![JavaScript Style Guide](https://img.shields.io/badge/code%20style-standard-brightgreen.svg)](http://standardjs.com/)
+
+## Usage
+smartfile is an approach of being one tool to handle files in diverse environments.
+
+### Smartfile Sections
+smartfile thinks in sections:
+
+section | description
+--- | ---
+fs | (object) gets data from fs to somewhere
+memory | gets data from memory to somewhere
+remote | gets data from remote locations to somewhere
+interpreter | (object) handles yaml and json
+smartfile | (class) a virtual representation of a file, alternative to vinyl file format
+
+For further information read the linked docs at the top of this README.
+
+> MIT licensed | **©** [Lossless GmbH](https://lossless.gmbh)
+
+[![npm](https://pushrocks.gitlab.io/assets/repo-footer.svg)](https://push.rocks)

npmextra.json

@@ -5,5 +5,10 @@
   },
   "npmdocker":{
     
+  },
+  "npmci": {
+    "globalNpmTools": [
+      "npmts"
+    ]
   }
 }

package.json

@@ -1,6 +1,6 @@
 {
   "name": "smartfile",
-  "version": "4.1.7",
+  "version": "4.2.5",
   "description": "offers smart ways to work with files in nodejs",
   "main": "dist/index.js",
   "typings": "dist/index.d.ts",
@@ -26,23 +26,21 @@
   },
   "homepage": "https://gitlab.com/pushrocks/smartfile",
   "dependencies": {
-    "@types/fs-extra": "0.x.x",
+    "@types/fs-extra": "2.x.x",
     "@types/vinyl": "^2.0.0",
-    "fs-extra": "^2.0.0",
+    "fs-extra": "^3.0.0",
     "glob": "^7.1.1",
-    "js-yaml": "^3.7.0",
+    "js-yaml": "^3.8.3",
     "require-reload": "0.2.2",
-    "smartpath": "^3.2.7",
+    "smartpath": "^3.2.8",
-    "smartq": "^1.0.4",
+    "smartq": "^1.1.1",
     "smartrequest": "^1.0.4",
-    "typings-global": "^1.0.14",
+    "typings-global": "^1.0.16",
-    "vinyl": "^2.0.1",
+    "vinyl": "^2.0.2",
     "vinyl-file": "^3.0.0"
   },
   "devDependencies": {
-    "gulp-function": "^2.2.3",
+    "gulp-function": "^2.2.9",
-    "npmts-g": "^6.0.0",
+    "tapbundle": "^1.0.10"
-    "smartchai": "^1.0.1",
-    "typings-test": "^1.0.3"
   }
 }

test/test.d.ts

@@ -1 +0,0 @@
-import 'typings-test';

test/test.ts

@@ -1,238 +1,205 @@
-import 'typings-test'
 import * as smartfile from '../dist/index'
 import path = require('path')
 
-import { expect } from 'smartchai'
+import { expect, tap } from 'tapbundle'
 
 import * as vinyl from 'vinyl'
 
-describe('smartfile', function () {
+// ---------------------------
-  describe('.fs', function () {
+// smartfile.fs
-    describe('.fileExistsSync', function () {
+// ---------------------------
-      it('should return an accurate boolean', function () {
+
-        expect(smartfile.fs.fileExistsSync('./test/mytest.json')).to.be.true
+tap.test('.fs.fileExistsSync -> should return an accurate boolean', async () => {
-        expect(smartfile.fs.fileExistsSync('./test/notthere.json')).be.false
+  expect(smartfile.fs.fileExistsSync('./test/mytest.json')).to.be.true
-      })
+  expect(smartfile.fs.fileExistsSync('./test/notthere.json')).be.false
-    })
+})
-    describe('.fileExists', function () {
+
-      it('should return a working promise', function () {
+tap.test('.fs.fileExists should resolve or reject a promise', async () => {
-        expect(smartfile.fs.fileExists('./test/mytest.json')).to.be.a('promise')
+  expect(smartfile.fs.fileExists('./test/mytest.json')).to.be.instanceof(Promise)
-        expect(smartfile.fs.fileExists('./test/mytest.json')).to.be.fulfilled
+  await expect(smartfile.fs.fileExists('./test/mytest.json')).to.eventually.be.fulfilled
-        expect(smartfile.fs.fileExists('./test/notthere.json')).to.not.be.fulfilled
+  await expect(smartfile.fs.fileExists('./test/notthere.json')).to.eventually.be.rejected
-      })
+})
-    })
+
-    describe('.listFoldersSync()', function () {
+tap.test('.fs.listFoldersSync() -> should get the file type from a string', async () => {
-      it('should get the file type from a string', function () {
+  expect(smartfile.fs.listFoldersSync('./test/')).to.deep.include('testfolder')
-        expect(smartfile.fs.listFoldersSync('./test/')).to.deep.include('testfolder')
+  expect(smartfile.fs.listFoldersSync('./test/')).to.not.deep.include('notExistentFolder')
-        expect(smartfile.fs.listFoldersSync('./test/')).to.not.deep.include('notExistentFolder')
+})
-      })
+
-    })
+tap.test('.fs.listFolders() -> should get the file type from a string', async () => {
-    describe('.listFolders()', function () {
+  let folderArrayArg = await smartfile.fs.listFolders('./test/')
-      it('should get the file type from a string', function (done) {
+  expect(folderArrayArg).to.deep.include('testfolder')
-        smartfile.fs.listFolders('./test/')
+  expect(folderArrayArg).to.not.deep.include('notExistentFolder')
-          .then(function (folderArrayArg) {
+})
-            expect(folderArrayArg).to.deep.include('testfolder')
-            expect(folderArrayArg).to.not.deep.include('notExistentFolder')
-            done()
-          })
-      })
-    })
-    describe('.listFilesSync()', function () {
-      it('should get the file type from a string', function () {
-        expect(smartfile.fs.listFilesSync('./test/')).to.deep.include('mytest.json')
-        expect(smartfile.fs.listFilesSync('./test/')).to.not.deep.include('notExistentFile')
-        expect(smartfile.fs.listFilesSync('./test/', /mytest\.json/)).to.deep.include('mytest.json')
-        expect(smartfile.fs.listFilesSync('./test/', /mytests.json/)).to.not.deep.include('mytest.json')
-      })
-    })
-    describe('.listFiles()', function () {
-      it('should get the file type from a string', function (done) {
-        smartfile.fs.listFiles('./test/')
-          .then(function (folderArrayArg) {
-            expect(folderArrayArg).to.deep.include('mytest.json')
-            expect(folderArrayArg).to.not.deep.include('notExistentFile')
-            done()
-          })
-      })
-    })
-    describe('.listFileTree()', function () {
-      it('should get a file tree', function (done) {
-        smartfile.fs.listFileTree(path.resolve('./test/'), '**/*.txt')
-          .then(function (folderArrayArg) {
-            expect(folderArrayArg).to.deep.include('testfolder/testfile1.txt')
-            expect(folderArrayArg).to.not.deep.include('mytest.json')
-            done()
-          })
-      })
-    })
 
 
-    describe('toObjectFromFileTree', function () {
+tap.test('.fs.listFilesSync() -> should get the file type from a string', async () => {
-      it('should read a file tree into an Object', function () {
+  expect(smartfile.fs.listFilesSync('./test/')).to.deep.include('mytest.json')
-        smartfile.fs.fileTreeToObject(path.resolve('./test/'), '**/*.txt')
+  expect(smartfile.fs.listFilesSync('./test/')).to.not.deep.include('notExistentFile')
-          .then((fileArrayArg) => {
+  expect(smartfile.fs.listFilesSync('./test/', /mytest\.json/)).to.deep.include('mytest.json')
-            // expect(fileArrayArg[1]).to.be.instanceof(smartfile.Smartfile)
+  expect(smartfile.fs.listFilesSync('./test/', /mytests.json/)).to.not.deep.include('mytest.json')
-          })
+})
-      })
-    })
-    
-    describe('.copy()', function () {
-      it('should copy a directory', function () {
-        smartfile.fs.copy('./test/testfolder/', './test/temp/')
-      })
-      it('should copy a file', function () {
-        smartfile.fs.copy('./test/mytest.yaml', './test/temp/')
-      })
-      it('should copy a file and rename it', function () {
-        smartfile.fs.copy('./test/mytest.yaml', './test/temp/mytestRenamed.yaml')
-      })
-    })
-    describe('.remove()', function () {
-      it('should remove an entire directory', function () {
 
-      })
+tap.test('.fs.listFiles() -> should get the file type from a string', async () => {
-      it('smartfile.fs.remove -> should remove single files', function (done) {
+  let folderArrayArg = await smartfile.fs.listFiles('./test/')
-        smartfile.fs.remove('./test/temp/mytestRenamed.yaml')
+  expect(folderArrayArg).to.deep.include('mytest.json')
-          .then(() => { done() })
+  expect(folderArrayArg).to.not.deep.include('notExistentFile')
-      })
+})
-      it('smartfile.fs.removeSync -> should remove single files synchronouly', function () {
-        smartfile.fs.removeSync('./test/temp/testfile1.txt')
-        expect(smartfile.fs.fileExistsSync('./test/temp/testfile1.txt')).to.be.false
-      })
-      it('smartfile.fs.removeMany -> should remove and array of files', function (done) {
-        smartfile.fs.removeMany([ './test/temp/testfile1.txt', './test/temp/testfile2.txt' ]).then(() => {
-          expect(smartfile.fs.fileExistsSync('./test/temp/testfile1.txt')).to.be.false
-          expect(smartfile.fs.fileExistsSync('./test/temp/testfile2.txt')).to.be.false
-          done()
-        })
-      })
-      it('smartfile.fs.removeManySync -> should remove and array of single files synchronouly', function () {
-        smartfile.fs.removeManySync([ './test/temp/testfile1.txt', './test/temp/testfile2.txt' ])
-        expect(smartfile.fs.fileExistsSync('./test/temp/testfile1.txt')).to.be.false
-        expect(smartfile.fs.fileExistsSync('./test/temp/testfile2.txt')).to.be.false
-      })
-    })
-  })
 
-  describe('.interpreter', function () {
+tap.test('.fs.listFileTree() -> should get a file tree', async () => {
-    describe('.filetype()', function () {
+  let folderArrayArg = await smartfile.fs.listFileTree(path.resolve('./test/'), '**/*.txt')
-      it('should get the file type from a string', function () {
+  expect(folderArrayArg).to.deep.include('testfolder/testfile1.txt')
-        expect(smartfile.interpreter.filetype('./somefolder/data.json')).equal('json')
+  expect(folderArrayArg).to.not.deep.include('mytest.json')
-      })
+})
-    })
-  })
 
-  describe('.fs', function () {
+tap.test('.fs.fileTreeToObject -> should read a file tree into an Object', async () => {
-    describe('.toObjectSync()', function () {
+  let fileArrayArg = await smartfile.fs.fileTreeToObject(path.resolve('./test/'), '**/*.txt')
-      it('should read an ' + '.yaml' + ' file to an object', function () {
+  expect(fileArrayArg[0].contents.toString()).to.not.be.null
-        let testData = smartfile.fs.toObjectSync('./test/mytest.yaml')
+  // expect(fileArrayArg[1]).to.be.instanceof(smartfile.Smartfile)
-        expect(testData).have.property('key1', 'this works')
+})
-        expect(testData).have.property('key2', 'this works too')
 
-      })
+tap.test('.fs.copy() -> should copy a directory', async () => {
-      it('should state unknown file type for unknown file types', function () {
+  smartfile.fs.copy('./test/testfolder/', './test/temp/')
-        let testData = smartfile.fs.toObjectSync('./test/mytest.txt')
+})
-      })
-      it('should read an ' + '.json' + ' file to an object', function () {
-        let testData = smartfile.fs.toObjectSync('./test/mytest.json')
-        expect(testData).have.property('key1', 'this works')
-        expect(testData).have.property('key2', 'this works too')
 
-      })
+tap.test('.fs.copy() -> should copy a file', async () => {
-    })
+  smartfile.fs.copy('./test/mytest.yaml', './test/temp/')
-    describe('.toStringSync()', function () {
+})
-      it('should read a file to a string', function () {
-        expect(smartfile.fs.toStringSync('./test/mytest.txt'))
-          .to.equal('Some TestString &&%$')
-      })
-    })
-    describe('.toVinylSync', function () {
-      it('should read an ' + '.json OR .yaml' + ' file to an ' + 'vinyl file object', function () {
-        let testData = smartfile.fs.toVinylSync('./test/mytest.json')
-        expect(vinyl.isVinyl(testData)).to.be.true
-      })
-    })
-  })
 
-  describe('.memory', function () {
+tap.test('.fs.copy() -> should copy a file and rename it', async () => {
-    describe('.toGulpStream()', function () {
+  smartfile.fs.copy('./test/mytest.yaml', './test/temp/mytestRenamed.yaml')
-      it('should produce a valid gulp stream', function () {
+})
-        let localArray = [ 'test1', 'test2', 'test3' ]
-        smartfile.memory.toGulpStream(localArray)
-      })
-    })
-    describe('toVinylFileSync()', function () {
-      it('should produce a vinylFile', function () {
-        let localString = 'myString'
-        let localOptions = { filename: 'vinylfile2', base: '/someDir' }
-        expect(smartfile.memory.toVinylFileSync(localString, localOptions) instanceof vinyl).to.be.true
-      })
-    })
-    describe('toVinylArraySync()', function () {
-      it('should produce a an array of vinylfiles', function () {
-        let localStringArray = [ 'string1', 'string2', 'string3' ]
-        let localOptions = { filename: 'vinylfile2', base: '/someDir' }
-        let testResult = smartfile.memory.toVinylArraySync(localStringArray, localOptions)
-        expect(testResult).to.be.a('array')
-        expect(testResult.length === 3).to.be.true
-        for (let myKey in testResult) {
-          expect(testResult[ myKey ] instanceof vinyl).to.be.true
-        }
-      })
-    })
-    describe('vinylToStringSync()', function () {
-      it('should produce a String from vinyl file', function () {
-        let localString = smartfile.memory.vinylToStringSync(new vinyl({
-          base: '/',
-          path: '/test.txt',
-          contents: new Buffer('myString')
-        }))
-        expect(localString).equal('myString')
-      })
-    })
-    describe('toFs()', function () {
-      it('should write a file to disk and return a promise', function (done) {
-        let localString = 'myString'
-        smartfile.memory.toFs(
-          localString,
-          path.join(process.cwd(), './test/temp/testMemToFs.txt')
-        ).then(done)
-      })
-    })
-    describe('toFsSync()', function () {
-      it('should write a file to disk and return true if successfull', function () {
-        let localString = 'myString'
-        smartfile.memory.toFsSync(
-          localString,
-          path.join(process.cwd(), './test/temp/testMemToFsSync.txt')
-        )
-      })
-    })
-  })
 
-  describe('.remote', function () {
+tap.test('.fs.remove() -> should remove an entire directory', async () => {
-    describe('.toString()', function () {
+
-      it('should load a remote file to a variable', function (done) {
+})
-        this.timeout(5000)
+
-        smartfile.remote.toString(
+tap.test('.fs.remove -> should remove single files', async () => {
-          'https://raw.githubusercontent.com/pushrocks/smartfile/master/test/mytest.txt'
+  await expect(smartfile.fs.remove('./test/temp/mytestRenamed.yaml')).to.eventually.be.fulfilled
-        ).then(function (responseString) {
+})
-          expect(responseString).to.equal('Some TestString &&%$')
+
-          done()
+tap.test('.fs.removeSync -> should remove single files synchronouly', async () => {
-        })
+  smartfile.fs.removeSync('./test/temp/testfile1.txt')
-      })
+  expect(smartfile.fs.fileExistsSync('./test/temp/testfile1.txt')).to.be.false
-      it('should reject a Promise when the link is false', function (done) {
+})
-        this.timeout(10000)
+
-        smartfile.remote.toString('https://push.rocks/doesnotexist.txt')
+tap.test('.fs.removeMany -> should remove and array of files', async () => {
-          .then(
+  smartfile.fs.removeMany([ './test/temp/testfile1.txt', './test/temp/testfile2.txt' ]).then(() => {
-          function () {
+    expect(smartfile.fs.fileExistsSync('./test/temp/testfile1.txt')).to.be.false
-            throw new Error('this test should not be resolved')
+    expect(smartfile.fs.fileExistsSync('./test/temp/testfile2.txt')).to.be.false
-          },
-          function () {
-            done()
-          }
-          )
-      })
-    })
   })
 })
+
+tap.test('.fs.removeManySync -> should remove and array of single files synchronouly', async () => {
+  smartfile.fs.removeManySync([ './test/temp/testfile1.txt', './test/temp/testfile2.txt' ])
+  expect(smartfile.fs.fileExistsSync('./test/temp/testfile1.txt')).to.be.false
+  expect(smartfile.fs.fileExistsSync('./test/temp/testfile2.txt')).to.be.false
+})
+
+tap.test('.fs.toObjectSync() -> should read an ' + '.yaml' + ' file to an object', async () => {
+  let testData = smartfile.fs.toObjectSync('./test/mytest.yaml')
+  expect(testData).have.property('key1', 'this works')
+  expect(testData).have.property('key2', 'this works too')
+
+})
+tap.test('.fs.toObjectSync() -> should state unknown file type for unknown file types', async () => {
+  let testData = smartfile.fs.toObjectSync('./test/mytest.txt')
+})
+
+tap.test('.fs.toObjectSync() -> should read an ' + '.json' + ' file to an object', async () => {
+  let testData = smartfile.fs.toObjectSync('./test/mytest.json')
+  expect(testData).have.property('key1', 'this works')
+  expect(testData).have.property('key2', 'this works too')
+})
+
+
+tap.test('.fs.toStringSync() -> should read a file to a string', async () => {
+  expect(smartfile.fs.toStringSync('./test/mytest.txt'))
+    .to.equal('Some TestString &&%$')
+})
+
+tap.test('.fs.toVinylSync -> should read an ' + '.json OR .yaml' + ' file to an ' + 'vinyl file object', async () => {
+  let testData = smartfile.fs.toVinylSync('./test/mytest.json')
+  expect(vinyl.isVinyl(testData)).to.be.true
+})
+
+// ---------------------------
+// smartfile.interpreter
+// ---------------------------
+
+tap.test('.interpreter.filetype() -> should get the file type from a string', async () => {
+  expect(smartfile.interpreter.filetype('./somefolder/data.json')).equal('json')
+})
+
+// ---------------------------
+// smartfile.memory
+// ---------------------------
+
+tap.test('.memory.toVinylFileSync() -> should produce a vinylFile', async () => {
+  let localString = 'myString'
+  let localOptions = { filename: 'vinylfile2', base: '/someDir' }
+  expect(smartfile.memory.toVinylFileSync(localString, localOptions) instanceof vinyl).to.be.true
+})
+
+tap.test('.memory.toVinylArraySync() -> should produce a an array of vinylfiles', async () => {
+  let localStringArray = [ 'string1', 'string2', 'string3' ]
+  let localOptions = { filename: 'vinylfile2', base: '/someDir' }
+  let testResult = smartfile.memory.toVinylArraySync(localStringArray, localOptions)
+  expect(testResult).to.be.a('array')
+  expect(testResult.length === 3).to.be.true
+  for (let myKey in testResult) {
+    expect(testResult[ myKey ] instanceof vinyl).to.be.true
+  }
+})
+
+tap.test('.memory.vinylToStringSync() -> should produce a String from vinyl file', async () => {
+  let localString = smartfile.memory.vinylToStringSync(new vinyl({
+    base: '/',
+    path: '/test.txt',
+    contents: new Buffer('myString')
+  }))
+  expect(localString).equal('myString')
+})
+
+tap.test('.memory.toFs() -> should write a file to disk and return a promise', async () => {
+  let localString = 'myString'
+  await smartfile.memory.toFs(
+    localString,
+    path.join(process.cwd(), './test/temp/testMemToFs.txt')
+  )
+})
+
+tap.test('.memory.toFsSync() -> should write a file to disk and return true if successfull', async () => {
+  let localString = 'myString'
+  smartfile.memory.toFsSync(
+    localString,
+    path.join(process.cwd(), './test/temp/testMemToFsSync.txt')
+  )
+})
+
+tap.test('.remote.toString() -> should load a remote file to a variable', async () => {
+  let responseString = await smartfile.remote.toString(
+    'https://raw.githubusercontent.com/pushrocks/smartfile/master/test/mytest.txt'
+  )
+  expect(responseString).to.equal('Some TestString &&%$')
+})
+
+tap.test('.remote.toString() -> should reject a Promise when the link is false', async () => {
+  await expect(smartfile.remote.toString('https://push.rocks/doesnotexist.txt'))
+    .to.eventually.be.rejected
+})
+
+// ---------------------------
+// smartfile.Smartfile
+// ---------------------------
+
+tap.test('.Smartfile -> should produce vinyl compatible files', async () => {
+  let smartfileArray = await smartfile.fs.fileTreeToObject(process.cwd(), './test/testfolder/**/*')
+  let localSmartfile = smartfileArray[0]
+  expect(localSmartfile).to.be.instanceof(smartfile.Smartfile)
+  expect(localSmartfile.contents).to.be.instanceof(Buffer)
+  expect(localSmartfile.isBuffer()).to.be.true
+  expect(localSmartfile.isDirectory()).to.be.false
+  expect(localSmartfile.isNull()).to.be.false
+})
+
+tap.start()

ts/smartfile.classes.smartfile.ts

@@ -2,27 +2,126 @@ import * as plugins from './smartfile.plugins'
 
 export interface ISmartfileConstructorOptions {
   path?: string
-  contentsString?: string
+  contentString?: string
   contentBuffer?: Buffer
+  base?: string
 }
 
+/**
+ * class Smartfile
+ * -> is vinyl file compatible
+ */
 export class Smartfile {
+  /**
+   * the full path of the file on disk
+   */
   path: string
-  contents: Buffer
+
-  constructor(optionsArg: ISmartfileConstructorOptions) {
+  /**
+   * the content of the file as Buffer
+   */
+  contentBuffer: Buffer
+
+  /**
+   * The current working directory of the file
+   */
+  base: string
+
+  /**
+   * sync the file with disk
+   */
+  sync: boolean
+
+  /**
+   * the constructor of Smartfile
+   * @param optionsArg
+   */
+  constructor (optionsArg: ISmartfileConstructorOptions) {
     if (optionsArg.contentBuffer) {
-      this.contents = optionsArg.contentBuffer
+      this.contentBuffer = optionsArg.contentBuffer
-    } else if(optionsArg.contentsString) {
+    } else if (optionsArg.contentString) {
-      this.contents = new Buffer(optionsArg.contentsString)
+      this.setContentsFromString(optionsArg.contentString)
+    } else {
+      console.log('created empty Smartfile?')
     }
     this.path = optionsArg.path
+    this.base = optionsArg.base
   }
 
+
   /**
    * set contents from string
    * @param contentString
    */
-  setContentFromString(contentString: string) {
+  setContentsFromString(contentString: string) {
     this.contents = new Buffer(contentString)
   }
+
+  /**
+   * write file to disk
+   */
+  async write () {
+
+  }
+
+  /**
+   * read file from disk
+   */
+  async read () {
+  }
+
+  // -----------------------------------------------
+  // vinyl compatibility
+  // -----------------------------------------------
+  /**
+   * vinyl-compatibility: alias of this.contentBuffer
+   */
+  get contents (): Buffer {
+    return this.contentBuffer
+  }
+  set contents (contentsArg) {
+    this.contentBuffer = contentsArg
+  }
+
+  /**
+   * vinyl-compatibility
+   */
+  get cwd () {
+    return this.base
+  }
+
+  /**
+   * return relative path of file
+   */
+  get relative (): string {
+    return this.path
+  }
+
+  /**
+   * return truw when the file has content
+   */
+  isNull (): boolean {
+    if (!this.contentBuffer) {
+      return true
+    }
+    return false
+  }
+
+  /**
+   * return true if contents are Buffer
+   */
+  isBuffer (): boolean {
+    if (this.contents instanceof Buffer) {
+      return true
+    }
+    return false
+  }
+
+  isDirectory () {
+    return false
+  }
+
+  isStream () {
+    return false
+  }
 }

ts/smartfile.fs.ts

@@ -203,19 +203,32 @@ export let toObjectSync = function (filePathArg, fileTypeArg?) {
  * @param filePath
  * @returns {string|Buffer|any}
  */
-export let toStringSync = function (filePath) {
+export let toStringSync = function (filePath: string) {
-  let fileString
+  let fileString = plugins.fsExtra.readFileSync(filePath, 'utf8')
-  fileString = plugins.fsExtra.readFileSync(filePath, 'utf8')
   return fileString
 }
 
 export let fileTreeToObject = async (dirPathArg: string, miniMatchFilter: string) => {
-  let fileTree = await listFileTree(dirPathArg, miniMatchFilter)
+  // handle absolute miniMatchFilter
+  let dirPath: string
+  if (plugins.path.isAbsolute(miniMatchFilter)) {
+    dirPath = '/'
+  } else {
+    dirPath = dirPathArg
+  }
+
+  let fileTree = await listFileTree(dirPath, miniMatchFilter)
   let smartfileArray: Smartfile[] = []
   for (let filePath of fileTree) {
+    let fileContentString = toStringSync(
+      plugins.path.join(dirPath, filePath)
+    )
+
+    // push a read file as Smartfile 
     smartfileArray.push(new Smartfile({
-      path: filePath,
+      contentBuffer: new Buffer(fileContentString),
-      contentBuffer: new Buffer(toStringSync(filePath))
+      base: dirPath,
+      path: filePath
     }))
   }
   return smartfileArray

ts/smartfile.memory.ts

@@ -5,47 +5,9 @@ import SmartfileInterpreter = require('./smartfile.interpreter')
 let vinyl = require('vinyl')
 
 export interface IVinylFile {
-    contents: Buffer
+  contents: Buffer
-    base: string
+  base: string
-    path: string,
+  path: string,
-}
-
-let Readable = require('stream').Readable
-
-/**
- * allows you to create a gulp stream
- * from String, from an Array of Strings, from Vinyl File, from an Array of VinylFiles
- * @param fileArg
- * @returns stream.Readable
- * @TODO: make it async;
- */
-export let toGulpStream = function(fileArg: string|string[]|IVinylFile|IVinylFile[],baseArg: string = '/'){
-    let fileArray = []
-
-    if (typeof fileArg === 'string' || vinyl.isVinyl(fileArg)) { // make sure we work with an array later on
-        fileArray.push(fileArg)
-    } else if (Array.isArray(fileArg)) {
-        fileArray = fileArg
-    } else {
-        throw new Error('fileArg has unknown format')
-    }
-
-    let vinylFileArray: IVinylFile[] = [] // we want to have an array of vinylFiles
-
-    for (let fileIndexArg in fileArray) { // convert fileArray in vinylArray
-        let file = fileArray[fileIndexArg]
-        file instanceof vinyl ?
-            vinylFileArray.push(file) :
-            vinylFileArray.push(toVinylFileSync(file,{filename: fileIndexArg,base: baseArg}))
-    };
-
-    let stream = new Readable({ objectMode: true })
-    for (let vinylFileIndexArg in vinylFileArray) {
-        let vinylFile = vinylFileArray[vinylFileIndexArg]
-        stream.push(vinylFile)
-    };
-    stream.push(null) // signal end of stream;
-    return stream
 }
 
 /**
@@ -54,8 +16,8 @@ export let toGulpStream = function(fileArg: string|string[]|IVinylFile|IVinylFil
  * @param fileTypeArg
  * @returns {any|any}
  */
-export let toObject = function(fileStringArg: string,fileTypeArg: string){
+export let toObject = function (fileStringArg: string, fileTypeArg: string) {
-    return SmartfileInterpreter.objectFile(fileStringArg,fileTypeArg)
+  return SmartfileInterpreter.objectFile(fileStringArg, fileTypeArg)
 }
 
 /**
@@ -63,17 +25,17 @@ export let toObject = function(fileStringArg: string,fileTypeArg: string){
  * @param fileArg
  * @param optionsArg
  */
-export let toVinylFileSync = function(fileArg: string,optionsArg?: {filename?: string,base?: string,relPath?: string}) {
+export let toVinylFileSync = function (fileArg: string, optionsArg?: { filename?: string, base?: string, relPath?: string }) {
-    optionsArg ? void(0) : optionsArg = {filename: 'vinylfile', base: '/'}
+  optionsArg ? void (0) : optionsArg = { filename: 'vinylfile', base: '/' }
-    optionsArg.filename ? void(0) : optionsArg.filename = 'vinylfile'
+  optionsArg.filename ? void (0) : optionsArg.filename = 'vinylfile'
-    optionsArg.base ? void(0) : optionsArg.base = '/'
+  optionsArg.base ? void (0) : optionsArg.base = '/'
-    optionsArg.relPath ? void('0') : optionsArg.relPath = ''
+  optionsArg.relPath ? void ('0') : optionsArg.relPath = ''
-    let vinylFile = new vinyl({
+  let vinylFile = new vinyl({
-        base: optionsArg.base,
+    base: optionsArg.base,
-        path: plugins.path.join(optionsArg.base,optionsArg.relPath,optionsArg.filename),
+    path: plugins.path.join(optionsArg.base, optionsArg.relPath, optionsArg.filename),
-        contents: new Buffer(fileArg)
+    contents: new Buffer(fileArg)
-    })
+  })
-    return vinylFile
+  return vinylFile
 }
 
 /**
@@ -81,27 +43,27 @@ export let toVinylFileSync = function(fileArg: string,optionsArg?: {filename?: s
  * @param arrayArg
  * @param optionsArg
  */
-export let toVinylArraySync = function(
+export let toVinylArraySync = function (
-    arrayArg: string[],
+  arrayArg: string[],
-    optionsArg?: {
+  optionsArg?: {
-        filename?: string,
+    filename?: string,
-        base?: string,
+    base?: string,
-        relPath?: string
+    relPath?: string
-    }
+  }
-){
+) {
-    let vinylArray = []
+  let vinylArray = []
-    for (let stringIndexArg in arrayArg) {
+  for (let stringIndexArg in arrayArg) {
-        let myString = arrayArg[stringIndexArg]
+    let myString = arrayArg[ stringIndexArg ]
-        vinylArray.push(toVinylFileSync(myString,optionsArg))
+    vinylArray.push(toVinylFileSync(myString, optionsArg))
-    }
+  }
-    return vinylArray
+  return vinylArray
 }
 
 /**
  * takes a vinylFile object and converts it to String
  */
-export let vinylToStringSync = function(fileArg: IVinylFile): string {
+export let vinylToStringSync = function (fileArg: IVinylFile): string {
-    return fileArg.contents.toString('utf8')
+  return fileArg.contents.toString('utf8')
 }
 
 /**
@@ -110,41 +72,41 @@ export let vinylToStringSync = function(fileArg: IVinylFile): string {
  * @param fileNameArg
  * @param fileBaseArg
  */
-export let toFs = function(fileContentArg: string|IVinylFile,filePathArg){
+export let toFs = function (fileContentArg: string | IVinylFile, filePathArg) {
-    let done = plugins.q.defer()
+  let done = plugins.q.defer()
 
-    // function checks to abort if needed
+  // function checks to abort if needed
-    if (!fileContentArg || !filePathArg) {
+  if (!fileContentArg || !filePathArg) {
-        throw new Error('expected valid arguments')
+    throw new Error('expected valid arguments')
-    }
+  }
 
-    // prepare actual write action
+  // prepare actual write action
-    let fileString: string
+  let fileString: string
-    let filePath: string = filePathArg
+  let filePath: string = filePathArg
-    if (vinyl.isVinyl(fileContentArg)) {
+  if (vinyl.isVinyl(fileContentArg)) {
-        let fileContentArg2: any = fileContentArg
+    let fileContentArg2: any = fileContentArg
-        fileString = vinylToStringSync(fileContentArg2)
+    fileString = vinylToStringSync(fileContentArg2)
-    } else if (typeof fileContentArg === 'string') {
+  } else if (typeof fileContentArg === 'string') {
-        fileString = fileContentArg
+    fileString = fileContentArg
-    }
+  }
-    plugins.fsExtra.writeFile(filePath,fileString,'utf8',done.resolve)
+  plugins.fsExtra.writeFile(filePath, fileString, 'utf8', done.resolve)
-    return done.promise
+  return done.promise
 }
 
-export let toFsSync = function(fileArg,filePathArg: string){
+export let toFsSync = function (fileArg, filePathArg: string) {
-    // function checks to abort if needed
+  // function checks to abort if needed
-    if (!fileArg || !filePathArg) {
+  if (!fileArg || !filePathArg) {
-        throw new Error('expected a valid arguments')
+    throw new Error('expected a valid arguments')
-    }
+  }
 
-    // prepare actual write action
+  // prepare actual write action
-    let fileString: string
+  let fileString: string
-    let filePath: string = filePathArg
+  let filePath: string = filePathArg
 
-    if (typeof fileArg !== 'string') {
+  if (typeof fileArg !== 'string') {
-        fileString = vinylToStringSync(fileArg)
+    fileString = vinylToStringSync(fileArg)
-    } else if (typeof fileArg === 'string') {
+  } else if (typeof fileArg === 'string') {
-        fileString = fileArg
+    fileString = fileArg
-    }
+  }
-    plugins.fsExtra.writeFileSync(filePath,fileString,'utf8')
+  plugins.fsExtra.writeFileSync(filePath, fileString, 'utf8')
 }

yarn.lock

@@ -9,39 +9,31 @@
     "@types/chai" "*"
     "@types/promises-a-plus" "*"
 
-"@types/chai@*", "@types/chai@^3.4.34":
+"@types/chai-string@^1.1.30":
-  version "3.4.35"
+  version "1.1.30"
-  resolved "https://registry.yarnpkg.com/@types/chai/-/chai-3.4.35.tgz#e8d65f83492d2944f816fc620741821c28a8c900"
+  resolved "https://registry.yarnpkg.com/@types/chai-string/-/chai-string-1.1.30.tgz#4d8744b31a5a2295fc01c981ed1e2d4c8a070f0a"
+  dependencies:
+    "@types/chai" "*"
 
-"@types/fs-extra@0.x.x":
+"@types/chai@*", "@types/chai@^3.4.35":
-  version "0.0.37"
+  version "3.5.2"
-  resolved "https://registry.yarnpkg.com/@types/fs-extra/-/fs-extra-0.0.37.tgz#195f11bcd9a1b97d9e412c6b66899b545471a1f7"
+  resolved "https://registry.yarnpkg.com/@types/chai/-/chai-3.5.2.tgz#c11cd2817d3a401b7ba0f5a420f35c56139b1c1e"
+
+"@types/fs-extra@2.x.x":
+  version "2.1.0"
+  resolved "https://registry.yarnpkg.com/@types/fs-extra/-/fs-extra-2.1.0.tgz#8b350239c0455d92b8d3c626edac193860ff395f"
   dependencies:
     "@types/node" "*"
 
-"@types/mocha@^2.2.31":
-  version "2.2.39"
-  resolved "https://registry.yarnpkg.com/@types/mocha/-/mocha-2.2.39.tgz#f68d63db8b69c38e9558b4073525cf96c4f7a829"
-
 "@types/node@*":
-  version "7.0.5"
+  version "7.0.14"
-  resolved "https://registry.yarnpkg.com/@types/node/-/node-7.0.5.tgz#96a0f0a618b7b606f1ec547403c00650210bfbb7"
+  resolved "https://registry.yarnpkg.com/@types/node/-/node-7.0.14.tgz#1470fa002a113316ac9d9ad163fc738c7a0de2a4"
 
 "@types/promises-a-plus@*":
   version "0.0.27"
   resolved "https://registry.yarnpkg.com/@types/promises-a-plus/-/promises-a-plus-0.0.27.tgz#c64651134614c84b8f5d7114ce8901d36a609780"
 
-"@types/q@0.0.32":
+"@types/through2@^2.0.32":
-  version "0.0.32"
-  resolved "https://registry.yarnpkg.com/@types/q/-/q-0.0.32.tgz#bd284e57c84f1325da702babfc82a5328190c0c5"
-
-"@types/shelljs@^0.3.33":
-  version "0.3.33"
-  resolved "https://registry.yarnpkg.com/@types/shelljs/-/shelljs-0.3.33.tgz#df613bddb88225ed09ce5c835f620dcaaf155e6b"
-  dependencies:
-    "@types/node" "*"
-
-"@types/through2@^2.0.31":
   version "2.0.32"
   resolved "https://registry.yarnpkg.com/@types/through2/-/through2-2.0.32.tgz#470024450f1ab7640f19f9ebf42d3da574c26129"
   dependencies:
@@ -53,6 +45,10 @@
   dependencies:
     "@types/node" "*"
 
+ansi-256-colors@^1.1.0:
+  version "1.1.0"
+  resolved "https://registry.yarnpkg.com/ansi-256-colors/-/ansi-256-colors-1.1.0.tgz#910de50efcc7c09e3d82f2f87abd6b700c18818a"
+
 argparse@^1.0.7:
   version "1.0.9"
   resolved "https://registry.yarnpkg.com/argparse/-/argparse-1.0.9.tgz#73d83bc263f86e97f8cc4f6bae1b0e90a7d22c86"
@@ -67,14 +63,25 @@ balanced-match@^0.4.1:
   version "0.4.2"
   resolved "https://registry.yarnpkg.com/balanced-match/-/balanced-match-0.4.2.tgz#cb3f3e3c732dc0f01ee70b403f302e61d7709838"
 
+beautycolor@^1.0.7:
+  version "1.0.7"
+  resolved "https://registry.yarnpkg.com/beautycolor/-/beautycolor-1.0.7.tgz#a4715738ac4c8221371e9cbeb5a6cc6d11ecbf7c"
+  dependencies:
+    ansi-256-colors "^1.1.0"
+    typings-global "^1.0.14"
+
+bindings@^1.2.1:
+  version "1.2.1"
+  resolved "https://registry.yarnpkg.com/bindings/-/bindings-1.2.1.tgz#14ad6113812d2d37d72e67b4cacb4bb726505f11"
+
 brace-expansion@^1.0.0:
-  version "1.1.6"
+  version "1.1.7"
-  resolved "https://registry.yarnpkg.com/brace-expansion/-/brace-expansion-1.1.6.tgz#7197d7eaa9b87e648390ea61fc66c84427420df9"
+  resolved "https://registry.yarnpkg.com/brace-expansion/-/brace-expansion-1.1.7.tgz#3effc3c50e000531fb720eaff80f0ae8ef23cf59"
   dependencies:
     balanced-match "^0.4.1"
     concat-map "0.0.1"
 
-buffer-shims@^1.0.0:
+buffer-shims@~1.0.0:
   version "1.0.0"
   resolved "https://registry.yarnpkg.com/buffer-shims/-/buffer-shims-1.0.0.tgz#9978ce317388c649ad8793028c3477ef044a8b51"
 
@@ -84,6 +91,10 @@ chai-as-promised@^6.0.0:
   dependencies:
     check-error "^1.0.2"
 
+chai-string@^1.3.0:
+  version "1.3.0"
+  resolved "https://registry.yarnpkg.com/chai-string/-/chai-string-1.3.0.tgz#df6139f294391b1035be5606f60a843b3a5041e7"
+
 chai@^3.5.0:
   version "3.5.0"
   resolved "https://registry.yarnpkg.com/chai/-/chai-3.5.0.tgz#4d02637b067fe958bdbfdd3a40ec56fef7373247"
@@ -130,6 +141,14 @@ deep-eql@^0.1.3:
   dependencies:
     type-detect "0.1.1"
 
+early@^2.1.1:
+  version "2.1.1"
+  resolved "https://registry.yarnpkg.com/early/-/early-2.1.1.tgz#841e23254ea5dc54d8afaeee82f5ab65c00ee23c"
+  dependencies:
+    beautycolor "^1.0.7"
+    smartq "^1.1.1"
+    typings-global "^1.0.16"
+
 esprima@^3.1.1:
   version "3.1.3"
   resolved "https://registry.yarnpkg.com/esprima/-/esprima-3.1.3.tgz#fdca51cee6133895e3c88d535ce49dbff62a4633"
@@ -140,12 +159,13 @@ first-chunk-stream@^2.0.0:
   dependencies:
     readable-stream "^2.0.2"
 
-fs-extra@^2.0.0:
+fs-extra@^3.0.0:
-  version "2.0.0"
+  version "3.0.0"
-  resolved "https://registry.yarnpkg.com/fs-extra/-/fs-extra-2.0.0.tgz#337352bded4a0b714f3eb84de8cea765e9d37600"
+  resolved "https://registry.yarnpkg.com/fs-extra/-/fs-extra-3.0.0.tgz#244e0c4b0b8818f54040ec049d8a2bddc1202861"
   dependencies:
     graceful-fs "^4.1.2"
-    jsonfile "^2.1.0"
+    jsonfile "^3.0.0"
+    universalify "^0.1.0"
 
 fs.realpath@^1.0.0:
   version "1.0.0"
@@ -166,15 +186,14 @@ graceful-fs@^4.1.2, graceful-fs@^4.1.6:
   version "4.1.11"
   resolved "https://registry.yarnpkg.com/graceful-fs/-/graceful-fs-4.1.11.tgz#0e8bdfe4d1ddb8854d64e04ea7c00e2a026e5658"
 
-gulp-function@^2.2.3:
+gulp-function@^2.2.9:
-  version "2.2.3"
+  version "2.2.9"
-  resolved "https://registry.yarnpkg.com/gulp-function/-/gulp-function-2.2.3.tgz#8f62de74ce74de3fa91c48ba247472c1f56873bd"
+  resolved "https://registry.yarnpkg.com/gulp-function/-/gulp-function-2.2.9.tgz#de513103db9d817e94bb8aab45f30bf286f19ae5"
   dependencies:
-    "@types/q" "0.0.32"
+    "@types/through2" "^2.0.32"
-    "@types/through2" "^2.0.31"
+    smartq "^1.1.1"
-    q "^1.4.1"
+    through2 "^2.0.3"
-    through2 "^2.0.1"
+    typings-global "^1.0.16"
-    typings-global "^1.0.14"
 
 home@^1.0.1:
   version "1.0.1"
@@ -194,8 +213,8 @@ inherits@2, inherits@^2.0.1, inherits@~2.0.1:
   resolved "https://registry.yarnpkg.com/inherits/-/inherits-2.0.3.tgz#633c2c83e3da42a502f52466022480f4208261de"
 
 interpret@^1.0.0:
-  version "1.0.1"
+  version "1.0.3"
-  resolved "https://registry.yarnpkg.com/interpret/-/interpret-1.0.1.tgz#d579fb7f693b858004947af39fa0db49f795602c"
+  resolved "https://registry.yarnpkg.com/interpret/-/interpret-1.0.3.tgz#cbc35c62eeee73f19ab7b10a801511401afc0f90"
 
 is-stream@^1.1.0:
   version "1.1.0"
@@ -209,33 +228,52 @@ isarray@~1.0.0:
   version "1.0.0"
   resolved "https://registry.yarnpkg.com/isarray/-/isarray-1.0.0.tgz#bb935d48582cba168c06834957a54a3e07124f11"
 
-js-yaml@^3.7.0:
+js-yaml@^3.8.3:
-  version "3.8.1"
+  version "3.8.3"
-  resolved "https://registry.yarnpkg.com/js-yaml/-/js-yaml-3.8.1.tgz#782ba50200be7b9e5a8537001b7804db3ad02628"
+  resolved "https://registry.yarnpkg.com/js-yaml/-/js-yaml-3.8.3.tgz#33a05ec481c850c8875929166fe1beb61c728766"
   dependencies:
     argparse "^1.0.7"
     esprima "^3.1.1"
 
-jsonfile@^2.1.0:
+jsonfile@^3.0.0:
-  version "2.4.0"
+  version "3.0.0"
-  resolved "https://registry.yarnpkg.com/jsonfile/-/jsonfile-2.4.0.tgz#3736a2b428b87bbda0cc83b53fa3d633a35c2ae8"
+  resolved "https://registry.yarnpkg.com/jsonfile/-/jsonfile-3.0.0.tgz#92e7c7444e5ffd5fa32e6a9ae8b85034df8347d0"
   optionalDependencies:
     graceful-fs "^4.1.6"
 
+leakage@^0.2.0:
+  version "0.2.0"
+  resolved "https://registry.yarnpkg.com/leakage/-/leakage-0.2.0.tgz#9e7a8cc1d241d8c8427e348769e192e172fd8733"
+  dependencies:
+    left-pad "^1.1.3"
+    memwatch-next "^0.3.0"
+    minimist "^1.2.0"
+    pretty-bytes "^4.0.2"
+
+left-pad@^1.1.3:
+  version "1.1.3"
+  resolved "https://registry.yarnpkg.com/left-pad/-/left-pad-1.1.3.tgz#612f61c033f3a9e08e939f1caebeea41b6f3199a"
+
+memwatch-next@^0.3.0:
+  version "0.3.0"
+  resolved "https://registry.yarnpkg.com/memwatch-next/-/memwatch-next-0.3.0.tgz#2111050f9a906e0aa2d72a4ec0f0089c78726f8f"
+  dependencies:
+    bindings "^1.2.1"
+    nan "^2.3.2"
+
 minimatch@^3.0.2:
   version "3.0.3"
   resolved "https://registry.yarnpkg.com/minimatch/-/minimatch-3.0.3.tgz#2a4e4090b96b2db06a9d7df01055a62a77c9b774"
   dependencies:
     brace-expansion "^1.0.0"
 
-npmts-g@^6.0.0:
+minimist@^1.2.0:
-  version "6.0.0"
+  version "1.2.0"
-  resolved "https://registry.yarnpkg.com/npmts-g/-/npmts-g-6.0.0.tgz#491fd50f110967f1b68f14237e7ea5157bf4ddb3"
+  resolved "https://registry.yarnpkg.com/minimist/-/minimist-1.2.0.tgz#a35008b20f41383eec1fb914f4cd5df79a264284"
-  dependencies:
+
-    "@types/shelljs" "^0.3.33"
+nan@^2.3.2:
-    semver "^5.3.0"
+  version "2.6.2"
-    shelljs "^0.7.5"
+  resolved "https://registry.yarnpkg.com/nan/-/nan-2.6.2.tgz#e4ff34e6c95fdfb5aecc08de6596f43605a7db45"
-    typings-global "^1.0.14"
 
 once@^1.3.0:
   version "1.4.0"
@@ -251,28 +289,32 @@ path-is-absolute@^1.0.0:
   version "1.0.1"
   resolved "https://registry.yarnpkg.com/path-is-absolute/-/path-is-absolute-1.0.1.tgz#174b9268735534ffbc7ace6bf53a5a9e1b5c5f5f"
 
+path-parse@^1.0.5:
+  version "1.0.5"
+  resolved "https://registry.yarnpkg.com/path-parse/-/path-parse-1.0.5.tgz#3c1adf871ea9cd6c9431b6ea2bd74a0ff055c4c1"
+
 pify@^2.3.0:
   version "2.3.0"
   resolved "https://registry.yarnpkg.com/pify/-/pify-2.3.0.tgz#ed141a6ac043a849ea588498e7dca8b15330e90c"
 
+pretty-bytes@^4.0.2:
+  version "4.0.2"
+  resolved "https://registry.yarnpkg.com/pretty-bytes/-/pretty-bytes-4.0.2.tgz#b2bf82e7350d65c6c33aa95aaa5a4f6327f61cd9"
+
 process-nextick-args@^1.0.6, process-nextick-args@~1.0.6:
   version "1.0.7"
   resolved "https://registry.yarnpkg.com/process-nextick-args/-/process-nextick-args-1.0.7.tgz#150e20b756590ad3f91093f25a4f2ad8bff30ba3"
 
-q@^1.4.1:
-  version "1.4.1"
-  resolved "https://registry.yarnpkg.com/q/-/q-1.4.1.tgz#55705bcd93c5f3673530c2c2cbc0c2b3addc286e"
-
 readable-stream@^2.0.2, readable-stream@^2.1.5:
-  version "2.2.2"
+  version "2.2.9"
-  resolved "https://registry.yarnpkg.com/readable-stream/-/readable-stream-2.2.2.tgz#a9e6fec3c7dda85f8bb1b3ba7028604556fc825e"
+  resolved "https://registry.yarnpkg.com/readable-stream/-/readable-stream-2.2.9.tgz#cf78ec6f4a6d1eb43d26488cac97f042e74b7fc8"
   dependencies:
-    buffer-shims "^1.0.0"
+    buffer-shims "~1.0.0"
     core-util-is "~1.0.0"
     inherits "~2.0.1"
     isarray "~1.0.0"
     process-nextick-args "~1.0.6"
-    string_decoder "~0.10.x"
+    string_decoder "~1.0.0"
     util-deprecate "~1.0.1"
 
 rechoir@^0.6.2:
@@ -294,38 +336,48 @@ require-reload@0.2.2:
   resolved "https://registry.yarnpkg.com/require-reload/-/require-reload-0.2.2.tgz#29a7591846caf91b6e8a3cda991683f95f8d7d42"
 
 resolve@^1.1.6:
-  version "1.2.0"
+  version "1.3.3"
-  resolved "https://registry.yarnpkg.com/resolve/-/resolve-1.2.0.tgz#9589c3f2f6149d1417a40becc1663db6ec6bc26c"
+  resolved "https://registry.yarnpkg.com/resolve/-/resolve-1.3.3.tgz#655907c3469a8680dc2de3a275a8fdd69691f0e5"
+  dependencies:
+    path-parse "^1.0.5"
 
 semver@^5.3.0:
   version "5.3.0"
   resolved "https://registry.yarnpkg.com/semver/-/semver-5.3.0.tgz#9b2ce5d3de02d17c6012ad326aa6b4d0cf54f94f"
 
-shelljs@^0.7.4, shelljs@^0.7.5:
+shelljs@^0.7.7:
-  version "0.7.6"
+  version "0.7.7"
-  resolved "https://registry.yarnpkg.com/shelljs/-/shelljs-0.7.6.tgz#379cccfb56b91c8601e4793356eb5382924de9ad"
+  resolved "https://registry.yarnpkg.com/shelljs/-/shelljs-0.7.7.tgz#b2f5c77ef97148f4b4f6e22682e10bba8667cff1"
   dependencies:
     glob "^7.0.0"
     interpret "^1.0.0"
     rechoir "^0.6.2"
 
-smartchai@^1.0.1:
+smartchai@^1.0.3:
-  version "1.0.1"
+  version "1.0.3"
-  resolved "https://registry.yarnpkg.com/smartchai/-/smartchai-1.0.1.tgz#cde7776212fa5145d62dc4195405929807a3e0e5"
+  resolved "https://registry.yarnpkg.com/smartchai/-/smartchai-1.0.3.tgz#de6d010bb8b5aef24cb70b31a5f5334e8c41b72f"
   dependencies:
-    "@types/chai" "^3.4.34"
+    "@types/chai" "^3.4.35"
     "@types/chai-as-promised" "0.0.29"
+    "@types/chai-string" "^1.1.30"
     chai "^3.5.0"
     chai-as-promised "^6.0.0"
+    chai-string "^1.3.0"
 
-smartpath@^3.2.7:
+smartdelay@^1.0.1:
-  version "3.2.7"
+  version "1.0.1"
-  resolved "https://registry.yarnpkg.com/smartpath/-/smartpath-3.2.7.tgz#01688f01f9abbaa418dc2be561d9b0eaef3e5782"
+  resolved "https://registry.yarnpkg.com/smartdelay/-/smartdelay-1.0.1.tgz#687f8bcc09d7c62c9c5a8a1771c1aba3aff54156"
+  dependencies:
+    typings-global "^1.0.14"
+
+smartpath@^3.2.8:
+  version "3.2.8"
+  resolved "https://registry.yarnpkg.com/smartpath/-/smartpath-3.2.8.tgz#4834bd3a8bae2295baacadba23c87a501952f940"
   dependencies:
     home "^1.0.1"
     typings-global "^1.0.14"
 
-smartq@^1.0.4, smartq@^1.1.0:
+smartq@^1.1.0, smartq@^1.1.1:
   version "1.1.1"
   resolved "https://registry.yarnpkg.com/smartq/-/smartq-1.1.1.tgz#efb358705260d41ae18aef7ffd815f7b6fe17dd3"
   dependencies:
@@ -343,9 +395,11 @@ sprintf-js@~1.0.2:
   version "1.0.3"
   resolved "https://registry.yarnpkg.com/sprintf-js/-/sprintf-js-1.0.3.tgz#04e6926f662895354f3dd015203633b857297e2c"
 
-string_decoder@~0.10.x:
+string_decoder@~1.0.0:
-  version "0.10.31"
+  version "1.0.0"
-  resolved "https://registry.yarnpkg.com/string_decoder/-/string_decoder-0.10.31.tgz#62e203bc41766c6c28c9fc84301dab1c5310fa94"
+  resolved "https://registry.yarnpkg.com/string_decoder/-/string_decoder-1.0.0.tgz#f06f41157b664d86069f84bdbdc9b0d8ab281667"
+  dependencies:
+    buffer-shims "~1.0.0"
 
 strip-bom-buf@^1.0.0:
   version "1.0.0"
@@ -366,7 +420,18 @@ strip-bom@^2.0.0:
   dependencies:
     is-utf8 "^0.2.0"
 
-through2@^2.0.1:
+tapbundle@^1.0.10:
+  version "1.0.10"
+  resolved "https://registry.yarnpkg.com/tapbundle/-/tapbundle-1.0.10.tgz#36fd40036f6b5b738cbb9b5fc400df4c4031bc26"
+  dependencies:
+    early "^2.1.1"
+    leakage "^0.2.0"
+    smartchai "^1.0.3"
+    smartdelay "^1.0.1"
+    smartq "^1.1.1"
+    typings-global "^1.0.16"
+
+through2@^2.0.1, through2@^2.0.3:
   version "2.0.3"
   resolved "https://registry.yarnpkg.com/through2/-/through2-2.0.3.tgz#0004569b37c7c74ba39c43f3ced78d1ad94140be"
   dependencies:
@@ -385,19 +450,16 @@ typed-promisify@^0.3.0:
   version "0.3.0"
   resolved "https://registry.yarnpkg.com/typed-promisify/-/typed-promisify-0.3.0.tgz#1ba0af5e444c87d8047406f18ce49092a1191853"
 
-typings-global@*, typings-global@^1.0.14:
+typings-global@^1.0.14, typings-global@^1.0.16:
-  version "1.0.14"
+  version "1.0.16"
-  resolved "https://registry.yarnpkg.com/typings-global/-/typings-global-1.0.14.tgz#ab682720a03d6b9278869fb5c30c30d7dc61d12c"
+  resolved "https://registry.yarnpkg.com/typings-global/-/typings-global-1.0.16.tgz#489b71781af24268750c2899316400a5e482961f"
   dependencies:
     semver "^5.3.0"
-    shelljs "^0.7.4"
+    shelljs "^0.7.7"
 
-typings-test@^1.0.3:
+universalify@^0.1.0:
-  version "1.0.3"
+  version "0.1.0"
-  resolved "https://registry.yarnpkg.com/typings-test/-/typings-test-1.0.3.tgz#fbab895eb3f0c44842e73db059f65946b971e369"
+  resolved "https://registry.yarnpkg.com/universalify/-/universalify-0.1.0.tgz#9eb1c4651debcc670cc94f1a75762332bb967778"
-  dependencies:
-    "@types/mocha" "^2.2.31"
-    typings-global "*"
 
 util-deprecate@~1.0.1:
   version "1.0.2"
@@ -413,9 +475,9 @@ vinyl-file@^3.0.0:
     strip-bom-stream "^2.0.0"
     vinyl "^2.0.1"
 
-vinyl@^2.0.1:
+vinyl@^2.0.1, vinyl@^2.0.2:
-  version "2.0.1"
+  version "2.0.2"
-  resolved "https://registry.yarnpkg.com/vinyl/-/vinyl-2.0.1.tgz#1c3b4931e7ac4c1efee743f3b91a74c094407bb6"
+  resolved "https://registry.yarnpkg.com/vinyl/-/vinyl-2.0.2.tgz#0a3713d8d4e9221c58f10ca16c0116c9e25eda7c"
   dependencies:
     clone "^1.0.0"
     clone-buffer "^1.0.0"