WIP 0.0.4: semistandard style, allowing to call module and task with absolute and relative paths

Author: cmtt

.jshintrc

@@ -481,6 +481,12 @@ let di = require('gulp-di')(gulp, {
 
 ## Changelog
 
+0.0.4 - 0?/??/2016
+
+  - task() and module() may take absolute or relative paths
+  - using a fork of [node-introspect](https://github.com/orzarchi/node-introspect.git) instead of [parse-function](https://github.com/tunnckoCore/parse-function)
+  - adopting [https://github.com/Flet/semistandard](semistandard) style
+
 0.0.33 - 05/03/2016
 
   - Updating depencendies and adapting to changes

README.md

@@ -0,0 +1,5 @@
+'use strict';
+
+module.exports = function (PI) {
+  return PI / 180;
+};

contrib/examples/deg-to-rad.js

@@ -0,0 +1,3 @@
+'use strict';
+
+module.exports = () => Math.PI;

contrib/examples/pi.js

@@ -0,0 +1,5 @@
+'use strict';
+
+module.exports = function (PI) {
+  return 180 / PI;
+};

contrib/examples/rad-to-deg.js

@@ -0,0 +1,5 @@
+'use strict';
+
+module.exports = function (RAD_TO_DEG) {
+  return (radians) => radians * RAD_TO_DEG;
+};

contrib/examples/to-deg.js

@@ -0,0 +1,5 @@
+'use strict';
+
+module.exports = function (DEG_TO_RAD) {
+  return (degrees) => degrees * DEG_TO_RAD;
+};

contrib/examples/to-rad.js

@@ -7,7 +7,6 @@
  */
 
 function getPath (obj, key) {
-
   key = typeof key !== 'undefined' ? key : null;
 
   if (key === null) {

contrib/get-path.js

@@ -1,8 +1,6 @@
 'use strict';
-/*jshint -W089 */
 
 module.exports = function HelpTask (gulp) {
-
   /**
    * Modifies the gulp.task() function and builds a list of all tasks.
    *
@@ -32,7 +30,6 @@ module.exports = function HelpTask (gulp) {
   let log = this.byId('log', true) || console.log.bind(console);
 
   const parseFn = require('parse-function');
-  const util = require('util');
   const extractComments = require('extract-comments');
   const _task = gulp.task;
   const taskInfo = {};
@@ -69,10 +66,10 @@ module.exports = function HelpTask (gulp) {
     if (typeof fn === 'function') {
       let info = parseFn(fn.toString());
       entry = {
-        name : id
+        name: id
       };
-      entry.description = util.format('Runs the %s task (no description)', id);
-      let comments = extractComments(info.body, {first : true});
+      entry.description = `Runs the ${id} task (no description)`;
+      let comments = extractComments(info.body, {first: true});
       if (comments.length) {
         let comment = comments[0];
         let lines = comment.raw
@@ -84,17 +81,17 @@ module.exports = function HelpTask (gulp) {
       }
     } else if (id === 'default') {
       entry = {
-        name : 'default',
-        description : 'Runs the default tasks: ' + deps.join(' ')
+        name: 'default',
+        description: 'Runs the default tasks: ' + deps.join(' ')
       };
     }
 
     if (entry) {
       entry.deps = deps;
       if (DEBUG) {
-        let line = ['Adding', chalk.cyan(entry.name), 'task'];
+        let line = [`Adding ${chalk.cyan(entry.name)} task`];
         if (deps.length) {
-          line.push(' - depending on ',chalk.magenta(deps.join(' ')));
+          line.push(` - depending on ${chalk.magenta(deps.join(' '))}`);
         }
         log.apply(chalk, line);
       }
@@ -109,7 +106,6 @@ module.exports = function HelpTask (gulp) {
   gulp.task('help', function () {
     /* Prints an overview over all available Gulp tasks. */
 
-    let util = require('util');
     let pad = require('pad');
     let lines = [''];
     let padding = 5;
@@ -124,12 +120,14 @@ module.exports = function HelpTask (gulp) {
     let taskIds = Object.keys(taskInfo);
     let taskLengths = taskIds.map(function (id) { return id.length; });
     let maxLength = Math.max.apply(Math, taskLengths);
-
-    for (let key in taskInfo) {
+    let keys = Object.keys(taskInfo);
+    keys.sort();
+    for (var i = 0; i < keys.length; i++) {
+      let key = keys[i];
       let entry = taskInfo[key];
       let paddingLength = maxLength;
-      let str = new Array(paddingLength+2).join(' ');
-      let descriptionLine = util.format('Runs the %s task.', key);
+      let str = new Array(paddingLength + 2).join(' ');
+      let descriptionLine = `Runs the ${key} task.`;
       if (entry.description) descriptionLine = mapDescription(str, entry.description);
       lines.push(' ' + pad(entry.name, maxLength) + paddingStr + descriptionLine.join('\n').trim());
       lines.push('');
@@ -147,13 +145,12 @@ module.exports = function HelpTask (gulp) {
      * @private
      */
 
-    function mapDescription(str, lines) {
+    function mapDescription (str, lines) {
       if (typeof lines === 'string') lines = [lines];
       return lines.map(function (line, index) {
         line = line.trim();
         return index ? str + paddingStr + line : line;
       });
     }
   });
-
 };

contrib/help.js

@@ -1,10 +1,9 @@
 'use strict';
 
 module.exports = function RunningTasks (gulp) {
-
   const DEBUG = this.options.DEBUG;
   let log = this.byId('log', true) || console.log.bind(console);
-  let gutil = this.byId('gutil', true) || { env : { _ : process.argv }};
+  let gutil = this.byId('gutil', true) || { env: { _: process.argv } };
 
   /**
    * Adds a function returning an array of strings, containing all current
@@ -15,8 +14,8 @@ module.exports = function RunningTasks (gulp) {
    * ````js
    * module.exports = function (gulp, log, Package, runningTasks) {
    *   gulp.task('info', function () {
-   *     log('Building ' + chalk.magenta(Package.name) + ', running: ' + chalk.cyan(runningTasks().join(' ')));
-   *   });
+   *     log('Building ' + chalk.magenta(Package.name) + ', running: ' + chalk.cyan(runningTasks().join(' ')))
+   *   })
    * }
    * ````
    *
@@ -33,9 +32,7 @@ module.exports = function RunningTasks (gulp) {
     let taskNames = Object.keys(gulp.tasks);
     // Filter all available task names using gutil.env._
 
-    let cliTasks = taskNames.filter(function (name) {
-      return !!~args.indexOf(name);
-    });
+    let cliTasks = taskNames.filter((name) => args.indexOf(name) > -1);
 
     // Include the names of depending tasks
 
@@ -47,5 +44,4 @@ module.exports = function RunningTasks (gulp) {
     }
     return tasks;
   });
-
 };

contrib/running-tasks.js

@@ -17,7 +17,6 @@ const path = require('path');
  */
 
 function standardTask (name, src, dest) {
-
   let args = _.toArray(arguments).slice(3); // dependencies
   let stack = null;
   let filename = '<unknown>';
@@ -69,7 +68,7 @@ function standardTask (name, src, dest) {
     }
 
     return gulp.src("${src}")
-    .pipe(plugin(${ args || 'void 0' }))
+    .pipe(plugin(${args || 'void 0'}))
     .pipe(gulp.dest("${dest}"));
   });
 `;

contrib/standard-task.js

@@ -1 +1 @@
-module.exports = require('./lib/di');
+module.exports = require('./lib/gulp-di');

index.js

@@ -0,0 +1,13 @@
+'use strict';
+
+/**
+ * @method DependencyError
+ * @private
+ * @param {string} id
+ */
+
+function DependencyError (id) {
+  return Error('Unknown dependency: ' + id);
+}
+
+module.exports = DependencyError;