4.1.3

.gitignore

@@ -1,6 +1,7 @@
 node_modules/
-.settings/
-.idea/
+coverage/
+pages/
+public/
+
+test/temp/
 
-ts/*.js
-ts/*.js.map

.gitlab-ci.yml

@@ -0,0 +1,59 @@
+image: hosttoday/ht-docker-node:npmts
+
+stages:
+- test
+- release
+- trigger
+- pages
+
+testLEGACY:
+  stage: test
+  script:
+    - npmci test legacy
+  tags:
+    - docker
+  allow_failure: true
+
+testLTS:
+  stage: test
+  script:
+    - npmci test lts
+  tags:
+    - docker
+    
+testSTABLE:
+  stage: test
+  script:
+    - npmci test stable
+  tags:
+    - docker
+
+release:
+  stage: release
+  script:
+    - npmci publish
+  only:
+    - tags
+  tags:
+    - docker
+
+trigger:
+  stage: trigger
+  script:
+    - npmci trigger
+  only:
+    - tags
+  tags:
+    - docker
+
+pages:
+  image: hosttoday/ht-docker-node:npmpage
+  stage: pages
+  script:
+    - npmci command npmpage --publish gitlab
+  only:
+    - tags
+  artifacts:
+    expire_in: 1 week
+    paths:
+    - public

.npmignore

@@ -0,0 +1,4 @@
+coverage/
+docs/
+test/
+ts/

.travis.yml

@@ -1,16 +0,0 @@
-language: node_js
-node_js:
-- '4.1'
-before_install:
-- npm install -g tsd
-deploy:
-  provider: npm
-  email: npm@smart-coordination.com
-  api_key:
-    secure: 3RdzAcS9d6sLJs3tHM2uCVU2wV2NsKiLiYWue98DevgijIqTFDHtYuoP29p7fbB4SV87JRbTK1y41QM2u/CCjnbB+mrAUg/Pn08dTibmzi9liom67sLczIPD4eZeMznXPRaddESQdzqrtQfc/6P+1JQO7XWexLNebgYtMrUzYcOrHPWf/Uktk2cKiYfrO8piSR+HOFh2rzC5HjVZ/7fKDIa9bqTlBETkNc7s2NgB++jKRF9LNMVGI/9EmxjBzSSE1juOz26Ahp4+/+P3Lc5LngnTFOYsPoW5iWNY+AQltZxhu9K+rrtfn90rmQDnO7RCGO5yZgMS2+0UjJedwV+4ancU3nzoNmiuoIL7DjQ7NQlt0QKMmIqZuBFBc3tdxqotxNoJDk8/Ui0yfHWzJz0Fd22OI+VdTWNH1y5Vyywsql6wwkl2+Da1WhZf/Mn2gPgLPI0lssPTIl/u3Bey+167tZ3HvX0yqlvPO/JbqK02+5VrRBaV67vT00DG+dh4nnwqcX14Umx2a3JHt3tSGkDnDKpsLbvqjhPhkMRsCIloju+wMnyKjtScMZW+2FeO2n4PgbjNhF+5SG8pDmTS8p0Vy7iohUOiGIJty7K/1r6sQ1FNluhO5Ol3mBDs6wjg6S5QCSNL9eylpV52FV0UX4cRCijmzso+n48I2BbSwjghTB8=
-  on:
-    tags: true
-    repo: pushrocks/smartfile
-notifications:
-  slack:
-    secure: f5Uss0z9RPl/QcA/DroB8loyE93aOYI6bqCkrsiUscmZtlv/TVQtT4dxqGA6uvcG6iTQDBi3Ul88dQxWkRm4IqbhY35/iMaV2dHW4FVYMAh8GQMbsfL2sALCcufxD9blw47awv3iFcwhV1EeyesscjgL0JIjduk96v/7G/6QIO2838M1lzlgtj+kRUkim8qkaEs1je3gRrhMUIjLuAdscMXyUKYFMjWo9ACSjVUl30R/ZNemb18itIja6i92GotreBgcfEMczvy58ovDC7xdJUsY8LjMI01DwY+WPRnI0tAhsuI8moBwwcdM4e3bAjKjucQRjO33O5bMWRZ6QCiYd0DnCEFyCPQLJ4GSy/tkD00n8ijLHAOSV3AH1zNbdK1EAdSPQXDvlI36KJn/2hyQLoitGHVUPr76ujJWP82ypO2tgIp3XQU0dJVCxDuHnwJO2+hjdI+gCPqxNTpjeujHx3UdkTGNRjuuf9dlZ/D08fApjYxy2fxItTqo3QjP/nrqvBXUOPP8yPHpjIT4H2t5Pr4SJjBGI6X4qhKyFj6s9rA/Xu1rL+45zu1C3uC3z+u3T9UwrbzJ/cZM6r6UQvQmUvIfBNaMlg4I/diQCDIPL+Rhop2nylY3IcHmJnk2itn7kOqj1tohCpFEml5pRuSZy4udWywkdtyBAsHWFLF7oiQ=

README.md

@@ -1,39 +1,36 @@
-# gulp-bootstrap
-works with gulp, but does nothing. Use it to bootstrap your own gulp plugin with TypeScript, Travis and npm.
+# smartfile
+make files easily accessible for processing in javascript.
 
-### Buildstatus/Dependencies
-[![Build Status](https://travis-ci.org/pushrocks/gulp-bootstrap.svg?branch=master)](https://travis-ci.org/pushrocks/gulp-bootstrap)
-[![devDependency Status](https://david-dm.org/pushrocks/gulp-bootstrap/dev-status.svg)](https://david-dm.org/pushrocks/gulp-bootstrap#info=devDependencies)
+## Availabililty
+[![npm](https://push.rocks/assets/repo-button-npm.svg)](https://www.npmjs.com/package/smartfile)
+[![git](https://push.rocks/assets/repo-button-git.svg)](https://gitlab.com/pushrocks/smartfile)
+[![git](https://push.rocks/assets/repo-button-mirror.svg)](https://github.com/pushrocks/smartfile)
+[![docs](https://push.rocks/assets/repo-button-docs.svg)](https://pushrocks.gitlab.io/smartfile/)
 
-### Usage
-This npm package comes with everything you need to start your own gulp plugin.
+## 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/)
 
-Features:
+## Usage
+smartfile is an approach of being one tool to handle files in diverse environments.
 
-* TypeScript: Code your plugin in TypeScript
-* Use gulp to compile TypeScript without the global gulp CLI Tool.
-* Use travis to deploy to npm
-* Have a master branch for the latest dev version
-* Have a release branch for the latest npm version
+### Smartfile Sections
+smartfile thinks in sections:
 
-This package **doesn't require global gulp** (just local -> simply do npm install`) to compile TypeScript.
+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
 
-* to compile TypeScript do `npm test` (You should chain your own tests to this command later on)
-* to setup release do `npm run setup`
-* to release a patch do `npm run release`
-
-We recommend using travis for npm releasing and test integration.
-
-#### The structure
-
-```
-gulp-bootstrap/
-|
-|- ts/
-|  |- compile/
-|  |  |- compile.js **** contains gulp task`
-|  |- index.ts **** Your main TypeScript file.
-|  
-|- index.js **** the compiled module
-```
+For more information read the docs
 
+[![npm](https://push.rocks/assets/repo-header.svg)](https://push.rocks)

dist/index.d.ts

@@ -0,0 +1,11 @@
+import 'typings-global';
+import * as SmartfileFs from './smartfile.fs';
+import * as SmartfileInterpreter from './smartfile.interpreter';
+import * as SmartfileMemory from './smartfile.memory';
+import * as SmartfileRemote from './smartfile.remote';
+export { Smartfile } from './smartfile.classes.smartfile';
+export declare let fs: typeof SmartfileFs;
+export declare let interpreter: typeof SmartfileInterpreter;
+export declare let memory: typeof SmartfileMemory;
+export declare let remote: typeof SmartfileRemote;
+export declare let requireReload: (path: string) => any;

dist/index.js

@@ -0,0 +1,14 @@
+"use strict";
+require("typings-global");
+const SmartfileFs = require("./smartfile.fs");
+const SmartfileInterpreter = require("./smartfile.interpreter");
+const SmartfileMemory = require("./smartfile.memory");
+const SmartfileRemote = require("./smartfile.remote");
+var smartfile_classes_smartfile_1 = require("./smartfile.classes.smartfile");
+exports.Smartfile = smartfile_classes_smartfile_1.Smartfile;
+exports.fs = SmartfileFs;
+exports.interpreter = SmartfileInterpreter;
+exports.memory = SmartfileMemory;
+exports.remote = SmartfileRemote;
+exports.requireReload = SmartfileFs.requireReload;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUEsMEJBQXVCO0FBR3ZCLDhDQUE2QztBQUM3QyxnRUFBK0Q7QUFDL0Qsc0RBQXFEO0FBQ3JELHNEQUFxRDtBQUVyRCw2RUFBdUQ7QUFBL0Msa0RBQUEsU0FBUyxDQUFBO0FBRU4sUUFBQSxFQUFFLEdBQUcsV0FBVyxDQUFBO0FBQ2hCLFFBQUEsV0FBVyxHQUFHLG9CQUFvQixDQUFBO0FBQ2xDLFFBQUEsTUFBTSxHQUFHLGVBQWUsQ0FBQTtBQUN4QixRQUFBLE1BQU0sR0FBRyxlQUFlLENBQUE7QUFDeEIsUUFBQSxhQUFhLEdBQUcsV0FBVyxDQUFDLGFBQWEsQ0FBQSJ9

dist/smartfile.classes.smartfile.d.ts

@@ -0,0 +1,3 @@
+export declare class Smartfile {
+    constructor();
+}

dist/smartfile.classes.smartfile.js

@@ -0,0 +1,7 @@
+"use strict";
+class Smartfile {
+    constructor() {
+    }
+}
+exports.Smartfile = Smartfile;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic21hcnRmaWxlLmNsYXNzZXMuc21hcnRmaWxlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvc21hcnRmaWxlLmNsYXNzZXMuc21hcnRmaWxlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7QUFBQTtJQUNJO0lBRUEsQ0FBQztDQUNKO0FBSkQsOEJBSUMifQ==

dist/smartfile.fs.d.ts

@@ -0,0 +1,142 @@
+import 'typings-global';
+/**
+ *
+ * @param filePath
+ * @returns {boolean}
+ */
+export declare let fileExistsSync: (filePath: any) => boolean;
+/**
+ *
+ * @param filePath
+ * @returns {any}
+ */
+export declare let fileExists: (filePath: any) => Promise<{}>;
+/**
+ * Checks if given path points to an existing directory
+ */
+export declare let isDirectory: (pathArg: any) => boolean;
+/**
+ * Checks if a given path points to an existing file
+ */
+export declare let isFile: (pathArg: any) => boolean;
+/**
+ * copies a file from A to B on the local disk
+ */
+export declare let copy: (fromArg: string, toArg: string) => Promise<{}>;
+/**
+ * copies a file SYNCHRONOUSLY from A to B on the local disk
+ */
+export declare let copySync: (fromArg: string, toArg: string) => boolean;
+/**
+ * ensures that a directory is in place
+ */
+export declare let ensureDir: (dirPathArg: string) => Promise<{}>;
+/**
+ * ensures that a directory is in place
+ */
+export declare let ensureDirSync: (dirPathArg: string) => void;
+/**
+ * ensure an empty directory
+ * @executes ASYNC
+ */
+export declare let ensureEmptyDir: (dirPathArg: string) => Promise<{}>;
+/**
+ * ensure an empty directory
+ * @executes SYNC
+ */
+export declare let ensureEmptyDirSync: (dirPathArg: string) => void;
+/**
+ * ensures that a file is on disk
+ * @param filePath the filePath to ensureDir
+ * @param the fileContent to place into a new file in case it doesn't exist yet
+ * @returns Promise<void>
+ * @exec ASYNC
+ */
+export declare let ensureFile: (filePathArg: any, initFileStringArg: any) => Promise<void>;
+/**
+ * ensures that a file is on disk
+ * @param filePath the filePath to ensureDir
+ * @param the fileContent to place into a new file in case it doesn't exist yet
+ * @returns Promise<void>
+ * @exec SYNC
+ */
+export declare let ensureFileSync: (filePathArg: string, initFileStringArg: string) => void;
+/**
+ * removes a file or folder from local disk
+ */
+export declare let remove: (pathArg: string) => Promise<void>;
+/**
+ * removes a file SYNCHRONOUSLY from local disk
+ */
+export declare let removeSync: (pathArg: string) => boolean;
+/**
+ * removes an array of filePaths from disk
+ */
+export declare let removeMany: (filePathArrayArg: string[]) => Promise<void[]>;
+/**
+ * like removeFilePathArray but SYNCHRONOUSLY
+ */
+export declare let removeManySync: (filePathArrayArg: string[]) => void;
+/**
+ *
+ * @param filePathArg
+ * @param fileTypeArg
+ * @returns {any}
+ */
+export declare let toObjectSync: (filePathArg: any, fileTypeArg?: any) => any;
+/**
+ * reads a file content to a String
+ * @param filePath
+ * @returns {string|Buffer|any}
+ */
+export declare let toStringSync: (filePath: any) => any;
+/**
+ *
+ * @param filePathArg
+ * @param options
+ * @returns {number}
+ */
+export declare let toVinylSync: (filePathArg: any, options?: {}) => any;
+/**
+ * lets you reload files hot.
+ * @param path
+ * @returns {any}
+ */
+export declare let requireReload: (path: string) => any;
+/**
+ * lists Folders in a directory on local disk
+ * @returns Promise
+ */
+export declare let listFolders: (pathArg: string, regexFilter?: RegExp) => Promise<{}>;
+/**
+ * lists Folders SYNCHRONOUSLY in a directory on local disk
+ * @returns an array with the folder names as strings
+ */
+export declare let listFoldersSync: (pathArg: string, regexFilter?: RegExp) => string[];
+/**
+ * lists Files in a directory on local disk
+ * @returns Promise
+ */
+export declare let listFiles: (pathArg: string, regexFilter?: RegExp) => Promise<{}>;
+/**
+ * lists Files SYNCHRONOUSLY in a directory on local disk
+ * @returns an array with the folder names as strings
+ */
+export declare let listFilesSync: (pathArg: string, regexFilter?: RegExp) => string[];
+/**
+ * lists all items (folders AND files) in a directory on local disk
+ * @returns Promise<string[]>
+ */
+export declare let listAllItems: (pathArg: string, regexFilter?: RegExp) => Promise<string[]>;
+/**
+ * lists all items (folders AND files) in a directory on local disk
+ * @returns an array with the folder names as strings
+ * @executes SYNC
+ */
+export declare let listAllItemsSync: (pathArg: string, regexFilter?: RegExp) => string[];
+/**
+ * lists a file tree using a miniMatch filter
+ * note: if the miniMatch Filter is an absolute path, the cwdArg will be omitted
+ * @returns Promise<string[]> string array with the absolute paths of all matching files
+ */
+export declare let listFileTree: (dirPathArg: string, miniMatchFilter: string) => Promise<string[]>;

