gina 0.1.1-alpha.99 → 0.1.2-alpha.1

package/framework/{v0.1.1-alpha.99 → v0.1.2-alpha.1}/lib/logger/src/containers/file/index.js

@@ -8,26 +8,78 @@ const net                 = require('net');
 // const delay = ms => new Promise(resolve => setTimeout(resolve, ms));
 // const { execSync }      = require('child_process');
 
+var helpers = null;
 
-const merge = require(__dirname + '/../../../../merge');
+var merge     = require(__dirname + '/../../../../merge');
+if ( typeof(merge) != 'function' ) {
+    // if needed for unit tests
+    merge = eval(fs.readFileSync(__dirname +'/../../../../merge/src/main.js').toString())
+}
 
 function FileContainer(opt, loggers) {
     var self = {
         // flow or container name/id
         name: 'file'
     };
+
     var mqId = 'MQ'+ self.name.substring(0,1).toLocaleUpperCase() + self.name.substring(1);
 
-    //var defaultOptions = ;
+    helpers         = require(__dirname +'/../../../../../helpers');
+
 
     var loggerHelper    = require(__dirname +'/../../helper.js')(opt, loggers);
     var format          = loggerHelper.format;
     var processProperties = null;
     var filenames   = {};
 
-    function init() {
+    function init(opt) {
+
+        // ---------- BO - hack for early calls
+        var isWin32         = (process.platform === 'win32') ? true : false;
+        var binPath         = __dirname +'/../../../../../../../';
+        var ginaPath        = (binPath.replace(/\\/g, '/')).replace('/bin', '');
+        ginaPath = (isWin32) ? ginaPath.replace(/\//g, '\\') : ginaPath;
+        // loading pack
+        var pack            = ginaPath + '/package.json';
+        pack = (isWin32) ? pack.replace(/\//g, '\\') : pack;
+        var packObj         = require(pack);
+        var version         = packObj.version;// jshint ignore:line
+        // var frameworkPath   = ginaPath + '/framework/v' + version;
+
+
+        var shortVersion = version.split('.');
+        shortVersion.splice(2);
+        shortVersion = shortVersion.join('.');
+
+        var settings = { mq_port: 8125, host_v4: '127.0.0.1' };
+        try {
+            settings = require( getUserHome() + '/.gina/' + shortVersion + '/settings.json');
+        } catch (err) {}
+
+        opt.mqPort = settings.mq_port;
+        opt.hostV4 = settings.host_v4;
+        // ---------- EO - hack for early calls
+
+        // handle server not started yet or server exited
+        // process.on('gina#mqlistener-started', function onGinaStarted(mqPort, hostV4, group) {
+        //     if (group) {
+        //         console.info('[MQFile] Group `'+group+'` connected `'+ hostV4 +'` on port `'+ mqPort +'` :)');
+        //     }
+        //     clearInterval(nIntervId);
+        //     nIntervId = null;
+        //     onPayload({mqPort: mqPort, hostV4: hostV4});
+        // });
+
+        process.on('gina#bundle-logging', function onBundleStarted(mqPort, hostV4, group) {
+            console.debug('[MQFile] resuming ...')
+            if (group) {
+                console.info('[MQFile] Group `'+group+'` connected `'+ hostV4 +'` on port `'+ mqPort +'` :)');
+            }
+            // only if tail not already running !! Or you will get duplicate logs
+            onPayload({mqPort: mqPort, hostV4: hostV4}, true);
+        });
 
-        onPayload();
+        onPayload(opt);
 
         // ----------------------------Debug---------------------------------------
         var level = 'debug';
@@ -75,22 +127,36 @@ function FileContainer(opt, loggers) {
         var projectName = bfnArr[1];
         var homeDir = getUserHome() || process.env[(process.platform == 'win32') ? 'USERPROFILE' : 'HOME'];// jshint ignore:line
         homeDir += '/.gina';
-        var project = requireJSON(_(homeDir +'/projects.json', true))[projectName];
+        var project = requireJSON(_(homeDir +'/projects.json', true))[projectName];// jshint ignore:line
         var projectPath = project.path;
-        console.info('write env: ', bundleName, process.env.NODE_ENV || getEnvVar('GINA_ENV'));
-        var envObj      = requireJSON(_(projectPath +'/env.json', true))[bundleName][process.env.NODE_ENV || getEnvVar('GINA_ENV')]
+        // console.debug('logger::file write env: ', bundleName, process.env.NODE_ENV, getEnvVar('GINA_ENV'), JSON.stringify(process.gina, null, 2) );// jshint ignore:line
+
+        var env         = process.env.NODE_ENV || getEnvVar('GINA_ENV');// jshint ignore:line
+        var Config      = require(getEnvVar('GINA_CORE') + '/config');
+        var conf = new Config({
+            env: env,
+            projectName: projectName,
+            executionPath: projectPath,
+            startingApp: bundleName,
+            ginaPath: getEnvVar('GINA_CORE')
+        }, true).getInstance(bundleName);
+
+        var envObj      = conf.envConf[bundleName][env];// jshint ignore:line
         var webroot     = ( !/\s+|\//.test(envObj.server && envObj.server.webroot) ) ? envObj.server.webroot +'.' : '';
         var hostname    = envObj.host;
-        var logDir      = getLogDir() || getEnvVar('GINA_LOGDIR');
+        var logDir      = getLogDir() || getEnvVar('GINA_LOGDIR');// jshint ignore:line
 
-        filenames[group].filename = _(logDir +'/'+ webroot + hostname +'.log', true);
+        filenames[group].filename = _(logDir +'/'+ webroot + hostname +'.log', true);// jshint ignore:line
         console.debug('Log group `'+ group +'` filename set to: ' + filenames[group].filename);
         process.stdout.write( format(opt.name, 'info', 'Log group `'+ group +'` filename set to: ' + filenames[group].filename) );
     }
 
-    function onPayload() {
-        var port = 8125;
+    function onPayload(opt, isResuming) {
+        // console.debug('mqFile options: ', JSON.stringify(opt, null, 2));
+        var port = opt.mqPort || getEnvVar('GINA_MQ_PORT') || 8125;// jshint ignore:line
+        var host = opt.hostV4 || getEnvVar('GINA_HOST_V4') || '127.0.0.1';// jshint ignore:line
         var clientOptions = {
+            host    : host,
             port    : port,
             request : 'writeToFile'
         }
@@ -104,7 +170,7 @@ function FileContainer(opt, loggers) {
 
         var delayedMessages = [];
         var resume = function(payload) {
-            process.stdout.write('['+ mqId +'] Resuming with group: '+ payload.group);
+            // process.stdout.write('['+ mqId +'] Resuming with group: '+ payload.group);
             var i = 0;
             while (i < delayedMessages.length) {
                 let pl = delayedMessages[i];
@@ -118,22 +184,45 @@ function FileContainer(opt, loggers) {
         }
 
 
+
+
         var client = net.createConnection(clientOptions, () => {
             // 'connect' listener.
-            console.info('['+ mqId +'] connected to server :) ', process.argv);
+            console.info('['+ mqId +'] connected to server :) on host: '+ host + ' & port: '+ port, process.argv);
             processProperties = loggerHelper.getProcessProperties();
             console.info('['+ mqId +'] process properties ', processProperties);
+
+            process.emit('gina#container-writting', host, port);
+
             // send request
             client.write( JSON.stringify(clientOptions) +'\r\n');
 
         });
+
+
         client.on('error', (data) => {
             var err = data.toString();
             process.stdout.write( format(opt.name, 'warn', '['+ mqId +'] ' + err) );
+
+            // allowing the framework to quit properly
+            if ( /write EPIPE|read ECONNRESET|connect ECONNREFUSED/i.test(err) ) {
+                process.exit(0)
+            }
+
+            // var mqPort = null;
+            // nIntervId = setInterval(() => {
+            //     try {
+            //         mqPort = ~~(fs.readFileSync(mqPortFile).toString());
+            //         if (mqPort) {
+            //             process.emit('gina#mqlistener-started', mqPort, host);
+            //         }
+            //     } catch (fileErr) {}
+            // }, 100);
         });
 
         var payloads = null, i = null;
         client.on('data', (data) => {
+
             //console.log('['+ mqId +']  (data): ' + data.toString());
             payloads = data.toString();
 
@@ -185,6 +274,12 @@ function FileContainer(opt, loggers) {
                             continue;
                         }
 
+                        // resuming logging from another process
+                        // we do not want to print twice in this case since another logger server is already running
+                        if (isResuming) {
+                            return
+                        }
+
                         // only for debug
                         // process.stdout.write(  '['+ mqId +'] '+ pl.content +'\n' );
 
@@ -246,6 +341,6 @@ function FileContainer(opt, loggers) {
 
 
 
-    init();
+    init(opt);
 }
 module.exports = FileContainer;

package/framework/{v0.1.1-alpha.99 → v0.1.2-alpha.1}/lib/logger/src/containers/mq/index.js

@@ -4,8 +4,11 @@ const fs          = require('fs');
 const net         = require('net');
 const util        = require('util');
 const promisify   = util.promisify;
-const merge       = require(__dirname +'/../../../../merge');
-
+var merge         = require(__dirname +'/../../../../merge');
+if ( typeof(merge) != 'function' ) {
+    // if needed for unit tests
+    merge = eval(fs.readFileSync(__dirname +'/../../../../merge/src/main.js').toString())
+}
 function MqContainer(opt, loggers) {
     var self = {
         // flow or container name/id
@@ -15,10 +18,11 @@ function MqContainer(opt, loggers) {
     // TODO - get options like the `port` from: ~/.gina/user/extensions/logger/{container}/config.json
 
     var MQSpeaker       = require('./speaker.js');
-    opt = merge(opt, { port: 8125 });
+    opt = merge(opt, { mqPort: 8125, hostV4: '127.0.0.1' });
     var mqSpeaker       = new MQSpeaker(opt, loggers);
 
     function init() {
+
         onPayload()
 
         // ------------------------------------------------------------------------
@@ -37,9 +41,14 @@ function MqContainer(opt, loggers) {
 
     function onPayload() {
         process.on('logger#'+self.name, function onPayload(payload) {
+            if ( loggers[opt.name]._options.isFlushing ) {
+                return;
+            }
+
             if ( !loggers[opt.name]._options.isReporting ) {
                 return;
             }
+
             if (mqSpeaker.write) {
                 mqSpeaker.write( payload +'\r\n' );
             }

package/framework/{v0.1.1-alpha.99 → v0.1.2-alpha.1}/lib/logger/src/containers/mq/listener.js

@@ -15,23 +15,23 @@ function MQListener(opt, cb) {
     // will be in memory until the framework is stopped
     // TODO - remove specific `bundle` or `CLI` config when the process is terminated
     var sharedConfig    = { loggers: {}};
-    var homedir         = getEnvVar('GINA_HOMEDIR');
+    var homedir         = getEnvVar('GINA_HOMEDIR');// jshint ignore:line
     var isLoggedByFile  = false; // by default
     var fileLogsList    = {};
 
 
     function init(opt, cb) {
         setup();
-        return startMQListener(opt.port, cb);
+        return startMQListener(opt, cb);
     }
 
     function setup() {
-        var mainConfigPath  = _(homedir +'/user/extensions/logger/default/config.json', true);
-        if ( !new _(mainConfigPath, true).existsSync() ) {
+        var mainConfigPath  = _(homedir +'/user/extensions/logger/default/config.json', true);// jshint ignore:line
+        if ( !new _(mainConfigPath, true).existsSync() ) {// jshint ignore:line
             //throw new Error('Required file not found: '+ mainConfigPath);
             return;
         }
-        var mainConfig = requireJSON(mainConfigPath);
+        var mainConfig = requireJSON(mainConfigPath);// jshint ignore:line
         if ( mainConfig.flows.indexOf('file') > -1 ) {
             isLoggedByFile = true;
         }
@@ -64,8 +64,8 @@ function MQListener(opt, cb) {
             file = name;
         }
         file += '.log';
-        var filename = _(GINA_LOGDIR +'/'+ file);
-        var filenameObj = new _(filename);
+        var filename = _(GINA_LOGDIR +'/'+ file);// jshint ignore:line
+        var filenameObj = new _(filename);// jshint ignore:line
         if ( !filenameObj.existsSync() ) {
             // create an empty file
             try {
@@ -81,10 +81,10 @@ function MQListener(opt, cb) {
             compress: true,
             count: 3
         };
-        var rotatorOptionsPath = _(homedir +'/user/extensions/logger/file/config.json', true);
-        if ( new _(rotatorOptionsPath).existsSync() ) {
+        var rotatorOptionsPath = _(homedir +'/user/extensions/logger/file/config.json', true);// jshint ignore:line
+        if ( new _(rotatorOptionsPath).existsSync() ) {// jshint ignore:line
             try {
-                rotatorOptions = merge( requireJSON(rotatorOptionsPath).logrotator, rotatorOptions );
+                rotatorOptions = merge( requireJSON(rotatorOptionsPath).logrotator, rotatorOptions );// jshint ignore:line
             } catch (userConfigErr) {
                 throw userConfigErr
             }
@@ -149,9 +149,9 @@ function MQListener(opt, cb) {
         sessions[sessionId].write( JSON.stringify(payload) +'\r\n');
     }
 
-    function startMQListener(port, cb) {
-        // AbortController is a global object
-        const controller = new AbortController();// jshint ignore:line
+    function startMQListener(opt, cb) {
+        var port = opt.port;
+        var host = opt.hostV4;
         var server = net.createServer( function(conn) {//'connection' listener
 
             conn.sessionId = uuid.v4();
@@ -165,7 +165,7 @@ function MQListener(opt, cb) {
                 delete sessions[this.sessionId];
                 if ( this.request != 'report' ) {
                     forwardId = forwardList[this.request].indexOf(this.sessionId);
-                    if ( forwardId > -1 ) {
+                    if ( forwardId > -1 && typeof(forwardList[this.request]) != 'undefined') {
                         forwardList[this.request].splice(forwardId, 1);
                     }
                 }
@@ -264,7 +264,7 @@ function MQListener(opt, cb) {
 
         server.on('error', function(err) {
             if (err.code === 'EADDRINUSE') {
-                console.warn('[MQListener] is already running on port [ '+ (err.port || port) +' ]');
+                console.warn('[MQListener] `'+ host +'` is already running on port [ '+ (err.port || port) +' ]');// jshint ignore:line
             } else {
                 console.emerg('[MQListener] Could not start', err.stack)
             }
@@ -282,13 +282,21 @@ function MQListener(opt, cb) {
             }
         });
 
-        server.listen({
-            host: '127.0.0.1',
-            port: port,
-            signal: controller.signal
-          }, function() {
+        var listenOption = {
+            host: host,
+            port: port
+        };
+        var controller = null;
+        // AbortController nodejs >= v15
+        if ( typeof(AbortController) != 'undefined' ) {
+            // AbortController is a global object
+            var controller = new AbortController();// jshint ignore:line
+            listenOption.signal = controller.signal;
+        }
+
+        server.listen(listenOption, function() {
             // Server started.
-            console.info('[MQListener] is waitting for speakers on port `'+ port +'`');
+            console.info('[MQListener] `'+ host +'`is waitting for speakers on port `'+ port +'`');
             if (cb) {
                 cb(false);
             }

package/framework/{v0.1.1-alpha.99 → v0.1.2-alpha.1}/lib/logger/src/containers/mq/speaker.js

@@ -14,14 +14,43 @@ function MQSpeaker(opt, loggers, cb) {
 
 
     function init(opt, cb) {
+
+        // ---------- BO - hack for early calls
+        var isWin32         = (process.platform === 'win32') ? true : false;
+        var binPath         = __dirname +'/../../../../../../../';
+        var ginaPath        = (binPath.replace(/\\/g, '/')).replace('/bin', '');
+        ginaPath = (isWin32) ? ginaPath.replace(/\//g, '\\') : ginaPath;
+        // loading pack
+        var pack            = ginaPath + '/package.json';
+        pack = (isWin32) ? pack.replace(/\//g, '\\') : pack;
+        var packObj         = require(pack);
+        var version         = packObj.version;// jshint ignore:line
+        // var frameworkPath   = ginaPath + '/framework/v' + version;
+
+
+        var shortVersion = version.split('.');
+        shortVersion.splice(2);
+        shortVersion = shortVersion.join('.');
+
+        var settings = { mq_port: 8125, host_v4: '127.0.0.1' };
+        try {
+            settings = require( getUserHome() + '/.gina/' + shortVersion + '/settings.json');
+        } catch (err) {}
+
+        opt.mqPort = settings.mq_port;
+        opt.hostV4 = settings.host_v4;
+        // ---------- EO - hack for early calls
+
         return startMQSpeaker(opt, cb);
     }
 
 
     function startMQSpeaker(opt, cb) {
-
+        var port = opt.mqPort || 8125;// jshint ignore:line
+        var host = opt.hostV4 || '127.0.0.1';// jshint ignore:line
         var clientOptions = {
-            port    : opt.port,
+            host    : host,
+            port    : port,
             request : 'report'
         };
         var client = net.createConnection(clientOptions, () => {
@@ -29,7 +58,7 @@ function MQSpeaker(opt, loggers, cb) {
             // send request
             client.write( JSON.stringify(clientOptions) +'\r\n');
 
-            console.info('[MQSpeaker] connected to server :) ');
+            console.info('[MQSpeaker] connected to server on host: '+ host +' & port: '+ port +' :) ');
 
             if (cb) {
                 cb(false, client)
@@ -106,7 +135,7 @@ function MQSpeaker(opt, loggers, cb) {
 
         });
         client.on('end', () => {
-            console.log('[MQSpeaker] disconnected from server');
+            console.debug('[MQSpeaker] disconnected from server');
         });
 
         return client;

package/framework/{v0.1.1-alpha.99 → v0.1.2-alpha.1}/lib/logger/src/helper.js

@@ -1,6 +1,6 @@
 /*
  * This file is part of the gina package.
- * Copyright (c) 2009-2022 Rhinostone <contact@gina.io>
+ * Copyright (c) 2009-2023 Rhinostone <contact@gina.io>
  *
  * For the full copyright and license information, please view the LICENSE
  * file that was distributed with this source code.
@@ -35,20 +35,31 @@
      * @param {boolean} skipFormating
      * */
     self.format = function(group, s, content, skipFormating) {
+
         if (
             s == 'catch'
             || typeof(skipFormating) != 'undefined' && /true/i.test(skipFormating)
         ) {
             return content
         }
+
         if (content != '') {
             var colors = null;
             try {
+                // hack for loggers['bundle@project'] not found in this context
+                // so we just clone gina's
+                if ( typeof(loggers[ group ]) == 'undefined' ) {
+                    loggers[ group ] = JSON.clone(loggers.gina);
+                }
                 colors = loggers[ group ].colors
             } catch(colorsErr) {
+                // Leave it just in case we need to detect bugs right from the log output
+                content += '\nNot able to define colors. Please check logger‘s group: `'+ group +'`\n';
+                process.stdout.write('--['+ s +'/'+ skipFormating +']-> '+content +'\n');
                 throw new Error('Not able to define colors. Please check logger‘s group: `'+ group +'`\n')
             }
 
+
             var now = new Date().format('logger');
             var sCount = s.length;
             if ( sCount < opt._maxLevelLen ) {
@@ -56,6 +67,7 @@
                     s +=' ';
                 }
             }
+            sCount = null;
 
             var repl = {
                 '%a': group, // application or service name
@@ -73,6 +85,7 @@
             //process.stdout.write('colors '+ JSON.stringify(colors[colorCode], null, 2)  +'\n');
 
 
+
             if ( typeof(_color) != 'undefined' && _color) {
                 //process.stdout.write('colors code '+ JSON.stringify(colors, null, 2)  +'\n');
                 content = _color.open + opt.template + _color.close;
@@ -80,12 +93,20 @@
                 content = opt.template;
             }
 
+
+
             // formating output
             for (let p=0; p<patt.length; ++p) {
                 content = content.replace(new RegExp(patt[p], 'g'), repl[patt[p]])
             }
+
+
         }
 
+        // test only
+        // process.stdout.write('--['+ s +'/'+ skipFormating +']->'+content +'\n');
+
+
         // We should be using `\r` instead of `\n`
         // But it is not yet possible because of weird console.*() stdout when we are on the CLI or Framework side
         return content +'\n'

package/framework/{v0.1.1-alpha.99 → v0.1.2-alpha.1}/lib/logger/src/main.js

@@ -1,7 +1,7 @@
 'use strict';
 /**
  * This file is part of the gina package.
- * Copyright (c) 2009-2022 Rhinostone <contact@gina.io>
+ * Copyright (c) 2009-2023 Rhinostone <contact@gina.io>
  *
  * For the full copyright and license information, please view the LICENSE
  * file that was distributed with this source code.
@@ -13,8 +13,9 @@ var promisify           = util.promisify;
 const { EventEmitter }  = require('events');
 
 // During initial pre-install & post-install, `colors` might not be installed !
-var colors          = null;
-var frameworkPath   = __dirname +'/../../../../..';
+var colors              = null;
+var frameworkPath       = __dirname +'/../../../../..';
+// var frameworkVersion    = require(frameworkPath + '/package.json').version;
 try {
     colors = require('colors') || require(frameworkPath +'/node_modules/colors');
 } catch (err) {
@@ -28,6 +29,10 @@ var inherits        = require('../../inherits');
 var helpers         = require('../../../helpers');
 
 // BO - publishing hack
+if ( typeof(merge) != 'function' ) {
+    // if needed for unit tests
+    merge = eval(fs.readFileSync(__dirname +'/../../merge/src/main.js').toString())
+}
 if ( typeof(JSON.clone) == 'undefined' ) {
     require(__dirname +'/../../../helpers/prototypes')()
 }
@@ -189,8 +194,8 @@ function Logger() {
         // This will apply for the framework, and will be inherited for all bundles unless you ovveride it in your application/bundle code
         // ----
         // [ Inside your code ]
-        // var utils       = require('gina').utils;
-        // var console     = utils.logger;
+        // var lib      = require('gina').lib;
+        // var console  = lib.logger;
         // console.setLevel('trace', bundleName) - Put that in the bundle bootstrap
         hierarchy: process.env.LOG_LEVEL || defaultLogLevel || 'info', // by default: info
         hierarchies: {
@@ -238,7 +243,8 @@ function Logger() {
              */
             //off: [5]
         },
-        isReporting: true
+        isReporting: true,
+        isFlushing: false
     };
 
     var getInstance = function() {
@@ -260,13 +266,16 @@ function Logger() {
             getInstance();
             // process.env.NODE_ENV
             if (opt.hierarchies[opt.hierarchy].indexOf( opt.levels['debug'].code) > -1) {
-                emit(opt, 'debug', 'Logger instance already exists: reusing it ;)');
+                emit(opt, 'debug', '`'+ opt.name +' `Logger instance already exists: reusing it ;)');
             }
 
             return self;
         }
         ctx.initialized = true;
-
+        if (!homeDir) {
+            homeDir =  ( typeof(getUserHome) != 'undefined' ) ? getUserHome() : process.env[(process.platform == 'win32') ? 'USERPROFILE' : 'HOME'];// jshint ignore:line
+            homeDir += '/.gina';
+        }
         // user main options & flows options
         var extPath = _(homeDir +'/user/extensions/logger', true)
         var optionsPath = _(extPath +'/default/config.json', true);
@@ -293,6 +302,8 @@ function Logger() {
         // setting up `opt`
         // this is done to repespect arrays order
         var newDefaultOptions = merge(JSON.clone(defaultOptions), userOptions);
+        // var newDefaultOptions = merge(defaultOptions, userOptions);
+
         defaultOptions = JSON.clone(newDefaultOptions);
         newDefaultOptions = null;
         if (userOptions && userOptions.flows) {
@@ -658,8 +669,24 @@ function Logger() {
     self.pauseReporting = function() {
         loggers[ctx._options.name]._options.isReporting = false;
     }
-    self.resumeReporting = function() {
+    self.resumeReporting = function(group) {
+
+        //  [ duplicate output fix ]
+        // if (group && loggers[group]._options) {
+        //     self.warn('[logger]['+ group +'] now resuming ('+ group +')\n');
+        //     loggers[group]._options.isFlushing = false;
+        // }
+
         loggers[ctx._options.name]._options.isReporting = true;
+
+
+
+    }
+
+    //  [ duplicate output fix ]
+    self.flush = function (group) {
+        self.warn('[logger]['+ group +'] now flushing ('+ group +')\n');
+        loggers[group]._options.isFlushing = true;
     }
 
 

package/framework/{v0.1.1-alpha.99 → v0.1.2-alpha.1}/lib/math/index.js

@@ -1,7 +1,7 @@
 //'use strict';
 /*
  * This file is part of the gina package.
- * Copyright (c) 2009-2022 Rhinostone <contact@gina.io>
+ * Copyright (c) 2009-2023 Rhinostone <contact@gina.io>
  *
  * For the full copyright and license information, please view the LICENSE
  * file that was distributed with this source code.
@@ -14,7 +14,7 @@ var crypto      = require('crypto');
 /**
  * MathHelper
  *
- * @package     gina.utils.math
+ * @package     gina.lib.math
  * @author      Rhinostone <contact@gina.io>
  * @api public
  * */
@@ -40,7 +40,7 @@ function MathHelper() {
      *
      * e.g.:
      *
-     *  var operate = require("gina").utils.math.operate;
+     *  var operate = require("gina").lib.math.operate;
      *  var computation = "10*2";
      *  var result = operate(computation);
      *      => 20
@@ -88,7 +88,7 @@ function MathHelper() {
     self.checkSum = async function(filename, algorithm, encoding, isCheckingFromData, cb) {
         var err = false, sum = null;
         isCheckingFromData = ( typeof(isCheckingFromData) != 'undefined' ) ? isCheckingFromData : false;
-        
+
         if ( !isCheckingFromData && /\./.test(filename) ) {
             fs.readFile(filename, async function (err, data) {
                 sum = await checkSum(data, algorithm, encoding);
@@ -124,10 +124,10 @@ function MathHelper() {
             }
             str = arr.sort().join(',');
         }
-        
+
         return str;
     };
-    
+
     /**
      * Check sum from file or form data
      *
@@ -140,11 +140,11 @@ function MathHelper() {
     self.checkSumSync = function(filename, algorithm, encoding) {
         var sum = null;
         try {
-            
+
             if ( typeof(filename) == 'object' ) {
-                filename = objectToString(filename);                
+                filename = objectToString(filename);
             }
-            
+
             if ( /(\.[a-z]{3})$/.test(filename) ) { // must be a string
                 // from filename
                 sum = checkSum( fs.readFileSync(filename), algorithm, encoding )