gina 0.0.9-p91c → 0.1.1-alpha.100

package/{core/utils → framework/v0.1.1-alpha.100}/helpers/path.js

@@ -1,12 +1,13 @@
 /*
  * This file is part of the gina package.
- * Copyright (c) 2016 Rhinostone <gina@rhinostone.com>
+ * Copyright (c) 2009-2022 Rhinostone <contact@gina.io>
  *
  * For the full copyright and license information, please view the LICENSE
  * file that was distributed with this source code.
  */
 
 var fs = require('fs');
+var util = require('util');
 var Events = require('events');
 var Path = require('path');
 
@@ -23,7 +24,7 @@ e.setMaxListeners(100);
  * PathHelper
  *
  * @package     Gina.Utils.Helpers
- * @author      Rhinzostone <gina@rhinostone.com>
+ * @author      Rhinzostone <contact@gina.io>
  * @api public
  *
  * TODO - Put debug logs
@@ -43,17 +44,24 @@ function PathHelper() {
      * @param {string} path - Path to convert
      * @param {boolean} [force] - Force conversion to match platform style (Only for string conversion)
      *
-     * @return {string|object} converted
+     * @returns {string|object} converted
      * */
 
     _ = function(path, force) {
+
+        if ( typeof(path) == 'undefined' || !path || path == '' || path.length <=2 ) {
+            throw new Error('This source cannot be used: `'+ path +'`')
+        }
+
         if ( typeof(force) == undefined) {
             force = _this.force = false
         }
+        // Attention : _('/my/path/../folder/file.ext') will output -> /my/folder/file.ext
         path = Path.normalize(path);
-        var isConstructor = false;
-        if (this instanceof _ // <- You could use arguments.callee instead of _ here,
-                // except in in EcmaScript 5 strict mode.
+        var isConstructor = false, p = null;
+        if (
+            this instanceof _ // <- You could use arguments.callee instead of _ here,
+            // except in in EcmaScript 5 strict mode.
             && !this.previouslyConstructedBy_) {
             isConstructor = true;
             this.previouslyConstructedBy_ = true
@@ -62,16 +70,13 @@ function PathHelper() {
         if ( typeof(path) != 'undefined' && path != '' ) {
 
             if (isConstructor) {
-                var self = _;
-
                 //console.debug("creating path record: ", path, isConstructor );
                 this.path = path;
                 if (process.platform == "win32") {
                     //In case of mixed slashes.
-                    //this.value = path.replace(/\//g, "\\");
                     this.value = path.replace(/\\/g, "/");// Make it unix like.
 
-                    var p = this.value;
+                    p = this.value;
 
                     this.isWindowsStyle = true;
                     this.key = path;
@@ -80,9 +85,9 @@ function PathHelper() {
                     }
                 } else {
                     //console.debug("linux style");
-                    //we don't want empty spaces..
+                    //we don't want empty spaces
                     this.value = path.replace(/\\/g, "/");
-                    var p = this.value;
+                    p = this.value;
                     //console.debug("path ", p);
                     this.key = path;
                     if (_this.paths.indexOf(path) < 0 ) {
@@ -112,18 +117,20 @@ function PathHelper() {
                         _this.paths.push(path)
                     }
                 }
+
                 return path
             }
         }
         return null
     };
 
+
     _.prototype.sep = Path.sep;
     _.prototype.start = (process.platform != "win32") ? "/" : "";
 
     /**
      * _.toString() Convert path object to string
-     * @return {String} path
+     * @returns {String} path
      *
      * Usage:
      * var myPathObj = new _("my/path/string");
@@ -140,7 +147,7 @@ function PathHelper() {
 
     /**
      * _.toArray() Convert path object to array
-     * @return {Array} path
+     * @returns {Array} path
      *
      * Usage:
      * var myPathObj = new _("my/path/string");
@@ -157,7 +164,7 @@ function PathHelper() {
         }
 
         arr.index = function(i) {
-            if ( typeof(arr[i]) != 'undefiend')
+            if ( typeof(arr[i]) != 'undefined' )
                 return arr[i];
             else
                 return undefined;
@@ -196,7 +203,7 @@ function PathHelper() {
         }
 
         arr.index = function(i) {
-            if ( typeof(arr[i]) != 'undefiend')
+            if ( typeof(arr[i]) != 'undefined')
                 return arr[i];
             else
                 return undefined;
@@ -219,14 +226,71 @@ function PathHelper() {
         return self
     }
 
+    var existsSync = function(value) {
+        if ( typeof(fs.accessSync) != 'undefined' ) {
+            try {
+                fs.accessSync(value, fs.constants.F_OK);
+                return true;
+            } catch (err) {
+                return false;
+            }
+        } else { // support for old version of nodejs
+            return fs.existsSync(value);
+        }
+    }
     _.prototype.existsSync = function() {
-        return fs.existsSync(this.value)
+        return existsSync(this.value);
     }
 
+    var exists = function(value, callback) {
+        if ( typeof(fs.access) != 'undefined' ) {
+            fs.access(value, fs.constants.F_OK, (err) => {
+                callback( (err) ? false: true )
+            });
+        } else { // support for old version of nodejs
+            fs.exists(value, function(found) {
+                callback(found)
+            })
+        }
+    }
     _.prototype.exists = function(callback) {
-        fs.exists(this.value, function(exists) {
-            callback(exists)
-        })
+        exists(this.value, callback);
+    }
+
+    _.prototype.isWritableSync = function() {
+
+        if ( typeof(fs.accessSync) != 'undefined' ) {
+            try {
+                fs.accessSync(this.value, fs.constants.W_OK);
+                return true
+            } catch (err) {
+                return false
+            }
+        } else { // support for old version of nodejs
+            var canWrite = false
+            try {
+                canWrite = (fs.statSync(this.value).mode & (fs.constants.S_IRUSR | fs.constants.S_IRGRP | fs.constants.S_IROTH));
+            } catch (err) {
+                canWrite = false
+            }
+            return canWrite
+        }
+    }
+
+    _.prototype.isWritable = function(callback) {
+        if ( typeof(fs.access) != 'undefined' ) {
+            fs.access(this.value, fs.constants.F_OK, (err) => {
+                callback( (err) ? false: true )
+            });
+        } else { // support for old version of nodejs
+            fs.stat(this.value, function(err, stats) {
+                var canWrite = false;
+                if (!err && stats.mode & (fs.constants.S_IRUSR | fs.constants.S_IRGRP | fs.constants.S_IROTH)) {
+                    canWrite = true;
+                }
+                callback( canWrite )
+            })
+        }
     }
 
     /**
@@ -264,20 +328,20 @@ function PathHelper() {
      *
      * @param {string} permission Folder permission
      * */
-    _.prototype.mkdirSync = function(permission) {
+    _.prototype.mkdirSync = function(permission, pathArr) {
 
-        if ( fs.existsSync(this.value) ) {
+        if ( existsSync(this.value) ) {
             return this // always return the instance for sync
         }
         cleanSlashes(this);
 
         //by default.
         if ( typeof(permission) == 'undefined' ) {
-            var permission = 0775
+            permission = 0775
         }
 
         if ( typeof(pathArr) == 'undefined' ) {
-            var pathArr = toArray(this)
+            pathArr = toArray(this)
         }
 
         try {
@@ -303,13 +367,13 @@ function PathHelper() {
         if (i+1 < pathArr.length) {
 
             if ( typeof(path) == 'undefined') {
-                var path =   self.start + pathArr[0]
+                path =   self.start + pathArr[0]
             } else {
                 ++i;
                 path += '/' + pathArr[i]
             }
 
-            if ( !fs.existsSync(path) ) {
+            if ( !existsSync(path) ) {
                 addFolder(self, permission, pathArr, i, path)
             } else {
                 mkdirSync(self, permission, pathArr, i, path)
@@ -327,15 +391,15 @@ function PathHelper() {
      * */
     _.prototype.mkdir = function(permission, callback) {
         if ( typeof(permission) == "function") {
-            var callback = permission;
-            var permission = 0775
+            callback = permission;
+            permission = 0775
         }
         var self = this;
         self = cleanSlashes(self);
 
         //Enter dir & start rm.
-        fs.exists(self.value, function(exists) {
-            if (exists) {
+        exists(self.value, function(found) {
+            if (found) {
                 callback(false, self.value)
             } else {
                 var p = self.value;
@@ -344,9 +408,7 @@ function PathHelper() {
                     .onComplete( function(err, path){
                         //Avoid collisions.
                         if (err) {
-                            console.error("Debug needed mkdir on existing folder !! ", err);
-                            // console.warn("MKDIR ERR: silently ignored.. ", path);
-                            //callback("MKDIR ERR: silently ignored.. ");
+                            console.crit("debug needed mkdir for targeted folder !! ", err);
                             process.exit(1)
                         } else {
 
@@ -386,28 +448,28 @@ function PathHelper() {
 
         //by default.
         if ( typeof(permission) == 'undefined' ) {
-            var permission = 0775
+            permission = 0775
         }
 
         if ( typeof(pathArr) == 'undefined' ) {
-            var pathArr = toArray(self)
+            pathArr = toArray(self)
         }
 
         if ( typeof(i) == 'undefined' ) {
-            var i = 0
+            i = 0
         }
 
         if (i+1 < pathArr.length) {
 
             if ( typeof(path) == 'undefined') {
-                var path =   self.start + pathArr[0]
+                path =   self.start + pathArr[0]
             } else {
                 ++i;
                 path += '/' + pathArr[i]
             }
 
-            fs.exists(path, function(exists) {
-                if (!exists) {
+            exists(path, function(found) {
+                if (!found) {
                     addFolder(self, permission, pathArr, i, path)
                 } else {
                     mkdir(self, permission, pathArr, i, path)
@@ -436,6 +498,86 @@ function PathHelper() {
         }
     }
 
+    /**
+     * symlinkSync
+     *
+     * @param {string} source
+     * @param {string} destination
+     * @param {string} type - Only available from node v12.0.0 & only available on Windows and ignored on other platforms
+     */
+     var symlinkSync = function(source, destination, type) {
+        // About junstion for windows (only):
+        // reminders: creating a symbolic link requires special privilege (by default, only available to elevated processes) whereas creating a junction only requires access to the file system.
+        // https://docs.microsoft.com/en-us/sysinternals/downloads/junction
+        // https://superuser.com/questions/343074/directory-junction-vs-directory-symbolic-link
+        if ( !existsSync(source) ) {
+            throw new Error('Cannot complete symlinkSync from `'+ source +'`: the path does not exist.');
+        }
+        var nodeVersion = process.version.replace(/v/, '').split(/\./g)[0];
+
+        if (
+            process.platform == "win32"
+            && ~~nodeVersion >= 12
+            && typeof(type) == 'undefined'
+            ||
+            process.platform == "win32"
+            && ~~nodeVersion >= 12
+            && !type
+            ||
+            process.platform == "win32"
+            && ~~nodeVersion >= 12
+            && type == ''
+        ) {
+            // check source type
+            if ( fs.lstatSync( source ).isDirectory() ) {
+                type = 'dir';
+            }
+            else {
+                type = 'file'
+            }
+        }
+
+        if (
+            process.platform == "win32"
+            && ~~nodeVersion >= 12
+            && typeof(type) != 'undefined'
+            && type != 'null'
+            && type != ''
+        ) { // can use type
+
+            if ( ['dir', 'file', 'junction'].indexOf(type) < 0 ) {
+                throw new Error('Wrong symlink type: '+ type);
+            }
+        }
+
+        fs.symlinkSync(source, destination, type);
+    }
+    _.prototype.symlinkSync = function(destination, type) {
+        var self = this;
+        var source = self.value;
+
+        // if ( !existsSync(source) ) {
+        //     throw new Error('Cannot complete symlink from `'+ source +'`: the path does not exist.');
+        // }
+        symlinkSync(source, destination, type);
+
+    }
+
+    _.prototype.renameSync = function(destination) {
+        var self = this;
+        var source = self.value;
+
+        if ( !existsSync(source) ) {
+            throw new Error('Cannot complete rename from `'+ source +'`: the path does not exist.');
+        }
+
+        try {
+            fs.renameSync(source, destination);
+        } catch (err) {
+            throw err
+        }
+    }
+
 
     /**
      * copy, file or entire folder
@@ -446,7 +588,7 @@ function PathHelper() {
      *  var sourceToCopy = new _(stringPath);
      *  var target = _(stringPath);
      *
-     *  sourceToCopy.cp(target, function(err){
+     *  sourceToCopy.cp(target, function(err, destination){
      *
      *  })
      *
@@ -459,25 +601,36 @@ function PathHelper() {
      * */
 
     _.prototype.cp = function(target, excluded, cb) {
+
+        if ( typeof(target) == 'undefined' || !target || target == '' || target.length <=2 ) {
+            cb( new Error('This target cannot be used: `'+ target +'`'));
+            return;
+        }
+
         if ( typeof(excluded) == 'function') {
-            var cb = excluded;
+            cb = excluded;
             excluded = undefined
         }
         var self = this;
         //Enter dir & start rm.
         var p = self.value;
         //console.debug("starting copying ", p, " => ", target);
+
         cp(p, target, excluded)
             .onComplete( function(err, destination, method) {
-                cb(err);
+                cb(err, destination);
             });
 
     }
 
     var cp = function(source, destination, excluded) {
 
+        if ( !existsSync(source) ) {
+            throw new Error('Cannot complete copy from `'+ source +'`: the path does not exist.');
+        }
+
         /**
-         * BO Targeting folder content..
+         * BO Targeting folder content
          * This only matters when copy is done Folder To Folder.
          *
          * TODO - Need to br [optimized] by not having to create new path object.
@@ -505,16 +658,31 @@ function PathHelper() {
             childElementsOnly['destination'] = false
         }
         /**
-         * EO Targeting folder content..
+         * EO Targeting folder content
          * */
 
-            //Define strategy.
+        //Define strategy.
         fs.lstat(source, function(err, stats) {
             // 1) File => Dir (add if exist else, throw error).
             // 2) File => File (create or replace if exists).
             // 3) Dir => Dir (create or replace if exists).
 
-            if ( !stats.isDirectory() ) {
+            if (err) {
+                e.emit("cp#complete", err);
+                return;
+            }
+
+            if ( stats.isSymbolicLink() ) {
+                //console.debug('#1 ('+process.version+') Found symlink: '+ source,'\n', JSON.stringify(stats, null, 4));
+                try {
+                    symlinkSync(fs.realpathSync(source), destination);
+                } catch (realPathError) {
+                    e.emit("cp#complete", realPathError, destination);
+                    return;
+                }
+
+                e.emit("cp#complete", err, destination)
+            } else if ( !stats.isDirectory() ) {
                 // 1) & 2) File => Dir (add if exist else, throw error).
                 copyFileToFile(source, destination, 0, function(err) {
                     e.emit("cp#complete", err, destination)
@@ -579,7 +747,7 @@ function PathHelper() {
                                 }
                             }
                             if (!isExcluded) {
-                                var target = new _(destination).mkdir( function(err, path) {
+                                target = new _(destination).mkdir( function(err, path) {
 
                                     browseCopy(source, path, excluded, function(err) {
                                         //console.debug("copy Dir to Dir done");
@@ -622,9 +790,9 @@ function PathHelper() {
                     };
 
                     var d = _(destination);
-                    fs.exists(d, function(exists){
+                    exists(d, function(found){
                         //console.debug("about to remove !! ", d, exists);
-                        if (exists) {
+                        if (found) {
                             rm(d).onComplete( onRemoved )
                         } else {
                             onRemoved(false, d)
@@ -707,16 +875,38 @@ function PathHelper() {
     }
 
     var browseCopy = function(sourceDir, destinationDir, excluded, callback, list, listTo, i) {
-        var list = ( typeof(list) != 'undefined' ) ? list : [];
-        var listTo = ( typeof(listTo) != 'undefined' ) ? listTo : [];
-        var i = ( typeof(i) != 'undefined' ) ? i : 0;
-
-        if (sourceDir == undefined || destinationDir == undefined) {
-            end(callback, false)
+        list = ( typeof(list) != 'undefined' ) ? list : [];
+        listTo = ( typeof(listTo) != 'undefined' ) ? listTo : [];
+        i = ( typeof(i) != 'undefined' ) ? i : 0;
+
+        //console.debug('[browseCopy]', list.length, i, sourceDir, destinationDir);
+        if (
+            sourceDir == undefined
+            || sourceDir == ''
+            || destinationDir == undefined
+            || destinationDir == ''
+        ) {
+            var copyError = false;
+            // is it the list the last file ?
+            if (list.length != i) {
+                copyError = new Error('cp() encountred a fatal error. You have to check your paths.\nSource: '+ sourceDir +'\nDestination: ' + destinationDir);
+            }
+            end(callback, copyError);
         } else {
-            fs.stat(sourceDir, function(err, stats) {
+            fs.lstat(sourceDir, function(err, stats) {
+
+                if ( stats.isSymbolicLink() ) {
+                    //console.debug('real path: ', fs.realpathSync(list[i]));
+                    //console.debug('#2 ('+process.version+') Found symlink: '+ sourceDir,'\n', JSON.stringify(stats, null, 4));
+                    try {
+                        symlinkSync(fs.realpathSync(list[i]), listTo[i]);
+                    } catch (realPathError) {
+                        throw realPathError;
+                    }
 
-                if ( stats.isDirectory() ) {
+                    ++i;
+                    browseCopy(list[i], listTo[i], excluded, callback, list, listTo, i)
+                } else if ( stats.isDirectory() ) {
 
                     var isExcluded = false;
                     if ( typeof(sourceDir) != 'undefined' && excluded != undefined) {
@@ -819,7 +1009,7 @@ function PathHelper() {
                         destination += path
                     }
 
-                    fs.exists(destination, function(replaceFlag) {
+                    exists(destination, function(replaceFlag) {
                         if (replaceFlag) {
                             fs.unlink(destination, function(err) {
                                 //TODO - log error.
@@ -884,13 +1074,21 @@ function PathHelper() {
         var self = this;
         //Enter dir & start rm.
         var p = self.value;
-
-        fs.exists(p, function(exists){
-            if ( !exists ) {
-                callback( new Error(' mv() - source [ '+p+' ] does not exists !') )
+        exists(p, function(found){
+            if ( !found ) {
+                var err = new Error(' mv() - source [ '+p+' ] does not exists !');
+                console.error(err);
+                if ( !callback ) {
+                    throw err
+                }
+                callback(err)
             } else {
                 mv(self, target)
                     .onComplete( function(err, path){
+                        if (err) {
+                            console.error(err);
+                            return callback(err)
+                        }
                         if (p == path && typeof(callback) != 'undefined') {
                             callback(err)
                         }
@@ -900,17 +1098,21 @@ function PathHelper() {
     }
 
     var mv = function(self, target) {
-        //console.debug("starting mv/copy from ", self.value, " to ", target);
-        var task = new _(self.value);
-        task.cp(target, function(err) {
-            if (err) console.error(err);
-
-            //console.debug("cp done... now unlinking source ", self.value);
-            rm(self.value).onComplete( function(err, path){
-                //console.debug('rm() complete');
-                e.emit('mv#complete', err, path)
+        console.debug("starting mv/copy from ", self.value, " to ", target);
+        cp(self.value, target)
+            .onComplete(function onCpMv(err) {
+                console.debug("cp done... now unlinking source ", self.value);
+                if (err) {
+                    e.emit('mv#complete', err);
+                    return;
+                }
+
+
+                rm(self.value).onComplete( function(err, path){
+                    console.debug('rm() complete');
+                    e.emit('mv#complete', err, path)
+                })
             })
-        });
 
         return {
             /**
@@ -940,12 +1142,17 @@ function PathHelper() {
      * */
     _.prototype.rmSync = function() {
 
-        if ( !fs.existsSync(this.value) ) {
+        if ( !existsSync(this.value) ) {
             return this // always return the instance for sync
         }
         cleanSlashes(this);
 
         try {
+
+            if ( fs.lstatSync(this.value).isSymbolicLink() ) {
+                fs.unlinkSync(this.value);
+                return this;
+            }
             browseRemoveSync(this.value);
             return this // always return the instance for sync
         } catch (err) {
@@ -954,7 +1161,7 @@ function PathHelper() {
     }
 
     var removeFoldersSync = function(list, l, i) {
-        var i = i || 0;
+        i = i || 0;
         if ( typeof(list[l]) == "undefined") {
             return list[l-1][list[l-1].length -1]
         } else {
@@ -991,9 +1198,10 @@ function PathHelper() {
     }
 
     var browseRemoveSync = function(source, list, folders, i) {
-        var list = ( typeof(list) != 'undefined' ) ? list : [];
-        var folders = ( typeof(folders) != 'undefined' ) ? folders : [];
-        var i = ( typeof(i) != 'undefined' ) ? i : 0;
+        list = ( typeof(list) != 'undefined' ) ? list : [];
+        folders = ( typeof(folders) != 'undefined' ) ? folders : [];
+        i = ( typeof(i) != 'undefined' ) ? i : 0;
+        var err = false;
 
         if (list.length === 0) {
             list.push(source)
@@ -1012,7 +1220,14 @@ function PathHelper() {
             if (stats instanceof Error)
                 return stats;
 
-            if ( stats.isDirectory() ) {
+            if ( stats.isSymbolicLink() ) {
+                err = removeFileSync(source);
+                if (err instanceof Error)
+                    return err;
+
+                ++i;
+                browseRemoveSync(list[i], list, folders, i)
+            } else if ( stats.isDirectory() ) {
 
                 if (folders.length == 0) {
                     folders[0] = [];
@@ -1044,7 +1259,7 @@ function PathHelper() {
                 browseRemoveSync(list[i], list, folders, i)
 
             } else {
-                var err = removeFileSync(source);
+                err = removeFileSync(source);
                 if (err instanceof Error)
                     return err;
 
@@ -1066,11 +1281,11 @@ function PathHelper() {
         //Enter dir & start rm.
         self = cleanSlashes(self);
         var p = self.value;
-        fs.exists(p, function(exists) {
+        exists(p, function(found) {
             //console.debug(" does it exists ? ", p, exists );
-            if (!exists) {
+            if (!found) {
                 //console.debug("done removing ", p);
-                callback(new Error('`'+p+'` does not found'), p)
+                callback(new Error('`'+p+'` not found'), p)
 
             } else {
                 rm(p).onComplete( function(err, path) {
@@ -1128,7 +1343,7 @@ function PathHelper() {
      * */
 
     var removeFolders = function(list, l, i, callback) {
-        var i = i || 0
+        i = i || 0
         if ( typeof(list[l]) == "undefined") {
             callback(false, list[l-1][list[l-1].length -1])
         } else {
@@ -1169,9 +1384,9 @@ function PathHelper() {
     }
 
     var browseRemove = function(source, callback, list, folders, i) {
-        var list = ( typeof(list) != 'undefined' ) ? list : [];
-        var folders = ( typeof(folders) != 'undefined' ) ? folders : [];
-        var i = ( typeof(i) != 'undefined' ) ? i : 0;
+        list = ( typeof(list) != 'undefined' ) ? list : [];
+        folders = ( typeof(folders) != 'undefined' ) ? folders : [];
+        i = ( typeof(i) != 'undefined' ) ? i : 0;
 
         if (list.length === 0) {
             list.push(source)
@@ -1273,7 +1488,7 @@ function PathHelper() {
      * /data/folder/other file ( "/data/folder/other\ file" )
      * \\192.168.0.1\folder\file ( "\\\\192.168.0.1\\folder\\file" )
      *
-     * @return {boolean} isReal
+     * @returns {boolean} isReal
      *
      * @callback [ cb ]
      * @param {boolean} isReal
@@ -1290,38 +1505,11 @@ function PathHelper() {
         }
     }
 
-    /**
-     * Set path by name
-     * @param {String} name Path name
-     * @return {String}
-     * */
-    // TODO - remove this
-    // setPath = function(name, path) {
-    //
-    //     if ( typeof(name) == 'object') {
-    //         var paths = getContext('paths');
-    //         for (var n in name) {
-    //             _this.userPaths[n] = _(name[n]);
-        //             merge(paths, _this.userPaths, true)
-    //         }
-    //         setContext("paths", paths)
-    //
-    //     } else {
-    //         if ( typeof(_this.userPaths) == "undefined" || typeof(_this.userPaths[name]) == "undefined" )  {
-    //             _this.userPaths[name] = _(path);
-    //             //PathHelper.userPaths = _this.userPaths;
-    //             //console.debug("what is this ", Helpers, " VS ", _this.userPaths);
-    //             var paths = getContext('paths');
-    //             //console.info(" 1) got config paths " +  paths + " VS "+ _this.userPaths, __stack);
-        //             merge(paths, _this.userPaths, true);
-    //             setContext("paths", paths)
-    //         }
-    //     }
-    // }
+
 
     var parseCtxObject = function (o, obj) {
 
-        for (var i in o) {
+        for (let i in o) {
             if (o[i] !== null && typeof(o[i]) == 'object') {
                 parseCtxObject(o[i], obj);
             } else if (o[i] == '_content_'){
@@ -1332,22 +1520,41 @@ function PathHelper() {
         return o
     }
 
+    /**
+     * setPath
+     * Set path by name
+     *
+     * @param {String} name - Path name
+     * @returns {String} path
+     * */
     setPath = function(name, path) {
 
+        if ( !path || typeof(path) == 'undefined' || path == '' ) {
+            throw new Error('setPath(name, path): path cannot be empty or undefined')
+        }
+        // check if symlink to get realpath
+        // var stats = fs.lstatSync(path);
+        // if (stats instanceof Error) {
+        //     throw new stats
+        // }
+        // if ( stats.isSymbolicLink() ) {
+        //     path = fs.realpathSync(path)
+        // }
+        var paths = null;
         if ( typeof(name) == 'string' && /\./.test(name) ) {
             var keys        = name.split(/\./g)
                 , newObj    = {}
                 , str       = '{'
                 , _count    = 0;
 
-            for (var k = 0, len = keys.length; k<len; ++k) {
+            for (let k = 0, len = keys.length; k<len; ++k) {
                 str +=  "\""+ keys.splice(0,1)[0] + "\":{";
 
                 ++_count;
                 if (k == len-1) {
                     str = str.substr(0, str.length-1);
                     str += "\"_content_\"";
-                    for (var c = 0; c<_count; ++c) {
+                    for (let c = 0; c<_count; ++c) {
                         str += "}"
                     }
                 }
@@ -1355,17 +1562,17 @@ function PathHelper() {
 
             newObj = parseCtxObject(JSON.parse(str), path);
 
-            var paths = getContext('paths');
+            paths = getContext('paths');
             paths = merge(paths, newObj);
             setContext("paths", paths)
 
         } else {
             // normal case
-            var paths = getContext('paths');
+            paths = getContext('paths');
 
             var userPaths = {};
             if ( typeof(name) == 'object') {
-                for (var n in name) {
+                for (let n in name) {
                     if ( typeof(name) == 'string' && /\./.test(name) ) {
                         setPath(n, name[n])
                     } else {
@@ -1373,11 +1580,11 @@ function PathHelper() {
                         merge(paths, userPaths, true)
                     }
                 }
-                setContext("paths", paths)
+                setContext('paths', paths)
 
             } else {
                 paths[name] = path;
-                setContext("paths", paths)
+                setContext('paths', paths)
             }
         }
     }
@@ -1387,14 +1594,14 @@ function PathHelper() {
     /**
      * Get path by name
      * @param {String} name Path name
-     * @return {String} path
+     * @returns {String} path
      * */
     getPath = function(name) {
         var paths = getContext('paths');
         if ( typeof(paths[name]) != "undefined" ) {
             return paths[name]
         } else {
-            return undefined
+            throw new Error('Path `'+ name+'` not found. Check the spelling or add a new one using setPath("'+name+'", "\/your\/new\/pathname")')
         }
     }
 
@@ -1406,6 +1613,6 @@ function PathHelper() {
         return getContext("paths")
     }
 
-};//EO PathHelper.
+}//EO PathHelper.
 
 module.exports = PathHelper