gina 0.1.6-alpha.1 → 0.1.6-alpha.11

package/README.md

@@ -32,7 +32,7 @@ Gina aims to be at the same time a framework, a deployment and monitoring enviro
 
 | versions | description |
 |--------|--------|
-| alpha       | Preview release: ==not recomanded for production==      |
+| alpha       | Preview release: <mark>not recomanded for production</mark>      |
 | latest       | Latest stable relase        |
 
 #### 1st method (prefered) - Custom PREFIX
@@ -127,6 +127,7 @@ By starting the framework, you will also start the server.
 ``` tty
 gina start
 ```
+
 __NB.:__ This is an alias for `gina framework:start`
 
 
@@ -135,25 +136,17 @@ A project is a collection of bundles (applicaitons or services). See it as a rep
 
 Let's create our first project and install Gina.
 
-```tty
-cd ~/Sites
-```
-
 
-``` tty
-mkdir myproject && cd myproject
-```
-
-
-Then you need to __initialize your project__
+We will __initialize our project__ under `~/Sites`
 
 > On Windows from the Windows CLI, you might need admin privileges.
 
 ```  tty
-gina project:add @myproject
+gina project:add @myproject --path=~/Sites/myproject
 ```
 
 If you need to remove this project later
+
 ```  tty
 gina project:rm @myproject
 ```
@@ -172,6 +165,7 @@ Ok ! Let's do it !
 ``` tty
 gina bundle:add frontend @myproject
 ```
+
 __NB.:__ If you are launching the command from the project directory, you don't need to add `@myproject`. The same goes for all bundles commands.
 
 We have just created a frontend application that will host our homepage.
@@ -204,6 +198,7 @@ gina bundle:stop frontend @myproject
 ```
 
 If you need to restart you bundle
+
 ```tty
 gina bundle:restart frontend @myproject
 ```
@@ -217,7 +212,9 @@ Let's add a view on our frontend
 ```tty
 gina view:add frontend @myproject
 ```
+
 Then restart your bundle
+
 ```tty
 gina bundle:restart frontend @myproject
 ```
@@ -247,17 +244,19 @@ You can check which are the environments set for your projects
 ```tty
 gina env:list
 ```
+
 __or for a particular project__
+
 ```tty
 gina env:list @myproject
 ```
 
-__NB.:__ when adding an environement, you will do so for the entire project.
+__NB.:__ When adding an environement, you will do so for the entire project.
 
 #### Setting your application starting environment on runtime
 > This method does not memorize the selected environment as the default one for your application
 
-You can have multiple environments for your project and decide to pick one as the starting env by using `--env=your_env` every time you have to run a bundle.
+You can have multiple environments for your project and decide to pick one as the starting env by using `--env=<your_env>` every time you have to run a bundle.
 
 ```tty
 gina bundle:start frontend @myproject --env=prod
@@ -282,21 +281,27 @@ gina project:build prod @myproject
 
 
 #### Other operations you can apply to your environment:
+
 __Adding a new environment for your project__
+
 ```tty
 gina env:add staging @myproject
 ```
+
 __Removing an existing environment for your project__
+
 ```tty
 gina env:rm staging @myproject
 ```
 
 __Defining an existing environment as `development` (you can only have one like this)__
+
 ```tty
 gina env:link-dev <your new dev env>
 ```
 
 __Benefits from using a `development` environment__
+
 You will not have to restart your bundle anytime you modify files inside directories like :
 - /controllers
 - /public
@@ -342,7 +347,7 @@ So to handle log storage for your application, you have 2 options: see 2nd & 3rd
 
 __2nd Method - Old school way__
 