dist/smartfile.interpreter.d.ts

@@ -0,0 +1,3 @@
+import 'typings-global';
+export declare let filetype: (pathArg: string) => string;
+export declare let objectFile: (fileStringArg: string, fileTypeArg: any) => any;

dist/smartfile.interpreter.js

@@ -0,0 +1,21 @@
+"use strict";
+require("typings-global");
+const plugins = require("./smartfile.plugins");
+exports.filetype = (pathArg) => {
+    let extName = plugins.path.extname(pathArg);
+    let fileType = extName.replace(/\.([a-z]*)/, '$1'); // remove . form fileType
+    return fileType;
+};
+exports.objectFile = (fileStringArg, fileTypeArg) => {
+    switch (fileTypeArg) {
+        case 'yml':
+        case 'yaml':
+            return plugins.yaml.safeLoad(fileStringArg);
+        case 'json':
+            return JSON.parse(fileStringArg);
+        default:
+            plugins.beautylog.error('file type ' + fileTypeArg.blue + ' not supported');
+            break;
+    }
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic21hcnRmaWxlLmludGVycHJldGVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvc21hcnRmaWxlLmludGVycHJldGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7QUFBQSwwQkFBdUI7QUFFdkIsK0NBQStDO0FBRXBDLFFBQUEsUUFBUSxHQUFHLENBQUMsT0FBZTtJQUNsQyxJQUFJLE9BQU8sR0FBRyxPQUFPLENBQUMsSUFBSSxDQUFDLE9BQU8sQ0FBQyxPQUFPLENBQUMsQ0FBQTtJQUMzQyxJQUFJLFFBQVEsR0FBRyxPQUFPLENBQUMsT0FBTyxDQUFDLFlBQVksRUFBQyxJQUFJLENBQUMsQ0FBQSxDQUFDLHlCQUF5QjtJQUMzRSxNQUFNLENBQUMsUUFBUSxDQUFBO0FBQ25CLENBQUMsQ0FBQTtBQUVVLFFBQUEsVUFBVSxHQUFHLENBQUMsYUFBcUIsRUFBRSxXQUFXO0lBQ3ZELE1BQU0sQ0FBQyxDQUFDLFdBQVcsQ0FBQyxDQUFDLENBQUM7UUFDbEIsS0FBSyxLQUFLLENBQUU7UUFDWixLQUFLLE1BQU07WUFDUCxNQUFNLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxRQUFRLENBQUMsYUFBYSxDQUFDLENBQUE7UUFDL0MsS0FBSyxNQUFNO1lBQ1AsTUFBTSxDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsYUFBYSxDQUFDLENBQUE7UUFDcEM7WUFDSSxPQUFPLENBQUMsU0FBUyxDQUFDLEtBQUssQ0FBQyxZQUFZLEdBQUcsV0FBVyxDQUFDLElBQUksR0FBRyxnQkFBZ0IsQ0FBQyxDQUFBO1lBQzNFLEtBQUssQ0FBQTtJQUNiLENBQUM7QUFDTCxDQUFDLENBQUEifQ==

dist/smartfile.memory.d.ts

@@ -0,0 +1,54 @@
+/// <reference types="node" />
+import 'typings-global';
+export interface IVinylFile {
+    contents: Buffer;
+    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
+ * @param fileTypeArg
+ * @returns {any|any}
+ */
+export declare let toObject: (fileStringArg: string, fileTypeArg: string) => any;
+/**
+ * takes a string and converts it to vinyl file
+ * @param fileArg
+ * @param optionsArg
+ */
+export declare let toVinylFileSync: (fileArg: string, optionsArg?: {
+    filename?: string;
+    base?: string;
+    relPath?: string;
+}) => any;
+/**
+ * takes a string array and some options and returns a vinylfile array
+ * @param arrayArg
+ * @param optionsArg
+ */
+export declare let toVinylArraySync: (arrayArg: string[], optionsArg?: {
+    filename?: string;
+    base?: string;
+    relPath?: string;
+}) => any[];
+/**
+ * takes a vinylFile object and converts it to String
+ */
+export declare let vinylToStringSync: (fileArg: IVinylFile) => string;
+/**
+ * writes string or vinyl file to disk.
+ * @param fileArg
+ * @param fileNameArg
+ * @param fileBaseArg
+ */
+export declare let toFs: (fileContentArg: string | IVinylFile, filePathArg: any) => Promise<{}>;
+export declare let toFsSync: (fileArg: any, filePathArg: string) => void;

dist/smartfile.plugins.d.ts

@@ -0,0 +1,12 @@
+import 'typings-global';
+export import beautylog = require('beautylog');
+export import fs = require('fs');
+export import fsExtra = require('fs-extra');
+export declare let glob: any;
+export import path = require('path');
+export import q = require('smartq');
+export declare let request: any;
+export declare let requireReload: any;
+export import smartpath = require('smartpath');
+export declare let vinylFile: any;
+export declare let yaml: any;

dist/smartfile.plugins.js

@@ -0,0 +1,14 @@
+"use strict";
+require("typings-global");
+exports.beautylog = require("beautylog");
+exports.fs = require("fs");
+exports.fsExtra = require("fs-extra");
+exports.glob = require('glob');
+exports.path = require("path");
+exports.q = require("smartq");
+exports.request = require('request');
+exports.requireReload = require('require-reload');
+exports.smartpath = require("smartpath");
+exports.vinylFile = require('vinyl-file');
+exports.yaml = require('js-yaml');
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic21hcnRmaWxlLnBsdWdpbnMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9zbWFydGZpbGUucGx1Z2lucy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUEsMEJBQXVCO0FBQ3ZCLHlDQUE4QztBQUM5QywyQkFBZ0M7QUFDaEMsc0NBQTJDO0FBQ2hDLFFBQUEsSUFBSSxHQUFHLE9BQU8sQ0FBQyxNQUFNLENBQUMsQ0FBQTtBQUNqQywrQkFBb0M7QUFDcEMsOEJBQW1DO0FBQ3hCLFFBQUEsT0FBTyxHQUFHLE9BQU8sQ0FBQyxTQUFTLENBQUMsQ0FBQTtBQUM1QixRQUFBLGFBQWEsR0FBRyxPQUFPLENBQUMsZ0JBQWdCLENBQUMsQ0FBQTtBQUNwRCx5Q0FBOEM7QUFDbkMsUUFBQSxTQUFTLEdBQUcsT0FBTyxDQUFDLFlBQVksQ0FBQyxDQUFBO0FBQ2pDLFFBQUEsSUFBSSxHQUFHLE9BQU8sQ0FBQyxTQUFTLENBQUMsQ0FBQSJ9

dist/smartfile.remote.d.ts

@@ -0,0 +1,14 @@
+import 'typings-global';
+export declare let toFs: (from: string, toPath: string) => Promise<{}>;
+/**
+ *
+ * @param fromArg
+ * @returns {any}
+ */
+export declare let toObject: (fromArg: string) => Promise<{}>;
+/**
+ *
+ * @param fromArg
+ * @returns {any}
+ */
+export declare let toString: (fromArg: string) => Promise<{}>;

dist/smartfile.remote.js

@@ -0,0 +1,53 @@
+"use strict";
+require("typings-global");
+const plugins = require("./smartfile.plugins");
+const SmartfileInterpreter = require("./smartfile.interpreter");
+exports.toFs = function (from, toPath) {
+    let done = plugins.q.defer();
+    let stream = plugins.request(from).pipe(plugins.fsExtra.createWriteStream(toPath));
+    stream.on('finish', function () {
+        done.resolve(toPath);
+    });
+    return done.promise;
+};
+/**
+ *
+ * @param fromArg
+ * @returns {any}
+ */
+exports.toObject = function (fromArg) {
+    let done = plugins.q.defer();
+    plugins.request.get(fromArg, function (error, response, bodyString) {
+        let returnObject;
+        if (!error && response.statusCode === 200) {
+            returnObject = SmartfileInterpreter.objectFile(bodyString, SmartfileInterpreter.filetype(fromArg));
+            done.resolve(returnObject);
+        }
+        else {
+            console.log('could not get remote file from ' + fromArg);
+            returnObject = undefined;
+            done.reject(returnObject);
+        }
+    });
+    return done.promise;
+};
+/**
+ *
+ * @param fromArg
+ * @returns {any}
+ */
+exports.toString = (fromArg) => {
+    let done = plugins.q.defer();
+    plugins.request.get(fromArg, function (error, response, bodyString) {
+        if (!error && response.statusCode === 200) {
+            done.resolve(bodyString);
+        }
+        else {
+            plugins.beautylog.error('could not get remote file from ' + fromArg);
+            bodyString = undefined;
+            done.reject(bodyString);
+        }
+    });
+    return done.promise;
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic21hcnRmaWxlLnJlbW90ZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL3NtYXJ0ZmlsZS5yZW1vdGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBLDBCQUF1QjtBQUN2QiwrQ0FBK0M7QUFDL0MsZ0VBQWdFO0FBRXJELFFBQUEsSUFBSSxHQUFHLFVBQVMsSUFBWSxFQUFDLE1BQWM7SUFDbEQsSUFBSSxJQUFJLEdBQUcsT0FBTyxDQUFDLENBQUMsQ0FBQyxLQUFLLEVBQUUsQ0FBQTtJQUM1QixJQUFJLE1BQU0sR0FBRyxPQUFPLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDLElBQUksQ0FBQyxPQUFPLENBQUMsT0FBTyxDQUFDLGlCQUFpQixDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUE7SUFDbEYsTUFBTSxDQUFDLEVBQUUsQ0FBQyxRQUFRLEVBQUM7UUFDZixJQUFJLENBQUMsT0FBTyxDQUFDLE1BQU0sQ0FBQyxDQUFBO0lBQ3hCLENBQUMsQ0FBQyxDQUFBO0lBQ0YsTUFBTSxDQUFDLElBQUksQ0FBQyxPQUFPLENBQUE7QUFDdkIsQ0FBQyxDQUFBO0FBRUQ7Ozs7R0FJRztBQUNRLFFBQUEsUUFBUSxHQUFHLFVBQVMsT0FBZTtJQUMxQyxJQUFJLElBQUksR0FBRyxPQUFPLENBQUMsQ0FBQyxDQUFDLEtBQUssRUFBRSxDQUFBO0lBQzVCLE9BQU8sQ0FBQyxPQUFPLENBQUMsR0FBRyxDQUFDLE9BQU8sRUFBRSxVQUFVLEtBQUssRUFBRSxRQUFRLEVBQUUsVUFBVTtRQUM5RCxJQUFJLFlBQVksQ0FBQTtRQUNoQixFQUFFLENBQUMsQ0FBQyxDQUFDLEtBQUssSUFBSSxRQUFRLENBQUMsVUFBVSxLQUFLLEdBQUcsQ0FBQyxDQUFDLENBQUM7WUFDeEMsWUFBWSxHQUFHLG9CQUFvQixDQUFDLFVBQVUsQ0FBQyxVQUFVLEVBQUMsb0JBQW9CLENBQUMsUUFBUSxDQUFDLE9BQU8sQ0FBQyxDQUFDLENBQUE7WUFDakcsSUFBSSxDQUFDLE9BQU8sQ0FBQyxZQUFZLENBQUMsQ0FBQTtRQUM5QixDQUFDO1FBQUMsSUFBSSxDQUFDLENBQUM7WUFDSixPQUFPLENBQUMsR0FBRyxDQUFDLGlDQUFpQyxHQUFHLE9BQU8sQ0FBQyxDQUFBO1lBQ3hELFlBQVksR0FBRyxTQUFTLENBQUE7WUFDeEIsSUFBSSxDQUFDLE1BQU0sQ0FBQyxZQUFZLENBQUMsQ0FBQTtRQUM3QixDQUFDO0lBQ0wsQ0FBQyxDQUFDLENBQUE7SUFDRixNQUFNLENBQUMsSUFBSSxDQUFDLE9BQU8sQ0FBQTtBQUN2QixDQUFDLENBQUE7QUFFRDs7OztHQUlHO0FBQ1EsUUFBQSxRQUFRLEdBQUcsQ0FBQyxPQUFlO0lBQ2xDLElBQUksSUFBSSxHQUFHLE9BQU8sQ0FBQyxDQUFDLENBQUMsS0FBSyxFQUFFLENBQUE7SUFDNUIsT0FBTyxDQUFDLE9BQU8sQ0FBQyxHQUFHLENBQUMsT0FBTyxFQUFFLFVBQVUsS0FBSyxFQUFFLFFBQVEsRUFBRSxVQUFVO1FBQzlELEVBQUUsQ0FBQyxDQUFDLENBQUMsS0FBSyxJQUFJLFFBQVEsQ0FBQyxVQUFVLEtBQUssR0FBRyxDQUFDLENBQUMsQ0FBQztZQUN4QyxJQUFJLENBQUMsT0FBTyxDQUFDLFVBQVUsQ0FBQyxDQUFBO1FBQzVCLENBQUM7UUFBQyxJQUFJLENBQUMsQ0FBQztZQUNKLE9BQU8sQ0FBQyxTQUFTLENBQUMsS0FBSyxDQUFDLGlDQUFpQyxHQUFHLE9BQU8sQ0FBQyxDQUFBO1lBQ3BFLFVBQVUsR0FBRyxTQUFTLENBQUE7WUFDdEIsSUFBSSxDQUFDLE1BQU0sQ0FBQyxVQUFVLENBQUMsQ0FBQTtRQUMzQixDQUFDO0lBQ0wsQ0FBQyxDQUFDLENBQUE7SUFDRixNQUFNLENBQUMsSUFBSSxDQUFDLE9BQU8sQ0FBQTtBQUN2QixDQUFDLENBQUEifQ==

index.js

@@ -1,10 +0,0 @@
-/// <reference path="typings/tsd.d.ts" />
-var through = require("through2");
-var path = require("path");
-module.exports = function (jadeTemplate, mojo) {
-    if (mojo === void 0) { mojo = undefined; }
-    return through.obj(function (file, enc, cb) {
-        //run callback function to signal end of plugin process.
-        return cb(null, file);
-    });
-};

npmextra.json

@@ -0,0 +1,9 @@
+{
+  "npmts":{
+    "mode":"default",
+    "coverageTreshold":70
+  },
+  "npmdocker":{
+    
+  }
+}

package.json

@@ -1,17 +1,19 @@
 {
   "name": "smartfile",
-  "version": "0.0.2",
+  "version": "4.1.3",
   "description": "offers smart ways to work with files in nodejs",
-  "main": "index.js",
+  "main": "dist/index.js",
+  "typings": "dist/index.d.ts",
   "scripts": {
-    "test": "(cd ts/compile && node compile.js)",
+    "test": "(npmts)",
     "reinstall": "(rm -r node_modules && npm install)",
     "release": "(git pull origin master && npm version patch && git push origin master && git checkout release && git merge master && git push origin release && git checkout master)",
-    "startdev": "(git checkout master && git pull origin master)"
+    "update": "(git checkout master && git pull origin master && npm install)",
+    "upgrade": "(npm run update) && (ncu upgradeAll && npm install)"
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/pushrocks/smartfile.git"
+    "url": "https://gitlab.com/pushrocks/smartfile.git"
   },
   "keywords": [
     "filesystem",
@@ -20,14 +22,28 @@
   "author": "Smart Coordination GmbH <office@push.rocks> (https://push.rocks)",
   "license": "MIT",
   "bugs": {
-    "url": "https://github.com/pushrocks/smartfile/issues"
+    "url": "https://gitlab.com/pushrocks/smartfile/issues"
   },
-  "homepage": "https://github.com/pushrocks/smartfile",
+  "homepage": "https://gitlab.com/pushrocks/smartfile",
   "dependencies": {
-    "pushrocks": "^1.0.18"
+    "@types/fs-extra": "0.x.x",
+    "@types/vinyl": "^2.0.0",
+    "beautylog": "^6.0.0",
+    "fs-extra": "^2.0.0",
+    "glob": "^7.1.1",
+    "js-yaml": "^3.7.0",
+    "request": "^2.79.0",
+    "require-reload": "0.2.2",
+    "smartpath": "^3.2.7",
+    "smartq": "^1.0.4",
+    "typings-global": "^1.0.14",
+    "vinyl": "^2.0.1",
+    "vinyl-file": "^3.0.0"
   },
   "devDependencies": {
-    "gulp": "3.9.0",
-    "gulp-typescript": "2.9.2"
+    "gulp-function": "^2.2.3",
+    "npmts-g": "^6.0.0",
+    "smartchai": "^1.0.1",
+    "typings-test": "^1.0.3"
   }
 }

test/mytest.json

@@ -0,0 +1,8 @@
+{
+  "key1": "this works",
+  "key2": "this works too",
+  "key3": {
+    "nestedkey1": "hello"
+  }
+}
+

test/mytest.txt

@@ -0,0 +1 @@
+Some TestString &&%$

test/mytest.yaml

@@ -0,0 +1,4 @@
+key1: this works
+key2: this works too
+key3:
+  nestedkey1: hello

test/test.d.ts

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

test/test.ts

@@ -0,0 +1,228 @@
+import 'typings-test'
+import * as smartfile from '../dist/index'
+import beautylog = require('beautylog')
+import path = require('path')
+
+import { expect } from 'smartchai'
+
+import * as vinyl from 'vinyl'
+
+describe('smartfile', function () {
+    describe('.fs', function () {
+        describe('.fileExistsSync', function () {
+            it('should return an accurate boolean', function () {
+                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 () {
+                expect(smartfile.fs.fileExists('./test/mytest.json')).to.be.a('promise')
+                expect(smartfile.fs.fileExists('./test/mytest.json')).to.be.fulfilled
+                expect(smartfile.fs.fileExists('./test/notthere.json')).to.not.be.fulfilled
+            })
+        })
+        describe('.listFoldersSync()', function () {
+            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.not.deep.include('notExistentFolder')
+            })
+        })
+        describe('.listFolders()', function () {
+            it('should get the file type from a string', function (done) {
+                smartfile.fs.listFolders('./test/')
+                    .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('.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 () {
+                
+            })
+            it('smartfile.fs.remove -> should remove single files', function (done) {
+                smartfile.fs.remove('./test/temp/mytestRenamed.yaml')
+                    .then(() => { done() })
+            })
+            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 () {
+        describe('.filetype()', function () {
+            it('should get the file type from a string', function () {
+                expect(smartfile.interpreter.filetype('./somefolder/data.json')).equal('json')
+            })
+        })
+    })
+
+    describe('.fs', function () {
+        describe('.toObjectSync()', function () {
+            it('should read an ' + '.yaml' + ' file to an object', function () {
+                let testData = smartfile.fs.toObjectSync('./test/mytest.yaml')
+                expect(testData).have.property('key1', 'this works')
+                expect(testData).have.property('key2', 'this works too')
+
+            })
+            it('should state unknown file type for unknown file types', function () {
+                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')
+
+            })
+        })
+        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 () {
+        describe('.toGulpStream()', function () {
+            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 () {
+        describe('.toString()', function () {
+            it('should load a remote file to a variable', function (done) {
+                this.timeout(5000)
+                smartfile.remote.toString(
+                    'https://raw.githubusercontent.com/pushrocks/smartfile/master/test/mytest.txt'
+                ).then(function (responseString) {
+                    expect(responseString).to.equal('Some TestString &&%$')
+                    done()
+                })
+            })
+            it('should reject a Promise when the link is false', function (done) {
+                this.timeout(10000)
+                smartfile.remote.toString('https://push.rocks/doesnotexist.txt')
+                    .then(
+                        function () {
+                            throw new Error('this test should not be resolved')
+                        },
+                        function () {
+                            done()
+                        }
+                    )
+            })
+        })
+    })
+})

ts/compile/compile.js

@@ -1,21 +0,0 @@
-// import gulp
-var gulp = require("gulp")
-var gulpTypescript = require("gulp-typescript");
-var pr = require("pushrocks");
-
-gulp.task('compileTS', function() {
-	var stream = gulp.src('../index.ts')
-	  .pipe(gulpTypescript({
-	  	out: "index.js"
-	  }))
-	  .pipe(gulp.dest("../../"));
-	return stream;
-});
-
-gulp.task('default',['compileTS'], function() {
-	pr.beautylog.success('Typescript compiled');
-});
-
-//lets tell gulp to start with the default task.
-pr.beautylog.log('Starting Gulp to compile TypeScript');
-gulp.start.apply(gulp, ['default']);

ts/compile/readme.md

@@ -1,2 +0,0 @@
-# How to compile.
-Make sure gulp and gulp-taypescript from npm are available. Then run the gulpfile in this directory.

ts/index.ts

@@ -1,12 +1,15 @@
-/// <reference path="typings/tsd.d.ts" />
-var through = require("through2");
-var path = require("path");
+import 'typings-global'
 
-module.exports = (jadeTemplate,mojo = undefined) => {
+import * as plugins from './smartfile.plugins'
+import * as SmartfileFs from './smartfile.fs'
+import * as SmartfileInterpreter from './smartfile.interpreter'
+import * as SmartfileMemory from './smartfile.memory'
+import * as SmartfileRemote from './smartfile.remote'
 
-    return through.obj((file, enc, cb) => {
-        
-        //run callback function to signal end of plugin process.
-        return cb(null, file);
-    });
-};
+export {Smartfile} from './smartfile.classes.smartfile'
+
+export let fs = SmartfileFs
+export let interpreter = SmartfileInterpreter
+export let memory = SmartfileMemory
+export let remote = SmartfileRemote
+export let requireReload = SmartfileFs.requireReload

ts/smartfile.classes.smartfile.ts

@@ -0,0 +1,5 @@
+export class Smartfile {
+    constructor() {
+
+    }
+}

ts/smartfile.fs.ts

@@ -0,0 +1,356 @@
+import 'typings-global'
+
+import plugins = require('./smartfile.plugins')
+import SmartfileInterpreter = require('./smartfile.interpreter')
+import * as memory from './smartfile.memory'
+/*===============================================================
+============================ Checks =============================
+===============================================================*/
+
+/**
+ *
+ * @param filePath
+ * @returns {boolean}
+ */
+export let fileExistsSync = function(filePath): boolean {
+    let fileExistsBool: boolean = false
+    try {
+        plugins.fsExtra.readFileSync(filePath)
+        fileExistsBool = true
+    } catch (err) {
+        fileExistsBool = false
+    }
+    return fileExistsBool
+}
+
+/**
+ *
+ * @param filePath
+ * @returns {any}
+ */
+export let fileExists = function(filePath){
+    let done = plugins.q.defer()
+    plugins.fs.access(filePath, 4, function (err) {
+        err ? done.reject(err) : done.resolve()
+    })
+    return done.promise
+}
+
+/**
+ * Checks if given path points to an existing directory
+ */
+export let isDirectory = function(pathArg): boolean{
+    return plugins.fsExtra.statSync(pathArg).isDirectory()
+}
+
+/**
+ * Checks if a given path points to an existing file
+ */
+export let isFile = function(pathArg): boolean{
+    return plugins.fsExtra.statSync(pathArg).isFile()
+}
+
+/*===============================================================
+============================ FS ACTIONS =========================
+===============================================================*/
+
+/**
+ * copies a file from A to B on the local disk
+ */
+export let copy = function(fromArg: string, toArg: string){
+    let done = plugins.q.defer()
+    plugins.fsExtra.copy(fromArg,toArg,{},function(){
+        done.resolve()
+    })
+    return done.promise
+}
+
+/**
+ * copies a file SYNCHRONOUSLY from A to B on the local disk
+ */
+export let copySync = function(fromArg: string,toArg: string): boolean{
+    plugins.fsExtra.copySync(fromArg,toArg)
+    return true
+}
+
+/**
+ * ensures that a directory is in place
+ */
+export let ensureDir = (dirPathArg: string) => {
+    let done = plugins.q.defer()
+    plugins.fsExtra.ensureDir(dirPathArg,done.resolve)
+    return done.promise
+}
+
+/**
+ * ensures that a directory is in place
+ */
+export let ensureDirSync = (dirPathArg: string) => {
+    plugins.fsExtra.ensureDirSync(dirPathArg)
+}
+
+/**
+ * ensure an empty directory
+ * @executes ASYNC
+ */
+export let ensureEmptyDir = (dirPathArg: string) => {
+    let done = plugins.q.defer()
+    plugins.fsExtra.ensureDir(dirPathArg,() => {
+        plugins.fsExtra.emptyDir(dirPathArg, done.resolve)
+    })
+    return done.promise
+}
+
+/**
+ * ensure an empty directory
+ * @executes SYNC
+ */
+export let ensureEmptyDirSync = (dirPathArg: string) => {
+    plugins.fsExtra.ensureDirSync(dirPathArg)
+    plugins.fsExtra.emptyDirSync(dirPathArg)
+}
+
+/**
+ * ensures that a file is on disk
+ * @param filePath the filePath to ensureDir
+ * @param the fileContent to place into a new file in case it doesn't exist yet
+ * @returns Promise<void>
+ * @exec ASYNC
+ */
+export let ensureFile = (filePathArg, initFileStringArg): Promise<void> => {
+    let done = plugins.q.defer<void>()
+    ensureFileSync(filePathArg, initFileStringArg)
+    done.resolve()
+    return done.promise
+}
+
+/**
+ * ensures that a file is on disk
+ * @param filePath the filePath to ensureDir
+ * @param the fileContent to place into a new file in case it doesn't exist yet
+ * @returns Promise<void>
+ * @exec SYNC
+ */
+export let ensureFileSync = (filePathArg: string, initFileStringArg: string): void => {
+    if (fileExistsSync(filePathArg)) {
+        return null
+    } else {
+        memory.toFsSync(initFileStringArg, filePathArg)
+    }
+}
+
+/**
+ * removes a file or folder from local disk
+ */
+export let remove = function(pathArg: string): Promise<void> {
+    let done = plugins.q.defer<void>()
+    plugins.fsExtra.remove(pathArg,function(){
+        done.resolve()
+    })
+    return done.promise
+}
+
+/**
+ * removes a file SYNCHRONOUSLY from local disk
+ */
+export let removeSync = function(pathArg: string): boolean{
+    plugins.fsExtra.removeSync(pathArg)
+    return true
+}
+
+/**
+ * removes an array of filePaths from disk
+ */
+export let removeMany = function(filePathArrayArg: string[]){
+    let promiseArray: Promise<void>[] = []
+    for (let filePath of filePathArrayArg) {
+        promiseArray.push(remove(filePath))
+    }
+    return Promise.all(promiseArray)
+}
+
+/**
+ * like removeFilePathArray but SYNCHRONOUSLY
+ */
+export let removeManySync = function(filePathArrayArg: string[]): void {
+    for (let filePath of filePathArrayArg) {
+        removeSync(filePath)
+    }
+}
+
+/*===============================================================
+============================ Write/Read =========================
+===============================================================*/
+
+/**
+ *
+ * @param filePathArg
+ * @param fileTypeArg
+ * @returns {any}
+ */
+export let toObjectSync = function(filePathArg,fileTypeArg?) {
+    let fileString = plugins.fsExtra.readFileSync(filePathArg, 'utf8')
+    let fileType
+    fileTypeArg ? fileType = fileTypeArg : fileType = SmartfileInterpreter.filetype(filePathArg)
+    return SmartfileInterpreter.objectFile(fileString,fileType)
+}
+
+/**
+ * reads a file content to a String
+ * @param filePath
+ * @returns {string|Buffer|any}
+ */
+export let toStringSync = function(filePath) {
+    let fileString
+    fileString = plugins.fsExtra.readFileSync(filePath, 'utf8')
+    return fileString
+}
+
+/**
+ *
+ * @param filePathArg
+ * @param options
+ * @returns {number}
+ */
+export let toVinylSync = function(filePathArg,options = {}) {
+    return plugins.vinylFile.readSync(filePathArg,options)
+}
+
+/**
+ * lets you reload files hot.
+ * @param path
+ * @returns {any}
+ */
+export let requireReload = function(path: string){
+    return plugins.requireReload(path)
+}
+
+/**
+ * lists Folders in a directory on local disk
+ * @returns Promise
+ */
+export let listFolders = function(pathArg: string,regexFilter?: RegExp){
+    let done = plugins.q.defer()
+    let folderArray = plugins.fsExtra.readdirSync(pathArg).filter(function(file) {
+        return plugins.fsExtra.statSync(plugins.path.join(pathArg, file)).isDirectory()
+    })
+    if (regexFilter) {
+        folderArray = folderArray.filter((fileItem) => {
+            return regexFilter.test(fileItem)
+        })
+    }
+    done.resolve(folderArray)
+    return done.promise
+}
+
+/**
+ * lists Folders SYNCHRONOUSLY in a directory on local disk
+ * @returns an array with the folder names as strings
+ */
+export let listFoldersSync = function(pathArg: string,regexFilter?: RegExp): string[]{
+    let folderArray = plugins.fsExtra.readdirSync(pathArg).filter(function(file) {
+        return plugins.fsExtra.statSync(plugins.path.join(pathArg, file)).isDirectory()
+    })
+    if (regexFilter) {
+        folderArray = folderArray.filter((fileItem) => {
+            return regexFilter.test(fileItem)
+        })
+    }
+    return folderArray
+}
+
+/**
+ * lists Files in a directory on local disk
+ * @returns Promise
+ */
+export let listFiles = function(pathArg: string, regexFilter?: RegExp){
+    let done = plugins.q.defer()
+    let fileArray = plugins.fsExtra.readdirSync(pathArg).filter(function(file) {
+        return plugins.fsExtra.statSync(plugins.path.join(pathArg, file)).isFile()
+    })
+    if (regexFilter) {
+        fileArray = fileArray.filter((fileItem) => {
+            return regexFilter.test(fileItem)
+        })
+    }
+    done.resolve(fileArray)
+    return done.promise
+}
+
+/**
+ * lists Files SYNCHRONOUSLY in a directory on local disk
+ * @returns an array with the folder names as strings
+ */
+export let listFilesSync = function(pathArg: string, regexFilter?: RegExp): string[]{
+    let fileArray = plugins.fsExtra.readdirSync(pathArg).filter(function(file) {
+        return plugins.fsExtra.statSync(plugins.path.join(pathArg, file)).isFile()
+    })
+    if (regexFilter) {
+        fileArray = fileArray.filter((fileItem) => {
+            return regexFilter.test(fileItem)
+        })
+    }
+    return fileArray
+}
+
+/**
+ * lists all items (folders AND files) in a directory on local disk
+ * @returns Promise<string[]>
+ */
+export let listAllItems = function(pathArg: string, regexFilter?: RegExp): Promise<string[]> {
+    let done = plugins.q.defer<string[]>()
+    let allItmesArray = plugins.fsExtra.readdirSync(pathArg)
+    if (regexFilter) {
+        allItmesArray = allItmesArray.filter((fileItem) => {
+            return regexFilter.test(fileItem)
+        })
+    };
+    done.resolve(allItmesArray)
+    return done.promise
+}
+
+/**
+ * lists all items (folders AND files) in a directory on local disk
+ * @returns an array with the folder names as strings
+ * @executes SYNC
+ */
+export let listAllItemsSync = function(pathArg: string, regexFilter?: RegExp): string[]{
+    let allItmesArray = plugins.fsExtra.readdirSync(pathArg).filter(function(file) {
+        return plugins.fsExtra.statSync(plugins.path.join(pathArg, file)).isFile()
+    })
+    if (regexFilter) {
+        allItmesArray = allItmesArray.filter((fileItem) => {
+            return regexFilter.test(fileItem)
+        })
+    }
+    return allItmesArray
+}
+
+/**
+ * lists a file tree using a miniMatch filter
+ * note: if the miniMatch Filter is an absolute path, the cwdArg will be omitted
+ * @returns Promise<string[]> string array with the absolute paths of all matching files
+ */
+export let listFileTree = (dirPathArg: string, miniMatchFilter: string): Promise<string[]> => {
+    let done = plugins.q.defer<string[]>()
+
+    // handle absolute miniMatchFilter
+    let dirPath: string
+    if (plugins.path.isAbsolute(miniMatchFilter)) {
+        dirPath = '/'
+    } else {
+        dirPath = dirPathArg
+    }
+
+    let options = {
+        cwd: dirPath
+    }
+    plugins.glob(miniMatchFilter,options,(err,files: string[]) => {
+        if (err) {
+            console.log(err)
+            done.reject(err)
+        }
+        done.resolve(files)
+    })
+    return done.promise
+}

ts/smartfile.interpreter.ts

@@ -0,0 +1,22 @@
+import 'typings-global'
+
+import plugins = require('./smartfile.plugins')
+
+export let filetype = (pathArg: string): string => {
+    let extName = plugins.path.extname(pathArg)
+    let fileType = extName.replace(/\.([a-z]*)/,'$1') // remove . form fileType
+    return fileType
+}
+
+export let objectFile = (fileStringArg: string, fileTypeArg) => {
+    switch (fileTypeArg) {
+        case 'yml' :
+        case 'yaml':
+            return plugins.yaml.safeLoad(fileStringArg)
+        case 'json':
+            return JSON.parse(fileStringArg)
+        default:
+            plugins.beautylog.error('file type ' + fileTypeArg.blue + ' not supported')
+            break
+    }
+}

ts/smartfile.memory.ts

@@ -0,0 +1,150 @@
+import 'typings-global'
+
+import plugins = require('./smartfile.plugins')
+import SmartfileInterpreter = require('./smartfile.interpreter')
+let vinyl = require('vinyl')
+
+export interface IVinylFile {
+    contents: Buffer
+    base: 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
+}
+
+/**
+ * converts file to Object
+ * @param fileStringArg
+ * @param fileTypeArg
+ * @returns {any|any}
+ */
+export let toObject = function(fileStringArg: string,fileTypeArg: string){
+    return SmartfileInterpreter.objectFile(fileStringArg,fileTypeArg)
+}
+
+/**
+ * takes a string and converts it to vinyl file
+ * @param fileArg
+ * @param optionsArg
+ */
+export let toVinylFileSync = function(fileArg: string,optionsArg?: {filename?: string,base?: string,relPath?: string}) {
+    optionsArg ? void(0) : optionsArg = {filename: 'vinylfile', base: '/'}
+    optionsArg.filename ? void(0) : optionsArg.filename = 'vinylfile'
+    optionsArg.base ? void(0) : optionsArg.base = '/'
+    optionsArg.relPath ? void('0') : optionsArg.relPath = ''
+    let vinylFile = new vinyl({
+        base: optionsArg.base,
+        path: plugins.path.join(optionsArg.base,optionsArg.relPath,optionsArg.filename),
+        contents: new Buffer(fileArg)
+    })
+    return vinylFile
+}
+
+/**
+ * takes a string array and some options and returns a vinylfile array
+ * @param arrayArg
+ * @param optionsArg
+ */
+export let toVinylArraySync = function(
+    arrayArg: string[],
+    optionsArg?: {
+        filename?: string,
+        base?: string,
+        relPath?: string
+    }
+){
+    let vinylArray = []
+    for (let stringIndexArg in arrayArg) {
+        let myString = arrayArg[stringIndexArg]
+        vinylArray.push(toVinylFileSync(myString,optionsArg))
+    }
+    return vinylArray
+}
+
+/**
+ * takes a vinylFile object and converts it to String
+ */
+export let vinylToStringSync = function(fileArg: IVinylFile): string {
+    return fileArg.contents.toString('utf8')
+}
+
+/**
+ * writes string or vinyl file to disk.
+ * @param fileArg
+ * @param fileNameArg
+ * @param fileBaseArg
+ */
+export let toFs = function(fileContentArg: string|IVinylFile,filePathArg){
+    let done = plugins.q.defer()
+
+    // function checks to abort if needed
+    if (!fileContentArg || !filePathArg) {
+        throw new Error('expected valid arguments')
+    }
+
+    // prepare actual write action
+    let fileString: string
+    let filePath: string = filePathArg
+    if (vinyl.isVinyl(fileContentArg)) {
+        let fileContentArg2: any = fileContentArg
+        fileString = vinylToStringSync(fileContentArg2)
+    } else if (typeof fileContentArg === 'string') {
+        fileString = fileContentArg
+    }
+    plugins.fsExtra.writeFile(filePath,fileString,'utf8',done.resolve)
+    return done.promise
+}
+
+export let toFsSync = function(fileArg,filePathArg: string){
+    // function checks to abort if needed
+    if (!fileArg || !filePathArg) {
+        throw new Error('expected a valid arguments')
+    }
+
+    // prepare actual write action
+    let fileString: string
+    let filePath: string = filePathArg
+
+    if (typeof fileArg !== 'string') {
+        fileString = vinylToStringSync(fileArg)
+    } else if (typeof fileArg === 'string') {
+        fileString = fileArg
+    }
+    plugins.fsExtra.writeFileSync(filePath,fileString,'utf8')
+}

ts/smartfile.plugins.ts

@@ -0,0 +1,12 @@
+import 'typings-global'
+export import beautylog = require('beautylog')
+export import fs = require('fs')
+export import fsExtra = require('fs-extra')
+export let glob = require('glob')
+export import path = require('path')
+export import q = require('smartq')
+export let request = require('request')
+export let requireReload = require('require-reload')
+export import smartpath = require('smartpath')
+export let vinylFile = require('vinyl-file')
+export let yaml = require('js-yaml')

ts/smartfile.remote.ts

@@ -0,0 +1,52 @@
+import 'typings-global'
+import plugins = require('./smartfile.plugins')
+import SmartfileInterpreter = require('./smartfile.interpreter')
+
+export let toFs = function(from: string,toPath: string) {
+    let done = plugins.q.defer()
+    let stream = plugins.request(from).pipe(plugins.fsExtra.createWriteStream(toPath))
+    stream.on('finish',function(){
+        done.resolve(toPath)
+    })
+    return done.promise
+}
+
+/**
+ *
+ * @param fromArg
+ * @returns {any}
+ */
+export let toObject = function(fromArg: string){
+    let done = plugins.q.defer()
+    plugins.request.get(fromArg, function (error, response, bodyString) {
+        let returnObject
+        if (!error && response.statusCode === 200) {
+            returnObject = SmartfileInterpreter.objectFile(bodyString,SmartfileInterpreter.filetype(fromArg))
+            done.resolve(returnObject)
+        } else {
+            console.log('could not get remote file from ' + fromArg)
+            returnObject = undefined
+            done.reject(returnObject)
+        }
+    })
+    return done.promise
+}
+
+/**
+ *
+ * @param fromArg
+ * @returns {any}
+ */
+export let toString = (fromArg: string) => {
+    let done = plugins.q.defer()
+    plugins.request.get(fromArg, function (error, response, bodyString) {
+        if (!error && response.statusCode === 200) {
+            done.resolve(bodyString)
+        } else {
+            plugins.beautylog.error('could not get remote file from ' + fromArg)
+            bodyString = undefined
+            done.reject(bodyString)
+        }
+    })
+    return done.promise
+}

ts/tsd.json

@@ -1,12 +0,0 @@
-{
-  "version": "v4",
-  "repo": "borisyankov/DefinitelyTyped",
-  "ref": "master",
-  "path": "typings",
-  "bundle": "typings/tsd.d.ts",
-  "installed": {
-    "node/node.d.ts": {
-      "commit": "efa0c1196d7280640e624ac1e7fa604502e7bd63"
-    }
-  }
-}

ts/typings/tsd.d.ts

@@ -1 +0,0 @@
-/// <reference path="node/node.d.ts" />

tslint.json

@@ -0,0 +1,3 @@
+{
+    "extends": "tslint-config-standard"
+}