gina 0.0.9-p91b → 0.1.1-alpha.2

package/framework/v0.1.1-alpha.2/lib/cmd/project/help.txt

@@ -0,0 +1,76 @@
+******************************
+* Project command lines e.g. *
+******************************
+
+
+[ Add a new project ]
+
+    You have 2 ways of creating your project
+
+    1st method
+    ----------
+    $ gina project:add @<project_name> [ —-path=/var/www/<project_name> ] (if no path given, will take the current)
+
+    where `/var/www/<project_name>` is the destination path
+    NB.: `--path` can also be a relative path like `--path=./` or `--path=./<project_name>`
+    If you do not specifiy a `<project_name>` for the `--path` argument , gina will reuse the one you used with `@<project_name>`
+    
+    This command line also supports relative path like `--path=./<project_name>`
+
+    2nd method
+    ----------
+    From current project path : project name will be by default the current project folder name
+    $ gina project:add
+
+
+[ List projects ]
+
+    $ gina project:list [ [ —-more ] | [-b | —-with-bundles] | [-e | -—with-envs] ]
+
+
+[ Start project ]
+
+    $ gina project:start @<project_name> [ —-env=staging, --inspect-brk=5000 ]
+
+
+[ Restart project ]
+
+    Will restart project with the last known environment
+
+    $ gina project:restart @<project_name>
+
+
+[ Stop project ]
+
+    Will restart project with the last known environment
+
+    $ gina project:stop @<project_name>
+
+
+
+[ Remove an existing project ]
+
+    $ gina project:remove @<project_name> [ -f (remove all related sources without prompting) ]
+
+
+[ Rename project ]
+
+    $ gina project:rename @<project_name> @<new_project_name>
+
+
+[ Backup project ]
+
+    N.B.: Only available when ordering for supoort
+
+    $ gina project:backup @<project_name> —-path=/var/dump —-with-password
+
+
+[ Restore project ]
+
+    N.B.: Only available when ordering for support
+
+    $ gina project:restore /var/dump/myproject.tar.gz (will restore in current path)
+    or
+    $ gina project:restore myproject.tar.gz  (will restore from current path to current path: myproject.gna must be under the PWD)
+    or
+    $ gina project:restore /var/dump/myproject.tar.gz —-path=/other/path

package/framework/v0.1.1-alpha.2/lib/cmd/project/import.js

@@ -0,0 +1,2 @@
+// alias
+module.exports = require('./add')

package/framework/v0.1.1-alpha.2/lib/cmd/project/list.js

@@ -0,0 +1,55 @@
+var fs = require('fs');
+
+var CmdHelper   = require('./../helper');
+var console     = lib.logger;
+/**
+ * List all registerd projects
+ * Available options:
+ *  --more (to display more infos)
+ *
+ * TODO : check if path exists and add in front of each a green check or a red cross
+ * TODO : --help
+ * TODO : switch options for `$ gina project:list [ [ —-more ] | [-b | —-with-bundles] | [-e | -—with-envs] ]`
+ * */
+function List(opt, cmd){
+
+    var self = {};
+
+    var init = function(){
+
+        // import CMD helpers
+        new CmdHelper(self, opt.client, { port: opt.debugPort, brkEnabled: opt.debugBrkEnabled });
+
+        // check CMD configuration
+        if ( !isCmdConfigured() ) return false;
+
+        var projects = self.projects
+            , list = []
+            , str = ''
+            , more = (process.argv[3] && /^(?:\-\-more$)/.test(process.argv[3])) ? true : false ;
+
+        for (var p in projects) {
+            list.push(p)
+        }
+        list.sort();
+
+        for(var l=0; l<list.length; ++l) {
+            if ( fs.existsSync(projects[ list[l]].path) ) {
+                str += '[ ok ] '+ list[l];
+                if (more)
+                    str += '\n\r\t'+ projects[ list[l] ].path;
+                str += '\n\r';
+            } else {
+                str += '[ ?! ] '+ list[l];
+                if (more)
+                    str += '\n\r\t'+projects[ list[l] ].path + ' <- where is it ?';
+                str += '\n\r';
+            }
+        }
+        console.log(str.substr(0, str.length-2))
+    }
+
+    init()
+};
+
+module.exports = List

