gina 0.0.9-p91c → 0.1.1-alpha.3

package/framework/v0.1.1-alpha.3/lib/cmd/framework/tail.js

@@ -0,0 +1,183 @@
+var fs          = require('fs');
+var util        = require('util');
+var net         = require('net');
+
+var CmdHelper       = require('./../helper');
+var console         = lib.logger;
+var LoggerHelper    = require( _(GINA_FRAMEWORK_DIR + '/lib/logger/src/helper.js', true) );
+
+/**
+ * Framework tail
+ *
+ * e.g.
+ *  gina framework:tail
+ *  or
+ *  gina tail
+ *
+ * */
+function Tail(opt, cmd) {
+    var self        = {};
+    var nIntervId   = null;
+    var mqPortFile  = _(GINA_DIR +'/tmp/mq-listener-v'+ GINA_VERSION +'.port', true);
+
+    var init = function(opt, cmd) {
+        
+        console.debug('Getting framework logs');
+        
+        // import CMD helpers
+        new CmdHelper(self, opt.client, { port: opt.debugPort, brkEnabled: opt.debugBrkEnabled });
+                        
+        // check CMD configuration
+        //if (!isCmdConfigured()) return false;
+        
+        // handle server not started yet or server exited
+        process.on('gina#mqlistener-started', function onGinaStarted(mqPort) {
+            clearInterval(nIntervId);
+            nIntervId = null;
+            opt.port = mqPort;
+            tail(opt, cmd);
+        });
+                
+        // if (!self.name) {
+        //     status(opt, cmd, 0);
+        // } else {
+            tail(opt, cmd);
+        // }        
+    }
+    
+        
+    var tail = function(opt, cmd) {
+        
+        var port = opt.port || 8125;
+        var clientOptions = {
+            port    : port,
+            request : 'tail' 
+        }
+        var loggerOptions   = console.getOptions();
+        var loggers         = console.getLoggers();
+        var loggerHelper    = LoggerHelper(loggerOptions, loggers);
+        var format          = loggerHelper.format;
+        
+        var delayedMessages = [];
+        var resumeTail = function() {
+            var i = 0;
+            while (i < delayedMessages.length) {
+                let pl = delayedMessages[i];
+                
+                process.stdout.write( format(pl.group, pl.level, pl.content) );
+                i++;
+            }
+            delayedMessages = []
+        }
+        
+        
+        var client = net.createConnection(clientOptions, () => {
+            
+            // 'connect' listener.
+            console.resumeReporting();
+            console.info('[MQTail] connected to server :)');            
+            
+            // send request
+            client.write( JSON.stringify(clientOptions) +'\r\n');
+            
+        });
+        client.on('error', (data) => {
+            var err = data.toString();
+            console.error('[MQTail] ' + err + ' - Gina might not be running');
+            console.info('[MQTail] waitting for `MQListener` to be started ...');
+            
+            var mqPort = null;            
+            nIntervId = setInterval(() => {
+                try {
+                    mqPort = ~~(fs.readFileSync(mqPortFile).toString());
+                    if (mqPort) {
+                        process.emit('gina#mqlistener-started', mqPort);
+                    }
+                } catch (fileErr) {}
+            }, 100);
+        });
+        
+        var payloads = null, i = null;
+        client.on('data', (data) => {
+            //console.log('[MQTail]  (data): ' + data.toString());
+            payloads = data.toString();
+                
+            // from speakers & tail
+            if ( /^(\{\"|\[\{\")/.test(payloads) ) {
+                payloads = payloads.split(/\r\n/g);
+                //console.log(payloads);
+                i = -1; 
+                while(i < payloads.length) { 
+                    i++;
+                    let payload = payloads[i];
+                    if ( 
+                        /^\{/.test(payload) && /\}$/.test(payload)
+                        || /^\[\{/.test(payload) && /\}\]$/.test(payload) 
+                    ) {
+                        let pl = null;
+                        try {
+                            pl = JSON.parse(payload);
+                        } catch(plErr) {
+                            process.stdout.write( '[MQTail] (exception) '+ payload +'\n' );
+                            continue;
+                        }                
+                            
+                        
+                        if (!pl.content) {                            
+                            // only for debug
+                            // process.stdout.write( '[MQTail] (undefined content) '+ JSON.stringify(pl, null) +'\n' );
+                            
+                            // updating logger context since it can run on different processes
+                            if ( pl.sessionId && !clientOptions.sessionId ) {
+                                clientOptions.sessionId = pl.sessionId;
+                                // acknowledging
+                                client.write( JSON.stringify(clientOptions) +'\r\n');
+                            }
+                            
+                            if (pl.loggers) {
+                                loggers = merge(loggers, pl.loggers);
+                                if (delayedMessages.length > 0) {
+                                    resumeTail()
+                                }
+                            }                            
+                            continue;
+                        }
+                        
+                        // only for debug
+                        //process.stdout.write(  '[MQTail] '+ pl.content +'\n' );
+                        
+                        try {                            
+                            process.stdout.write( format(pl.group, pl.level, pl.content) );
+                        } catch (writeErr) {
+                            // means that the related MQSpeaker is not connected yet
+                            // this can happen during `bundle:start` configuration
+                            // we'll then delay the output until MQSpeaker is ready
+                            delayedMessages.push(pl);
+                        }
+                        
+                    }                        
+                }                
+            }
+            
+        });
+        client.on('end', () => {
+            console.warn('[MQTail] disconnected from server');
+            console.info('[MQTail] waitting for `MQListener` to be started ...');
+            var mqPort = null;            
+            nIntervId = setInterval(() => {
+                try {
+                    mqPort = ~~(fs.readFileSync(mqPortFile).toString());
+                    if (mqPort) {
+                        process.emit('gina#mqlistener-started', mqPort);
+                    }
+                } catch (fileErr) {}
+            }, 100);
+        });
+        // setInterval(() => {}, 1 << 30);
+    }
+    
+
+    init(opt, cmd);    
+}
+
+module.exports = Tail;

package/framework/v0.1.1-alpha.3/lib/cmd/framework/version.js

@@ -0,0 +1,44 @@
+var os = require('os');
+var fs = require('fs');
+var console = lib.logger;
+
+function Version(opt){
+
+    var init = function(opt){
+        var vers = "",
+            short = ( typeof(process.argv[3]) != 'undefined') ? process.argv[3]: false,
+            msg = require('./msg.json'),
+            version = {
+                "number"        : GINA_VERSION,
+                "platform"      : process.platform,
+                "arch"          : process.arch,
+                "middleware"    : fs.readFileSync(_( opt.frameworkPath + '/MIDDLEWARE')).toString() || 'none',
+                "copyright"     : require(opt.pack).copyright
+            };
+
+        vers = msg.basic[4]
+            .replace(/%version%/, version.number +' '+ version.platform +' '+ version.arch + ' (MIT)')
+            .replace(/%middleware%/, version.middleware)
+            .replace(/%copyright%/, version.copyright);
+
+        if (typeof(GINA_VERSION) != "undefined") {
+            if (short && (short.split(/=/))[1] == 'true' ) {
+                console.log(version.number)
+            } else {
+                console.log(vers)
+            }
+        } else {
+            console.error(msg.basic[5])
+        }
+
+        // end();
+    };
+
+    var end = function(err) {
+        process.exit( err ? -1:0 )
+    }
+
+    init(opt)
+};
+
+module.exports = Version

package/framework/v0.1.1-alpha.3/lib/cmd/gina-dev.1.md

@@ -0,0 +1,66 @@
+gina-dev(1) -- Command line interface
+=============================================
+
+## NAME
+
+**gina dev**
+
+## SYNOPSIS
+
+**gina dev** [ **option** ]
+
+or
+
+**gina f**:[ **task** ] [ **arguments** ]
+
+
+## DESCRIPTION
+**gina framework** alows you to perform tasks on the framework and its services.
+
+## OPTIONS
+
+**-h**, **--help** Prints help for **gina dev** command.
+
+## TASKS
+
+**man**
+
+    Generate manpage.
+
+
+## ARGUMENTS
+
+
+
+## EXEMPLE
+
+**gina dev**'s command line only works if the framework is running.
+
+e.g. Generate and link manpages using groff and html style.
+
+~~~ tty
+$ gina dev:man --groff --html=/custom/path
+~~~
+
+
+
+
+## AUTHOR
+
+Martin-Luther ETOUMAN was the original author of **gina-dev**. Stephane HEAV joined the project since version 0.1.0.
+
+## COPYRIGHT
+Copyright (c) 2009-{year} Rhinostone <{email}>
+
+## SEE ALSO
+
+**gina**(1), **gina-project**(1), **gina-bundle**(1), **gina-model**(1)
+
+## COLOPHON
+
+This page is part of release {version} of the **gina** project. A description of the project,
+and informations about reporting bugs can be found on the official web site: <http://www.gina.io/>
+
+The project is also on GitHub: <https://github.com/rhinostone/gina>
+
+Here is the mailling list: <https://groups.google.com/forum/#!forum/ginajs>

package/framework/v0.1.1-alpha.3/lib/cmd/gina-framework.1.md

@@ -0,0 +1,100 @@
+gina-framework(1) -- Framework CLI
+=============================================
+
+## SYNOPSIS
+
+**gina framework** [ **option** ]
+
+**gina framework**:[ **task** ] [ **service** | **arguments** ]
+
+**gina framework**:[ **task** ] [ **service**] [ **arguments** ]
+
+
+## DESCRIPTION
+**gina framework** alows you to perform tasks on the framework and its services.
+
+## OPTIONS
+
+**-t**, **--status**
+		Get status of the framework.
+
+**-h**, **--help**
+		Prints help for **gina framework** command.
+
+## TASKS
+
+**-s**, **start**
+		Starts the framework.
+
+**-k**, **stop** | **kill**
+		Stops the framework.
+
+**-r**, **restart**
+    	Restarts the framework.
+
+**-u**, **update**
+    	Get status of the framework.
+
+**-e**, **set**
+		Set environment variables
+
+
+## ENVIRONMENT ARGUMENTS
+
+**--version=val**
+    	Tells Gina to run services with a specific framework version.
+
+e.g. Start Gina using v0.1.5 of the framework
+
+~~~ tty
+$ gina framework:start --version=0.1.5
+~~~
+
+> N.B.: This will override default settings. See `gina-framework` manpage.
+
+**--env=val**
+    	Tells Gina to run services with a specific framework environment.
+
+e.g. Runs the framework with development environment
+~~~tty
+$ gina framework:start --env=dev
+
+~~~
+
+**--node-version=val**
+    	It is the **Node.js** version, the binary used by Gina.
+        More than one version at the time can be used.
+
+## EXEMPLE
+
+**gina**'s command line only works if the framework is started.
+You can start the framwork this way
+
+~~~ tty
+$ gina framework:start
+~~~
+or by using the alias
+~~~ tty
+$ gina start
+~~~
+
+
+## AUTHOR
+
+Martin-Luther ETOUMAN was the original Author of **gina**. Stephane HEAV joined the project since version 0.1.0.
+
+## COPYRIGHT
+Copyright (c) 2009-{year} Rhinostone <contact@gina.io>
+
+## SEE ALSO
+
+**gina**(1), **gina-project**(1), **gina-bundle**(1), **gina-model**(1)
+
+## COLOPHON
+
+This page is part of release {version} of the **gina** project. A description of the project,
+and informations about reporting bugs can be found on the official web site: <http://www.gina.io/>
+
+The project is also on GitHub: <https://github.com/rhinostone/gina>
+
+Here is the mailling list: <https://groups.google.com/forum/#!forum/ginajs>

package/framework/v0.1.1-alpha.3/lib/cmd/gina.1.md

@@ -0,0 +1,79 @@
+gina(1) -- CLI
+=============================================
+
+## NAME
+**gina**
+
+## SYNOPSIS
+**gina**	[ **option** ]
+**gina**	[ **assetic**:**task**] [ **arguments** ]
+**gina**	[ **assetic**:**task**] [ **service** ] [ **arguments** ]
+
+## DESCRIPTION
+Gina is a MVC & Events Driven Framework that allows you to create.
+
+## OPTIONS
+**-v**, **--version**			Prints current framework version.
+
+**-h**, **--help**			   Prints.
+
+## ASSETICS
+env
+framework
+project
+bundle
+model
+dev
+view
+
+## ENVIRONMENT
+
+**--version** | **GINA_VERSION**
+		Will override the default framework **version** used by Gina.
+
+**--env** | **GINA_ENV**
+    	Will override the runtime environment.
+
+**--node-version** | **GINA_NODE_VERSION**
+    	Will override the **Node.js** version, the binary used by Gina.
+        More than one version at the time can be used.
+
+**--debug-brk** | **GINA_DEBUG_BRK**
+
+**--logs-path** | **GINA_LOGS_PATH**
+
+**--tmp-path** | **GINA_TMP_PATH**
+
+## EXEMPLE
+
+**gina**'s command line only works if the framework is started.
+You can start the framwork this way
+
+~~~ tty
+$ gina framework:start
+~~~
+or by using the alias
+~~~ tty
+$ gina start
+~~~
+
+
+## AUTHOR
+
+Martin-Luther ETOUMAN was the original Author of **gina**. Stephane HEAV joined the project since version 0.1.0.
+
+## COPYRIGHT
+Copyright (c) 2009-{year} Rhinostone <{email}>
+
+## SEE ALSO
+
+**gina-env**(1), **gina-framework**(1), **gina-project**(1), **gina-bundle**(1), **gina-model**(1), **gina-dev**(1)
+
+## COLOPHON
+
+This page is part of release {version} of the **gina** project. A description of the project,
+and informations about reporting bugs can be found on the official web site: <http://www.gina.io/>
+
+The project is also on GitHub: <https://github.com/rhinostone/gina>
+
+Here is the mailling list: <https://groups.google.com/forum/#!forum/ginajs>