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

package/framework/{v0.1.1-alpha.99 → v0.1.2-alpha.1}/helpers/context.js

@@ -1,19 +1,20 @@
 /*
  * 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.
  */
-var fs      = require('fs');
-var os      = require('os');
+var fs              = require('fs');
+var os              = require('os');
+const {execSync}    = require('child_process');
 //var merge   = require('./../lib/merge');
 //var console = require('./../lib/logger');
 
 /**
  * ContextHelper
  *
- * @package     Gina.Utils.Helpers
+ * @package     Gina.Lib.Helpers
  * @author      Rhinostone <contact@gina.io>
  * @api public
  * */
@@ -41,6 +42,24 @@ function ContextHelper(contexts) {
         if ( typeof(ContextHelper.initialized) != 'undefined' && ContextHelper.instance) {
             self = ContextHelper.instance;
         } else {
+            // Get system environment variable
+            self.contexts['sysEnvVars'] = { '~/': getUserHome() +'/' };
+            var sysEnvVars = null;
+            try {
+                sysEnvVars = execSync('printenv').toString();
+                sysEnvVars = sysEnvVars.replace(/\n$/, '').split(/\n/g);
+                var len = sysEnvVars.length, i = 0;
+                while ( Array.isArray(sysEnvVars) && i < len ) {
+                    let arr = sysEnvVars[i].split(/\=/);
+                    self.contexts['sysEnvVars']['$'+arr[0]] = arr[1];
+                    i++
+                }
+                sysEnvVars = null;
+            } catch (err) {
+                return throwError(500, err, true)
+            }
+
+
             ContextHelper.initialized = true;
             ContextHelper.instance = self
         }
@@ -50,12 +69,31 @@ function ContextHelper(contexts) {
         return self
     }
 
+    var getUserHome = function() {
+        var home = os.homedir ? os.homedir : function() {
+            var homeDir = process.env[(isWin32()) ? 'USERPROFILE' : 'HOME'];
+
+            if ( !homeDir || homeDir == '' ) {
+                throw new Error('Home directory not defined or not found !');
+            }
+
+            if ( !isWritableSync(homeDir) ) {
+                throw new Error('Home directory found but not writable: need permissions for `'+ homeDir +'`');
+            }
+
+            return homeDir;
+        };
+
+        return home()
+    };
+
     self.configure = function(contexts) {
         joinContext(contexts)
     }
 
     joinContext = function(context) {
-        merge(self.contexts, context, true)
+        // merge(self.contexts, context, true)
+        self.contexts = merge(self.contexts, context, true)
     }
 
     var parseCtxObject = function (o, obj) {
@@ -141,6 +179,92 @@ function ContextHelper(contexts) {
         }
     }
 
+    /**
+     * resetContext
+     *
+     * Mostly used by logger container definitions orout of context threads (workers ?)
+     *
+     * TODO - Check if it can be called in `gna.js` & remove at the same time useless calls of setPath() & setContext()
+     */
+    resetContext = function() {
+        setPath('gina.root', getEnvVar('GINA_DIR'));
+        var frameworkPath = getEnvVar('GINA_FRAMEWORK_DIR');
+        setPath('framework', frameworkPath);
+        setPath('gina.core', getEnvVar('GINA_CORE'));
+        setPath('gina.lib', _(frameworkPath +'/lib'));
+        setPath('gina.helpers', _(frameworkPath +'/helpers'));
+        setPath( 'node', _(process.argv[0]), true);
+        var projects    = require( _(getEnvVar('GINA_HOMEDIR') + '/projects.json', true) );
+        var projectName = getContext('projectName');
+        var root        = projects[projectName].path;
+        setPath('project', root);
+        var env         = getContext('env');
+        var isDev       = (env === projects[projectName]['dev_env']) ? true: false;
+        var bundlesPath = projects[projectName]['path'] + '/bundles'; // by default
+        var isProductionScope = (projects[projectName]['production_scope'] === projects[projectName]['def_scope']) ? true: false;
+        if (isDev) {
+            bundlesPath = projects[projectName]['path'] + '/src'
+        } else if (isProductionScope) {
+            bundlesPath = projects[projectName]['path'] + '/releases'
+        }
+        setPath('bundles', _(bundlesPath, true));
+        var bundle = getContext('bundle');
+        var bundlePath = getPath('project') + '/';
+
+        var modulesPackage = _(root + '/manifest.json');
+        var project     = {}
+            , bundles   = []
+        ;
+
+        if ( fs.existsSync(modulesPackage) ) {
+            try {
+                var dep = require(modulesPackage);
+                if ( typeof(dep['bundles']) == "undefined") {
+                    dep['bundles'] = {};
+                }
+
+                if (
+                    typeof(dep['bundles']) != "undefined"
+                    && typeof(project['bundles']) != "undefined"
+                ) {
+
+                    for (let d in dep) {
+                        if (d == 'bundles') {
+                            for (var p in dep[d]) {
+                                project['bundles'][p] = dep['bundles'][p];
+                            }
+                        } else {
+                            project[d] = dep[d];
+                        }
+
+                    }
+                } else {
+                    project = dep;
+                }
+
+                for (let b in project.bundles) {
+                    bundles.push(b)
+                }
+            } catch (err) {
+                throw err
+            }
+        }
+
+        bundlePath += ( isDev ) ? project.bundles[ bundle ].src : project.bundles[ bundle ].link;
+        setPath('bundle', _(bundlePath, true));
+        setPath('helpers', _(bundlePath+'/helpers', true));
+        setPath('lib', _(bundlePath+'/lib', true));
+        setPath('models', _(bundlePath+'/models', true));
+        setPath('controllers', _(bundlePath+'/controllers', true));
+
+        setContext('envs', projects[projectName].envs);
+        setContext('bundles', bundles);
+        // setContext('gina.lib', lib);
+        // setContext('gina.Config', Config);
+        // setContext('gina.locales', locales);
+        // setContext('gina.plugins', plugins);
+    }
+
 
     var throwError = function(code, err, isFatal) {
         var router      = getContext('router');
@@ -211,7 +335,7 @@ function ContextHelper(contexts) {
 
                 ctx.gina.config = merge(ctx.config, ctx.gina.Config);
             }
-            for (var name in ctx) {
+            for (let name in ctx) {
                 setContext(name, ctx[name], false)
             }
 
@@ -255,20 +379,26 @@ function ContextHelper(contexts) {
             }
         }
 
-        var env = ctx.env || GINA_ENV;
-        var envIsDev = ( /^true$/i.test(process.env.NODE_ENV_IS_DEV) ) ? true : false;
-        var Config = ctx.gina.Config;
-        var conf = null;
+        var env                 = ctx.env || getEnvVar('GINA_ENV');
+        var envIsDev            = ( /^true$/i.test(process.env.NODE_ENV_IS_DEV) ) ? true : false;
+        var scope               = ctx.scope || getEnvVar('GINA_SCOPE');
+        var scopeIsLocal        = ( /^true$/i.test(process.env.NODE_SCOPE_IS_LOCAL) ) ? true : false;
+        var scopeIsProduction   = ( /^true$/i.test(process.env.NODE_SCOPE_IS_PRODUCTION) ) ? true : false;
+        var Config              = ctx.gina.Config;
+        var conf                = null;
 
         if (Config.instance && typeof(Config.instance.env) != 'undefined') {
             conf = Config.instance
         } else {
             conf = new Config({
-                env: env,
-                projectName: getContext('projectName'),
-                executionPath: getPath('project'),
-                startingApp: bundle,
-                ginaPath: getPath('gina').core
+                env                 : env,
+                scope               : scope,
+                scopeIsLocal        : scopeIsLocal,
+                scopeIsProduction   : scopeIsProduction,
+                projectName         : getContext('projectName'),
+                executionPath       : getPath('project'),
+                startingApp         : bundle,
+                ginaPath            : getPath('gina').core
             }).getInstance(bundle);
         }
 
@@ -284,10 +414,11 @@ function ContextHelper(contexts) {
         } else {
 
             try {
-                conf.bundlesConfiguration.conf.bundle = bundle;
-                conf.bundlesConfiguration.conf.env = env;
-                conf.bundlesConfiguration.conf.projectName = getContext('projectName');
-                conf.bundlesConfiguration.conf.bundles = getContext('bundles');
+                conf.bundlesConfiguration.conf.bundle       = bundle;
+                conf.bundlesConfiguration.conf.env          = env;
+                conf.bundlesConfiguration.conf.scope        = scope;
+                conf.bundlesConfiguration.conf.projectName  = getContext('projectName');
+                conf.bundlesConfiguration.conf.bundles      = getContext('bundles');
 
                 if ( typeof(ctxFilename) != 'undefined' ) {
                     //process.stdout.write('TYPEOF ' + typeof( conf.getRouting ) )
@@ -360,15 +491,22 @@ function ContextHelper(contexts) {
             }
         }
 
-        var env         = process.env.NODE_ENV || GINA_ENV;
-        var envIsDev    = ( /^true$/i.test(process.env.NODE_ENV_IS_DEV) ) ? true : false;
-        var Config      = ctx.gina.Config;
+        var env                 = process.env.NODE_ENV || GINA_ENV;
+        var envIsDev            = ( /^true$/i.test(process.env.NODE_ENV_IS_DEV) ) ? true : false;
+        var scope               = process.env.NODE_SCOPE || GINA_SCOPE;
+        var scopeIsLocal        = ( /^true$/i.test(process.env.NODE_SCOPE_IS_LOCAL) ) ? true : false;
+        var scopeIsProduction   = ( /^true$/i.test(process.env.NODE_SCOPE_IS_PRODUCTION) ) ? true : false;
+        var Config              = ctx.gina.Config;
+
         var conf = new Config({
-            env             : env,
-            projectName     : getContext('projectName'),
-            executionPath   : getPath('project'),
-            startingApp     : bundle,
-            ginaPath        : getPath('gina').core
+            env                 : env,
+            scope               : scope,
+            scopeIsLocal        : scopeIsLocal,
+            scopeIsProduction   : scopeIsProduction,
+            projectName         : getContext('projectName'),
+            executionPath       : getPath('project'),
+            startingApp         : bundle,
+            ginaPath            : getPath('gina').core
         }).getInstance(bundle);
 
         if ( typeof(lib) != 'undefined' ) {
@@ -401,10 +539,13 @@ function ContextHelper(contexts) {
                     };
 
                     return new LibClass ({
-                        bundle      : bundle,
-                        env         : env,
-                        cacheless   : envIsDev,
-                        libPath     : libPath
+                        bundle              : bundle,
+                        env                 : env,
+                        cacheless           : envIsDev,
+                        scope               : scope,
+                        scopeIsLocal        : scopeIsLocal,
+                        scopeIsProduction   : scopeIsProduction,
+                        libPath             : libPath
                     })
 
                 } catch(err) {
@@ -424,6 +565,7 @@ function ContextHelper(contexts) {
 
     }
 
+
     /**
      * Whisper
      * Convert replace constant names dictionary by its value
@@ -434,7 +576,6 @@ function ContextHelper(contexts) {
      * @returns {object} revealed
      * */
     whisper = function(dictionary, replaceable, rule) {
-
         if ( typeof(rule) != 'undefined') {
             return replaceable
                 // inline rule
@@ -451,49 +592,65 @@ function ContextHelper(contexts) {
                 // .replace(/\{(\w+)\}/g, function(s, key) {
                 //     return dictionary[key] || s;
                 // })
-        } else {
+        }
 
-            if ( typeof(replaceable) == 'object' &&  !/\[native code\]/.test(replaceable.constructor) ||  typeof(replaceable) == 'function' ) { // /Object/.test(replaceable.constructor)
-                for (let attr in replaceable) {
-                    if ( typeof(replaceable[attr]) != 'function') {
-                        replaceable[attr] = (typeof(replaceable[attr]) != 'string' && typeof(replaceable[attr]) != 'object') ? JSON.stringify(replaceable[attr], null, 2) : replaceable[attr];
-                        if (replaceable[attr] && typeof(replaceable[attr]) != 'object') {
-                            replaceable[attr] = replaceable[attr]
-                                .replace(/\"\{(\w+)\}\"/g, function(s, key) {
-                                    if ( /^(true|false|null)$/i.test(dictionary[key]) ) {
-                                        return (/^(true|false|null)$/i.test(dictionary[key])) ? dictionary[key] : s
-                                    }
-                                    return '"'+ (dictionary[key] || s) +'"';
-                                })
-                                .replace(/\{(\w+)\}/g, function(s, key) {
-                                    return dictionary[key] || s;
-                                })
-                        }
+        if ( typeof(replaceable) == 'object' &&  !/\[native code\]/.test(replaceable.constructor) ||  typeof(replaceable) == 'function' ) { // /Object/.test(replaceable.constructor)
+            for (let attr in replaceable) {
+                if ( typeof(replaceable[attr]) != 'function') {
+                    replaceable[attr] = (typeof(replaceable[attr]) != 'string' && typeof(replaceable[attr]) != 'object') ? JSON.stringify(replaceable[attr], null, 2) : replaceable[attr];
+                    if (replaceable[attr] && typeof(replaceable[attr]) != 'object') {
+                        replaceable[attr] = replaceable[attr]
+                            .replace(/\"\{(\w+)\}\"/g, function(s, key) {
+                                if ( /^(true|false|null)$/i.test(dictionary[key]) ) {
+                                    return (/^(true|false|null)$/i.test(dictionary[key])) ? dictionary[key] : s
+                                }
+                                return '"'+ (dictionary[key] || s) +'"';
+                            })
+                            .replace(/\{(\w+)\}/g, function(s, key) {
+                                return dictionary[key] || s;
+                            })
                     }
                 }
-                return replaceable
-            } else { // mixing with classes
-                replaceable = JSON.stringify(replaceable, null, 2);
-
-                return JSON.parse(
-                    replaceable
-                        .replace(/\"\{(\w+)\}\"/g, function(s, key) {
-                            if ( /^(true|false|null)$/i.test(dictionary[key]) ) {
-                                return (/^(true|false|null)$/i.test(dictionary[key])) ? dictionary[key] : s
-                            }
-                            // When "{single}" and not "{sigle}/something"
-                            if ( /^\"\{(\w+)\}\"$/i.test(s) && !dictionary[key]) {
-                                //return ('"'+ dictionary[key] +'"' || s);
-                                return '"'+ (dictionary[key] || s.replace(/\"/g, '')) +'"';
-                            }
-                            return '"'+ (dictionary[key] || s) +'"';
-                        })
-                        .replace(/\{(\w+)\}/g, function(s, key) {
-                            return dictionary[key] || s;
-                        })
-                )
             }
+            return replaceable
         }
+        // mixing with classes
+        replaceable = JSON.stringify(replaceable, null, 2);
+
+        return JSON.parse(
+            replaceable
+                .replace(/\"\{(\w+)\}\"/g, function(s, key) {
+                    if ( /^(true|false|null)$/i.test(dictionary[key]) ) {
+                        return (/^(true|false|null)$/i.test(dictionary[key])) ? dictionary[key] : s
+                    }
+                    // When "{single}" and not "{sigle}/something"
+                    if ( /^\"\{(\w+)\}\"$/i.test(s) && !dictionary[key]) {
+                        //return ('"'+ dictionary[key] +'"' || s);
+                        return '"'+ (dictionary[key] || s.replace(/\"/g, '')) +'"';
+                    }
+                    return '"'+ (dictionary[key] || s) +'"';
+                })
+                .replace(/\{(\w+)\}/g, function(s, key) {
+                    return dictionary[key] || s;
+                })
+                // OS Environment Variables
+                .replace(/\"\~\/\"|\"\$([_A-Z0-9]+)\"/g, function(s, key) {
+                    if ( /^(true|false|null)$/i.test(self.contexts['sysEnvVars'][s]) ) {
+                        return (/^(true|false|null)$/i.test(self.contexts['sysEnvVars'][s])) ? self.contexts['sysEnvVars'][s] : null
+                    }
+                    // When "$SINGLE" and not "$SINGLE/something"
+                    if ( /^\"\$([_A-Z0-9]+)\"$/i.test(s) && !self.contexts['sysEnvVars'][s]) {
+                        return '"'+ (self.contexts['sysEnvVars'][s] || null) +'"';
+                    }
+                    if ( /^\"\~\/\"$/i.test(s) && !self.contexts['sysEnvVars'][s]) {
+                        return '"'+ (self.contexts['sysEnvVars'][s] || null) +'"';
+                    }
+                    return '"'+ (self.contexts['sysEnvVars'][s] || null) +'"';
+                })
+                .replace(/\~\/|\$([_A-Z0-9]+)/g, function(s, key) {
+                    return self.contexts['sysEnvVars'][s] || null;
+                })
+        );
     }
 
     /**
@@ -508,9 +665,9 @@ function ContextHelper(contexts) {
         }
         try {
             Object.defineProperty(global, name.toUpperCase(), {
-                value: value,
-                writable: false,
-                enumerable: true,
+                value       : value,
+                writable    : false,
+                enumerable  : true,
                 configurable: false
             })
         } catch (err) {
@@ -524,12 +681,13 @@ function ContextHelper(contexts) {
      * @returns {array} constants
      * */
     getDefined = function(){
-        var a = [];
-        for (var n in global) {
+        var a = [], n = null;
+        for (n in global) {
             if (n.indexOf('GINA_') > -1 || n.indexOf('USER_') > -1) {
                 a[n] = global[n]
             }
         }
+        n = null;
         return a
     }
 

package/framework/v0.1.2-alpha.1/helpers/data/LICENSE

@@ -0,0 +1,9 @@
+License (MIT)
+
+Copyright © 2023 Martin-Luther ETOUMAN <martin-luther.etouman@gina.io>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/framework/v0.1.2-alpha.1/helpers/data/README.md

@@ -0,0 +1,12 @@
+# json()
+
+**Package:** gina.helpers
+**Name:** json
+
+
+
+## Debuging your test with nodeunit
+
+```tty
+ node --inspect-brk=6959 `which nodeunit` ./test/01-format-data.js
+```

package/framework/v0.1.2-alpha.1/helpers/data/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "data",
+  "version": "1.0.0",
+  "description": "Data helper",
+
+  "author": {
+    "name": "Maritn-Luther ETOUMAN",
+    "email": "martin-luther@gina.io"
+  },
+  "copyright": "Copyright (c) 2009-2023 Rhinostone <contact@gina.io>",
+  "engines": {
+    "node": ">=0.10.22"
+  },
+  "main": "src/main",
+  "scripts": {
+    "test": "nodeunit test"
+  },
+  "license": "MIT",
+  "readmeFilename": "README.md"
+}