package/framework/v0.1.1-alpha.2/lib/cmd/project/remove.js

@@ -0,0 +1,144 @@
+var fs          = require('fs');
+var CmdHelper   = require('./../helper');
+var readline    = require('readline');
+var rl          = readline.createInterface(process.stdin, process.stdout);
+
+var console = lib.logger;
+
+/**
+ * Remove project or unregister existing one from `~/.gina/projects.json`.
+ * */
+function Remove(opt, cmd) {
+    var self = {};
+
+    var init = function() {
+
+        // import CMD helpers
+        new CmdHelper(self, opt.client, { port: opt.debugPort, brkEnabled: opt.debugBrkEnabled });
+
+        // check CMD configuration
+        if ( !isCmdConfigured() ) return false;
+
+        var err         = false
+            , folder    = new _(self.projectLocation)
+            , force     = ( typeof(self.params['force']) != 'undefined' ) ? self.params['force'] : false;
+
+
+        if ( !folder.existsSync() ) {
+            console.error('project [ '+ self.projectName+' ] was not found at this location: ' + folder.toString() );
+            process.exit(1)
+        }
+
+        if ( typeof(self.projects[self.projectName]) == 'undefined' ) {
+            console.error('project [ '+ self.projectName + ' ] not found in `~/.gina/projects.json`');
+            
+            process.exit(1)
+        }
+
+
+        prompt(force, function(force){
+
+
+            if ( folder.isValidPath() && force ) {
+
+                if ( !folder.existsSync() ) {
+                    console.warn('project path not found at: ', folder.toString() );
+                    end()
+                }
+
+                folder = folder.rmSync();
+                if (folder instanceof Error) {
+                    console.error(folder.stack);
+                    process.exit(1)
+                }
+            }
+           
+            end(true)
+        })
+    }
+    
+
+    var prompt = function(force, cb) {
+        if (!force) {
+            rl.setPrompt('Also remove project sources ? (Y/n):');
+            rl.prompt();
+        } else {
+            cb(true)
+        }
+
+        rl.on('line', function(line) {
+            switch( line.trim().toLowerCase() ) {
+                case 'y':
+                case 'yes':
+                    cb(true);
+                    break;
+                case 'n':
+                case 'no':
+                    cb(false);
+                    break;
+                default:
+                    console.log('Please, write "yes" or "no" to proceed.');
+                    rl.prompt();
+                    break;
+            }
+        }).on('close', function() {
+            console.log('\nCommand cancelled !');
+            process.exit(0)
+        })
+    }
+
+
+    var end = function(removed) {
+        
+        // removing ports
+        var ports               = JSON.clone(self.portsData)
+            , portsReverse      = JSON.clone(self.portsReverseData)
+            , reversePortValue  = null
+            , re                = null
+        ;
+
+        for (var protocol in ports) {
+            
+            for (var scheme in ports[protocol]) {
+                
+                for (var port in ports[protocol][scheme]) {
+
+                    re = new RegExp("\@"+ self.projectName +"\/");
+                    
+                    if ( re.test(ports[protocol][scheme][port]) ) { 
+                        // reverse ports
+                        reversePortValue = ports[protocol][scheme][port].split('/')[0];
+                        if ( typeof(portsReverse[reversePortValue]) != 'undefined' ) {
+                            delete portsReverse[reversePortValue];
+                        } 
+                        
+                        // ports                                           
+                        delete ports[protocol][scheme][port];
+                    }                    
+                }
+            }                    
+        }
+
+        // now writing
+        lib.generator.createFileFromDataSync(ports, self.portsPath);
+        lib.generator.createFileFromDataSync(portsReverse, self.portsReversePath);
+        
+        
+        var target = _(GINA_HOMEDIR + '/projects.json');
+        delete self.projects[self.projectName];
+        lib.generator.createFileFromDataSync(
+            self.projects,
+            target
+        )
+        
+
+        if (removed)
+            console.log('Project [ '+ self.projectName +' ] removed');
+
+        process.exit(0)
+    };
+
+    init()
+};
+
+module.exports = Remove