-> __Attention: __ You will have to handle yourself [log rotation](https://linux.die.net/man/8/logrotate)
+> With this method, you will have to handle yourself [log rotation](https://linux.die.net/man/8/logrotate)
 
 ```tty
 gina bundle:start frontend @myproject --log > /usr/local/var/log/gina/frontend.myproject.app.log 2>&1
@@ -367,7 +372,7 @@ You might need to restart the gina :
 gina restart
 ```
 
-__NB.: __For development purposes, using the CLI `gina tail` is still a better option because you will have a better overview of what is really going on for all your application at once & for the framework.
+__NB.:__ For development purposes, using the CLI `gina tail` is still a better option because you will have a better overview of what is really going on for all your application at once & for the framework.
 
 #### Setting default log level
 
@@ -392,7 +397,7 @@ gina framework:set --log-level=debug
 ### Installing a certificate
 
 > __Attention__
-> ==One certificate per bundle/service==
+> <mark>One certificate per bundle/service</mark>
 
 You now want to install a certificate for your project in order to run your project with HTTPS scheme or with HTTP/2 protocol ?
 At this moment, Gina does not generate a cetificate for you, but you can use a service like [sslforfree](https://www.sslforfree.com) to genreate a free 90 days certificate, then install it into your Gina home directory depending on the scope of your host (targeted machine: local or production).

package/framework/v0.1.6-alpha.11/VERSION

@@ -0,0 +1 @@
+0.1.6-alpha.11

package/framework/v0.1.6-alpha.11/core/asset/plugin/dist/vendor/gina/css/gina.min.css.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"/usr/local/lib/node_modules/gina/framework/v0.1.6-alpha.11/core/asset/plugin/dist/vendor/gina/css/gina.min.css","sourcesContent":[]}

package/framework/{v0.1.6-alpha.1 → v0.1.6-alpha.11}/core/asset/plugin/dist/vendor/gina/js/gina.js

@@ -18752,6 +18752,8 @@ define( 'helpers/binding',[],function() { return BindingHelper });
 // nodejs dependencies
 if ( typeof(module) !== 'undefined' && module.exports) {
     var fs              = require('fs');
+    var os              = require('os');
+    var dns             = require('dns');
     var execSync        = require('child_process').execSync;
     var util            = require('util');
     var promisify       = util.promisify;
@@ -19028,6 +19030,59 @@ function Domain(options, cb) {
         loadPSL(self.options, cb);
     }
 
+    /**
+     * Usage : await domainInstance.getFQDN()
+     * @param {string} hostname (one that can be resolved)
+     *
+     * @return {string} fqdn
+     */
+    var getFQDN = async function(hostname) {
+        var host = (
+            typeof(hostname) != 'undefined'
+            && hostname != ''
+        ) ? hostname : os.hostname();
+        if ( /\./.test(host) ) {
+            return host
+        }
+
+        console.debug('[DOMAIN][getFQDN] UQDN: ' + host);
+        var ipObj       = null
+            , err       = null
+        ;
+        ipObj = await promisify(dns.lookup)(host, { hints: dns.ADDRCONFIG || dns.V4MAPPED })
+                    .then( function onIP(result) {
+                        console.debug('[DOMAIN][getFQDN] IP: ' + result.address);
+                        console.debug('[DOMAIN][getFQDN] FAMILY: ' + result.family);
+
+                        return result;
+                    })
+                    .catch( function onIPErr(_err) {
+                        err = _err;
+                    });
+        if (err) {
+            throw err;
+        }
+        host = await promisify(dns.lookupService)(ipObj.address, 0)
+                    .then( function onLookupService(result) {
+                        console.debug('[DOMAIN][getFQDN] FQDN: ' + result.hostname);
+                        console.debug('[DOMAIN][getFQDN] Service: ' + result.service);
+
+                        return result.hostname;
+                    })
+                    .catch( function onLookupServiceErr(err) {
+                        err = _err;
+                    });
+        if (err) {
+            throw err;
+        }
+
+        if ( !/\./.test(host) ) {
+            throw new Error('[DOMAIN][getFQDN] `'+ host +'` is not a FQDN !');
+        }
+
+        return host;
+    }
+
 
     /**
      * Load a json file and removing comments if found
@@ -19138,7 +19193,8 @@ function Domain(options, cb) {
     };
     // Backend proto only
     if (!isGFFCtx) {
-        _proto.updatePSL = updatePSL;
+        _proto.updatePSL    = updatePSL;
+        _proto.getFQDN      = getFQDN;
     }
     // Frontend only
     else {