Merge branch 'release/2.0.0'

.doclets.yml

@@ -1,7 +1,13 @@
-dir: src
-
 packageJson: package.json
 
+dir: src
+
 articles:
+  - Overview: readme.md
 
-  - Overview: readme.md 
+branches:
+  - master
+  - develop
+  - feature/*
+  - release/*
+  - hotfix/*

.eslintrc.js

@@ -0,0 +1,148 @@
+module.exports = {
+    extends : [
+        'eslint:all'
+    ],
+    globals : {
+        'define': true,
+        'module': true,
+        'require' : true,
+        'console' : true,
+
+        // typed arrays
+        'Int8Array' : true,
+        'Uint8Array' : true,
+        'Uint8ClampedArray' : true,
+        'Int16Array' : true,
+        'Uint16Array' : true,
+        'Int32Array' : true,
+        'Uint32Array' : true,
+        'Float32Array' : true,
+        'Float64Array' : true
+    },
+    'parserOptions': {
+        'ecmaVersion': 6
+    },
+    rules : {
+        'strict': 'off',
+        'padded-blocks': 'off',
+        'func-names': 'off',
+        'no-var' : 'off',
+        'sort-vars' : 'off',
+        'no-multi-spaces': 'off',
+        'init-declarations': 'off',
+        'prefer-arrow-callback' : 'off',
+        'func-style': 'off',
+        'no-plusplus': 'off',
+        'no-continue': 'off',
+        'no-prototype-builtins': 'off',
+        'vars-on-top': 'error',
+        'prefer-reflect': 'off',
+        'space-unary-ops': 'off',
+        'key-spacing' : 'off',
+        'callback-return' : 'off',
+        'no-implicit-coercion' : 'off',
+        'no-negated-condition' : 'off',
+        'guard-for-in' : 'off',
+        'no-lonely-if' : 'off',
+        'no-self-compare': 'off',
+        'no-inline-comments' : 'off',
+        'lines-around-comment' : 'off',
+        'no-underscore-dangle': 'off',
+        'no-unused-expressions': 'off',
+        'one-var': 'off',
+        'indent': 'off',
+        'arrow-body-style' : 'off',
+        'wrap-regex' : 'off',
+        'sort-keys': 'off',
+        'consistent-return' : 'off',
+        'no-param-reassign' : 'off',
+        'no-use-before-define' : 'off',
+        'valid-jsdoc' : 'off',
+        'no-console': [
+            'error', {
+                allow: [
+                    'warn',
+                    'error'
+                ]
+            }
+        ],
+        'new-cap': [
+            'error', {
+                'newIsCap': false,
+                'capIsNew': true,
+            }
+        ],
+        'comma-dangle' : [
+            'error', 'always-multiline'
+        ],
+        'max-params': [
+            'error', 5
+        ],
+        'max-lines': [
+            'error', {
+                'max' : 999,
+                'skipBlankLines' : true,
+                'skipComments' : true
+            }
+        ],
+        'quote-props': [
+            'error',
+            'as-needed', {
+                'keywords': false
+            }
+        ],
+        'space-in-parens': 'off',
+        'id-length': [
+            'error', {
+                'exceptions': [
+                    'i', 'j', 'p', 'n', 'x', 'y', 'w', 'h'
+                ]
+            }
+        ],
+        'linebreak-style': [
+            'error', 'unix'
+        ],
+        'complexity': [
+            'error', 50
+        ],
+        'max-statements': [
+            'error', 40
+        ],
+        'max-len': [
+            'error', 120, 4
+        ],
+        'camelcase': [
+            'error', {
+                'properties': 'never'
+            }
+        ],
+        'quotes' : [
+            'error', 'single', {
+                'avoidEscape' : true,
+                'allowTemplateLiterals' : true
+            }
+        ],
+        'default-case': [
+            'error', {
+                'commentPattern' : '^skip\\sdefault'
+            }
+        ],
+        'no-magic-numbers': [
+            'error', {
+                'ignore' : [-1, 0, 1, 2],
+                'ignoreArrayIndexes' : true
+            }
+        ],
+        'space-before-function-paren': [
+            'error', {
+                'anonymous' : 'never',
+                'named' : 'never'
+            }
+        ],
+        'prefer-const' : [
+            'error', {
+                'ignoreReadBeforeAssign' : true
+            }
+        ],
+    }
+};

.gitattributes

@@ -1 +1,59 @@
+# General .gitattributes v1.0.0
+
+# Auto detect text files and perform LF normalization
 * text=auto
+* eol=lf
+
+# These files are text and should be normalized (Convert crlf => lf)
+*.php text
+*.css text
+*.scss text
+*.sass text
+*.js text
+*.htm text
+*.html text
+*.xml text
+*.txt text
+*.ini text
+*.inc text
+.htaccess text
+
+# These files are binary and should be left untouched
+# images
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.gif binary
+*.ico binary
+*.psd  binary
+*.ai  binary
+
+# fonts
+*.ttf binary
+*.woff binary
+*.woff2 binary
+*.eot binary
+
+# documents
+*.pdf  binary
+*.doc  binary
+*.docx  binary
+
+# compressed formats
+*.zip  binary
+*.tar  binary
+*.gz  binary
+*.rar  binary
+*.7z binary
+
+# executables
+*.phar binary
+*.exe  binary
+
+# media formats
+*.mov binary
+*.mp4 binary
+*.mp3 binary
+*.flv binary
+*.fla binary
+*.swf binary

.gitignore

@@ -1,22 +1,17 @@
-# IntelliJ IDEA project folder
-.idea
+# IntelliJ project directory
+.idea/
 
-# Vagrant VM folder
-.vagrant
+# Vagrant VM directory
+.vagrant/
 
-# Code coverage reports
-coverage
+# Node project dependencies
+/node_modules/
 
-# Node dependencies
-node_modules
+# Code coverage report
+/cov/
 
 # Logs
 /npm-debug.log
 
-# Custom environment data
-.env.yml
-
-# Byte-compiled / optimized / DLL files
-__pycache__/
-*.py[cod]
-*$py.class
+# Required data for publishing project
+/.publish.json

.npmignore

@@ -1,21 +1,26 @@
-# editorconfig.org
-.editorconfig
+# IntelliJ project directory
+/.idea/
 
-# Git attributes
-.gitattributes
+# Vagrant VM directory
+/.vagrant/
 
-# Code coverage reports
-coverage
+# code coverage directory (for development)
+/cov/
 
-# Vagrant files and folders
-    # Vagrant provision folder
-    vagrant
+# scripts directory (for development)
+/scripts/
 
-    # Vagrant VM file
-    vagrantfile
+# license template for minimized version (for development)
+/src/license-header-template.json
 
-# Gulp tasks folder
-gulp
+# tests directory (for development)
+/tests/
 
-# Tests folder
-tests
+.doclets.yml
+.editorconfig
+.eslintrc.js
+.gitattributes
+.npmignore
+.publish.json
+.travis.yml
+vagrantfile

.travis.yml

@@ -3,6 +3,7 @@ language: node_js
 node_js:
   - stable
   - "6"
+  - "6.1"
   - "5"
   - "5.1"
   - "4"
@@ -12,4 +13,3 @@ node_js:
 
 script:
   - npm run ci
-  - npm run coveralls

dist/exception/InvalidGlobException.js

@@ -0,0 +1,21 @@
+'use strict';
+
+const Exception = require(`js-lang-exception`);
+
+const ID = 1001;
+
+module.exports = class InvalidGlobException extends Exception {
+
+    /**
+     * @return {number} Exception ID
+     */
+    static get ID() {
+        return ID;
+    }
+
+    constructor(glob) {
+        const type = typeof glob;
+
+        super(`Invalid glob, the glob most be a string or an array, got: "${type}"`, ID);
+    }
+};

dist/exception/InvalidPathNameException.js

@@ -0,0 +1,19 @@
+'use strict';
+
+const Exception = require(`js-lang-exception`);
+
+const ID = 1002;
+
+module.exports = class InvalidPathNameException extends Exception {
+
+    /**
+     * @return {number} Exception ID
+     */
+    static get ID() {
+        return ID;
+    }
+
+    constructor(pathName) {
+        super(`Invalid path name, the path name must be a non-empty string, got: "${pathName}"'`, ID);
+    }
+};

dist/exception/PathNotFoundException.js

@@ -0,0 +1,23 @@
+'use strict';
+
+const Exception = require(`js-lang-exception`);
+
+const ID = 1003;
+
+module.exports = class PathNotFoundException extends Exception {
+
+    /**
+     * @return {number} Exception ID
+     */
+    static get ID() {
+        return ID;
+    }
+
+    constructor(pathName, glob = null) {
+        if (glob !== null) {
+            super(`Path not found with name: "${pathName}", glob: "${glob}"'`, ID);
+        } else {
+            super(`Path not found with name: "${pathName}"'`, ID);
+        }
+    }
+};