package/framework/v0.1.1-alpha.2/lib/cmd/project/rename.js

@@ -0,0 +1,162 @@
+var fs          = require('fs');
+
+var CmdHelper   = require('./../helper');
+var console     = lib.logger;
+
+/**
+ * Rename existing project.
+ * */
+function Rename(opt, cmd) {
+
+    var self    = {}
+        , local = {
+            source: null,
+            target: null
+        }
+    ;
+
+    var init = function() {
+
+        // import CMD helpers
+        new CmdHelper(self, opt.client, { port: opt.debugPort, brkEnabled: opt.debugBrkEnabled });
+
+        // check CMD configuration
+        if ( !isCmdConfigured() ) return false;
+
+        if ( self.projectArgvList.length != 2 ) {
+            console.error('This command line is expecting 2 arguments: @<old_project> and @<new_project>');
+            process.exit(1)
+        }
+
+        local.source = self.projectName;
+        local.target = self.projectArgvList[1];
+
+
+        if ( !isDefined('project', local.target) ) {
+            rename()
+        } else {
+            console.error('New project name [ '+local.target+' ] is already taken !');
+            process.exit(1)
+        }
+    }
+
+
+    var rename = function() {
+
+        self.projects[local.target] = JSON.clone(self.projects[local.source]);
+
+        // renaming folder !
+        if (!self.projects[local.source].path || self.projects[local.source].path == '') {
+            console.error("It seems like this project does not have a path :'(");
+            process.exit(1)
+        }
+
+        var folder = new _(self.projects[local.source].path)
+            , re = new RegExp("\/"+folder.toArray().last()+"$")
+            , target = folder.toUnixStyle().replace(re, '/'+ local.target)
+            , project = {}// local manifest.json
+            , pack = {};// local pakage.json
+
+            
+            
+        folder.mv(target, function(err){
+            console.debug('bundles => ', JSON.stringify(self.bundles, null, 4));
+            console.debug('project => ', JSON.stringify(self.projects, null, 4));
+            if (err) {
+                console.error(err.stack);
+                process.exit(1)
+            }
+
+            
+            
+            // renaming project in config files
+            self.projects[local.target].path = target;
+
+            if ( fs.existsSync( _(target +'/manifest.json') )) {
+                project = require(_(target +'/manifest.json'));
+                project['name'] = local.target;
+                lib.generator.createFileFromDataSync(
+                    project,
+                    _(target +'/manifest.json')
+                )
+            }
+
+            if ( fs.existsSync( _(target +'/package.json') )) {
+                pack = require(_(target +'/package.json'));
+                if ( typeof(pack['name']) != 'undefined' ) {
+                    pack.name = local.target;
+                    lib.generator.createFileFromDataSync(
+                        pack,
+                        _(target +'/package.json')
+                    )
+                }
+            }
+
+            // updating projects
+            delete self.projects[local.source];
+            
+            
+            
+
+            // renaming & update ports
+            var ports               = JSON.clone(self.portsData)
+                , portsReverse      = JSON.clone(self.portsReverseData)
+                , re                = null
+                , projectValue      = null
+                , portsReverseStr   = null
+            ;
+
+            portsReverseStr = JSON.stringify(portsReverse);
+            for (var protocol in ports) {
+                
+                for (var scheme in ports[protocol]) {
+                    
+                    for (var port in ports[protocol][scheme]) {
+
+                        re = new RegExp("\@"+ local.source +"\/");
+
+                        if ( re.test(ports[protocol][scheme][port]) ) {
+
+                            projectValue = ( ports[protocol][scheme][port].split('/')[0] ).split('@')[1];
+
+                            ports[protocol][port] = ports[protocol][scheme][port].replace(re, "@"+ local.target +"/");
+
+
+                            portsReverseStr = portsReverseStr.replace( new RegExp('\@'+ projectValue, 'g'), '@'+ local.target );
+
+                        }
+                    }
+                }                    
+            }
+            portsReverse = JSON.parse(portsReverseStr);
+
+
+            // now writing
+            lib.generator.createFileFromDataSync(ports, self.portsPath);
+            lib.generator.createFileFromDataSync(portsReverse, self.portsReversePath);
+
+            end(true)
+        })
+    }
+
+    var end = function(renamed) {
+        var target = _(GINA_HOMEDIR + '/projects.json')
+            , projects = self.projects;
+
+
+        // writing file
+        lib.generator.createFileFromDataSync(
+            projects,
+            target
+        )
+
+        if (renamed)
+            console.log('project [ '+ local.source +' ] renamed to [ ' + local.target + ' ]');
+
+        process.exit(0)
+    }
+
+    init()
+};
+
+module.exports = Rename

package/framework/v0.1.1-alpha.2/lib/cmd/project/rm.js

@@ -0,0 +1,2 @@
+// alias
+module.exports = require('./remove')

package/framework/v0.1.1-alpha.2/lib/cmd/project/status.js

@@ -0,0 +1,3 @@
+/**
+ * Created by martinlutheretouman on 2/5/15.
+ */

package/framework/v0.1.1-alpha.2/lib/cmd/protocol/help.js

@@ -0,0 +1,27 @@
+var fs          = require('fs');
+
+var CmdHelper   = require('./../helper');
+var console     = lib.logger;
+
+/**
+ * Help
+ *
+ * */
+function Help(opt, cmd) {
+    var self = {};
+
+    var init = function() {
+
+        // import CMD helpers
+        new CmdHelper(self, opt.client, { port: opt.debugPort, brkEnabled: opt.debugBrkEnabled });
+
+        // check CMD configuration
+        if ( !isCmdConfigured() ) return false;
+
+
+        getHelp();
+    };
+
+    init();
+}
+module.exports = Help;

package/framework/v0.1.1-alpha.2/lib/cmd/protocol/help.txt

@@ -0,0 +1,57 @@
+******************************
+* Protocol command lines e.g. *
+******************************
+
+Protocols represents the kind of server you want to attach to your bundle.
+By default, Gina uses `http` server and will therefore launch an http instance of
+your server.
+you have with `gina:protocol` the ability to change the type of intance you
+want your bundle to run with.
+Gina allows you to set protocol instances like https, http/2 :
+this will determining the prefered protocol used when your bundle
+will interact with other application as a client (agent). Don't worry you
+still have the choice in the end.
+
+N.B.: You need to restart your bundle or you whole project if you are not running with a developer environment
+
+
+[ Listing installed protocols ]
+
+    $ gina protocol:list <bundle_name> @<project_name>
+
+    or
+
+    $ gina protocol:list <bundle_name> @<project_name>/<environment>
+
+
+
+[ Set a protocol ]
+
+    Setting up a new protocol or selecting an existing one
+    ----------
+
+    Allows you to install or to select a protocol for an existing bundle. Use the following command line.
+    
+    Set default a protocol for all your bundle :
+    - If no <protocol> is mentioned, you will be prompted to enter an existing protocol
+
+    $ gina protocol:set <bundle_name> @<project_name>
+    
+    Set default a protocol for all your project :
+    - If no <protocol> is mentioned, you will be prompted to enter an existing protocol
+
+    $ gina protocol:set @<project_name>
+
+
+
+[ Remove a protocol ]
+
+    Removing a protocol
+    ----------
+
+    To remove a protocol for an existing bundle, use the following command line.
+    
+    Set default a protocol for all your bundle's environments :
+    - If no <protocol> is mentioned, you will be prompted to enter an existing protocol
+
+    $ gina protocol:remouve <bundle_name> @<project_name>