react 0.5.2 → 0.6.0

package/test/task.mocha.js

@@ -0,0 +1,42 @@
+'use strict';
+/*global react:true taskUtil:true */
+
+if (typeof(chai) === 'undefined') {
+  var chai = require('chai');
+}
+
+if (typeof(react) === 'undefined') {
+  var react = require('../'); //require('react');
+}
+
+if (typeof(taskUtil) === 'undefined') {
+  var taskUtil = require('../lib/task.js');
+}
+
+(function () {
+
+  var t = chai.assert;
+
+  /**
+     Testing ...
+  */
+
+  suite('task');
+
+  function foo() { }
+  function bar() { }
+
+  test('missing types are guessed from params', function (done) {
+    var ast = {
+      inParams: ['a'], 
+      tasks: [
+        { f: foo, a: ['a'], out: ['baz'] },
+      ],
+      outTask: { a: ['baz'] }
+    };
+    taskUtil.setMissingType(ast.tasks[0]);
+    t.equal(ast.tasks[0].type, 'cb');
+    done();
+  });
+
+}());  

package/test/validate-cb-task.mocha.js

@@ -0,0 +1,100 @@
+'use strict';
+/*global react:true util:true sprintf:true validate:true */
+
+if (typeof(chai) === 'undefined') {
+  var chai = require('chai');
+}
+
+if (typeof(react) === 'undefined') {
+  var react = require('../'); //require('react');
+}
+
+if (typeof(util) === 'undefined') {
+  var util = require('util');
+}
+
+if (typeof(sprintf) === 'undefined') {
+  var sprintf = require('../lib/sprintf');
+}
+
+if (typeof(validate) === 'undefined') {
+  var validate = require('../lib/validate.js');
+}
+
+(function () {
+
+  var t = chai.assert;
+
+  /**
+     Testing validation of cb tasks
+  */
+
+  suite('validate-cb-task');
+
+  function foo() { }
+
+
+  test('cbTask requires f, a, out', function (done) {
+    var ast = {
+      inParams: ['a'], 
+      tasks: [{ type: 'cb' }],
+      outTask: { a: ['bar'] }
+    };
+    var msg = sprintf('cbTask requires f, a, out - %s',
+                      util.inspect(ast.tasks[0]));
+    t.deepEqual(validate(ast), [msg]);  
+    done();
+  });
+  
+  test('cbTask verifies f type', function (done) {
+    var ast = {
+      inParams: ['a'], 
+      tasks: [{ type: 'cb', f: foo, a: [], out: [] }],
+      outTask: { a: ['bar'] }
+    };
+    ast.tasks[0].f = 123; //err should be fn or string
+    var msg = sprintf('cbTask requires f to be a function or string - %s',
+                      util.inspect(ast.tasks[0]));
+    t.deepEqual(validate(ast), [msg]);
+    done();
+  });
+
+  test('cbTask verifies a type', function (done) {
+    var ast = {
+      inParams: ['a'], 
+      tasks: [{ type: 'cb', f: foo, a: [], out: [] }],
+      outTask: { a: ['bar'] }
+    };
+    ast.tasks[0].a = 'foo'; //err should be arr of strings
+    var msg = sprintf('cbTask requires a to be an array of string param names - %s',
+                      util.inspect(ast.tasks[0]));
+    t.deepEqual(validate(ast), [msg]);  
+
+    ast = Object.create(ast);
+    ast.tasks[0].a = ['foo', 1]; //err should be arr of strings
+    msg = sprintf('cbTask requires a to be an array of string param names - %s',
+                  util.inspect(ast.tasks[0]));
+    t.deepEqual(validate(ast), [msg]);  
+    done();
+  });
+
+  test('cbTask verifies out type', function (done) {
+    var ast = {
+      inParams: ['a'], 
+      tasks: [{ type: 'cb', f: foo, a: [], out: [] }],
+      outTask: { a: ['bar'] }
+    };
+    ast.tasks[0].out = 'foo'; //err should be arr of strings
+    var msg = sprintf('cbTask requires out to be an array of string param names - %s',
+                      util.inspect(ast.tasks[0]));
+    t.deepEqual(validate(ast), [msg]);  
+
+    ast = Object.create(ast);
+    ast.tasks[0].out = ['foo', 1]; //err should be arr of strings
+    msg = sprintf('cbTask requires out to be an array of string param names - %s',
+                  util.inspect(ast.tasks[0]));
+    t.deepEqual(validate(ast), [msg]);  
+    done();
+  });
+
+}());

package/test/validate-ret-task.mocha.js

@@ -0,0 +1,110 @@
+'use strict';
+/*global react:true util:true sprintf:true validate:true */
+
+if (typeof(chai) === 'undefined') {
+  var chai = require('chai');
+}
+
+if (typeof(react) === 'undefined') {
+  var react = require('../'); //require('react');
+}
+
+if (typeof(util) === 'undefined') {
+  var util = require('util');
+}
+
+if (typeof(sprintf) === 'undefined') {
+  var sprintf = require('../lib/sprintf');
+}
+
+if (typeof(validate) === 'undefined') {
+  var validate = require('../lib/validate.js');
+}
+
+(function () {
+
+  var t = chai.assert;
+
+  /**
+     Testing validation of return task
+  */
+
+  suite('validate-ret-task');
+
+  function foo() { }
+
+
+  test('retTask requires f, a, out', function (done) {
+    var ast = {
+      inParams: ['a'], 
+      tasks: [{ type: 'ret' }],
+      outTask: { a: ['bar'] }
+    };
+    var msg = sprintf('retTask requires f, a, out - %s',
+                      util.inspect(ast.tasks[0]));
+    t.deepEqual(validate(ast), [msg]);  
+    done();
+  });
+  
+  test('retTask verifies f type', function (done) {
+    var ast = {
+      inParams: ['a'], 
+      tasks: [{ type: 'ret', f: foo, a: [], out: ['bar'] }],
+      outTask: { a: ['bar'] }
+    };
+    ast.tasks[0].f = 123; //err should be fn or string
+    var msg = sprintf('retTask requires f to be a function or string - %s',
+                      util.inspect(ast.tasks[0]));
+    t.deepEqual(validate(ast), [msg]);
+    done();
+  });
+
+  test('retTask verifies a type', function (done) {
+    var ast = {
+      inParams: ['a'], 
+      tasks: [{ type: 'ret', f: foo, a: [], out: ['bar'] }],
+      outTask: { a: ['bar'] }
+    };
+    ast.tasks[0].a = 'foo'; //err should be arr of strings
+    var msg = sprintf('retTask requires a to be an array of string param names - %s',
+                      util.inspect(ast.tasks[0]));
+    t.deepEqual(validate(ast), [msg]);  
+
+    ast = Object.create(ast);
+    ast.tasks[0].a = ['foo', 1]; //err should be arr of strings
+    msg = sprintf('retTask requires a to be an array of string param names - %s',
+                  util.inspect(ast.tasks[0]));
+    t.deepEqual(validate(ast), [msg]);  
+    done();
+  });
+
+  test('retTask verifies out type', function (done) {
+    var ast = {
+      inParams: ['a'], 
+      tasks: [{ type: 'ret', f: foo, a: [], out: ['bar'] }],
+      outTask: { a: ['bar'] }
+    };
+    ast.tasks[0].out = 'foo'; //err should be array with single string or []
+    var msg = sprintf('retTask requires out to be an array with single string param name or [] - %s',
+                      util.inspect(ast.tasks[0]));
+    t.deepEqual(validate(ast), [msg]);  
+
+    ast = Object.create(ast);
+    ast.tasks[0].out = 123; //err should be array with single string or []
+    msg = sprintf('retTask requires out to be an array with single string param name or [] - %s',
+                  util.inspect(ast.tasks[0]));
+    t.deepEqual(validate(ast), [msg]);  
+    done();
+  });
+
+  test('valid retTask', function (done) {
+    var ast = {
+      inParams: ['a'], 
+      tasks: [{ type: 'ret', f: foo, a: [], out: ['bar'] }],
+      outTask: { a: ['bar'] }
+    };
+    t.deepEqual(validate(ast), []);  
+    done();
+  });
+
+}());  

package/test/validate.mocha.js

@@ -0,0 +1,324 @@
+'use strict';
+/*global react:true util:true sprintf:true validate:true taskUtil:true */
+
+if (typeof(chai) === 'undefined') {
+  var chai = require('chai');
+}
+
+if (typeof(react) === 'undefined') {
+  var react = require('../'); //require('react');
+}
+
+if (typeof(util) === 'undefined') {
+  var util = require('util');
+}
+
+if (typeof(sprintf) === 'undefined') {
+  var sprintf = require('../lib/sprintf');
+}
+
+if (typeof(validate) === 'undefined') {
+  var validate = require('../lib/validate.js');
+}
+
+if (typeof(taskUtil) === 'undefined') {
+  var taskUtil = require('../lib/task.js');
+}
+
+(function () {
+
+  var t = chai.assert;
+
+  /**
+     Testing ...
+  */
+
+  suite('validate');
+
+  function foo() { }
+  function bar() { }
+
+  test('empty ast is invalid', function (done) {
+    t.deepEqual(validate(), ['ast must be an object with inParams, tasks, and outTask']);
+    t.deepEqual(validate({}), ['ast must be an object with inParams, tasks, and outTask']);
+    t.deepEqual(validate({ inParams: [] }), ['ast must be an object with inParams, tasks, and outTask']);
+    t.deepEqual(validate({ tasks: [] }), ['ast must be an object with inParams, tasks, and outTask']);
+    t.deepEqual(validate({ tasks: [], outTask: {} }), ['ast must be an object with inParams, tasks, and outTask']);
+    t.deepEqual(validate({ outTask: {} }), ['ast must be an object with inParams, tasks, and outTask']);
+    done();
+  });
+
+  test('ast.inParams must be an array of strings', function (done) {
+    var ast = {
+      inParams: 'a',  //err should be an array
+      tasks: [{ f: foo, a: [], out: ['bar'], type: 'ret' }],
+      outTask: { a: ['bar'] }
+    };
+    t.deepEqual(validate(ast), ['ast.inParams must be an array of strings']);
+
+    ast.inParams = [1]; //err not an array of strings
+    t.deepEqual(validate(ast), ['ast.inParams must be an array of strings']);  
+    done();
+  });
+
+  test('ast.tasks must be an array of tasks', function (done) {
+    var ast = {
+      inParams: ['a'],
+      tasks: 'bar', //err should be array
+      outTask: { a: ['bar'] }
+    };
+    t.deepEqual(validate(ast), ['ast.tasks must be an array of tasks']);
+    done();
+  });
+
+  test('each task must be an object', function (done) {
+    var ast = {
+      inParams: ['a'], 
+      tasks: [1],  //err not array of objects
+      outTask: { a: ['bar'] }
+    };
+    t.deepEqual(validate(ast), ['task must be an object - 1']);  
+    done();
+    
+  });
+
+  
+  test('each task in ast.tasks must match a valid task type', function (done) {
+    var ast = {
+      inParams: ['a'], 
+      tasks: [{ type: 'zoo', f: foo, a: [], out: ['bar'] }], //err wrong type
+      outTask: { a: ['bar'] }
+    };
+    var msg = sprintf('task.type should match one of %s - %s',
+                      taskUtil.taskTypeKeys().join(', '), util.inspect(ast.tasks[0]));
+    t.deepEqual(validate(ast), [msg]);
+    done();
+  });
+
+  test('ast.outTask.a should be an array of string param names', function (done) {
+    var ast = {
+      inParams: ['a'], 
+      tasks: [{ f: foo, a: [], out: ['bar'], type: 'ret' }], 
+      outTask: { a: ['bar'] }
+    };
+    ast.outTask = {}; //err a should be an arr
+    var msg = sprintf('ast.outTask.a should be an array of string param names - %s',
+                      util.inspect({ type: 'finalcb' }));
+    t.deepEqual(validate(ast), [msg]);  
+
+    ast.outTask = { type: 'finalcb', a: 'bar' }; //err a should be an arr
+    msg = sprintf('ast.outTask.a should be an array of string param names - %s',
+                  util.inspect(ast.outTask));
+    t.deepEqual(validate(ast), [msg]);  
+
+    ast.outTask = { type: 'finalcb', a: ['bar', 1] }; //err a should be an arr of strings
+    msg = sprintf('ast.outTask.a should be an array of string param names - %s',
+                  util.inspect(ast.outTask));
+    t.deepEqual(validate(ast), [msg]);  
+
+    ast.outTask = { a: [] }; //valid
+    t.deepEqual(validate(ast), []);  
+    done();
+  });
+
+  test('ast.tasks that specify name need to be unique', function (done) {
+    var ast = {
+      inParams: ['a'], 
+      tasks: [
+        { f: foo, a: [], out: ['bar'], name: 'dog' },
+        { f: foo, a: [], out: ['bar'], name: 'dog' }
+      ], 
+      outTask: { a: ['bar'] }
+    };
+    var msg = sprintf('ast.tasks that specify name need to be unique, duplicate: %s',
+                      'dog');
+    t.deepEqual(validate(ast), [msg]);  
+    done();
+  });
+  
+  test('ast.locals should be non-null if passed in', function (done) {
+    var ast = {
+      inParams: ['a'], 
+      tasks: [{ f: foo, a: [], out: ['bar'], type: 'ret' }],
+      outTask: { a: ['bar'] },
+      locals: null  //err should be non-null if passed in
+    };
+    t.deepEqual(validate(ast), ['ast.locals should not be null']);
+
+    ast.locals = { };
+    t.deepEqual(validate(ast), []);
+    done();
+  });
+
+  test('non-method string functions need to map to fn in locals or in params', function (done) {
+    var ast = {
+      inParams: ['a'], 
+      tasks: [{ f: 'foo', a: [], out: ['bar'], type: 'ret' }],
+      outTask: { a: ['bar'] },
+      locals: { }
+    };
+    var msg = sprintf('function: %s not found in locals or input params - task[%s]', 
+                      'foo', 0);
+    t.deepEqual(validate(ast), [msg]);  
+    done();
+  });
+
+  test('string functions maps to fn in locals', function (done) {
+    var ast = {
+      inParams: ['a'], 
+      tasks: [{ f: 'cat.bar', a: [], out: ['bar'], type: 'ret' }],
+      outTask: { a: ['bar'] },
+      locals: { cat: { bar: foo }}
+    };
+    t.deepEqual(validate(ast), []);  
+    done();
+  });
+
+  test('string functions maps to fn in inputs', function (done) {
+    var ast = {
+      inParams: ['a1', 'dog'], 
+      tasks: [{ f: 'dog.food', a: [], out: ['bar'], type: 'ret' }],
+      outTask: { a: ['bar'] },
+      locals: { }
+    };
+    t.deepEqual(validate(ast), []);  
+    done();
+  });
+
+  test('string functions need to map to fn in locals or in params', function (done) {
+    var ast = {
+      inParams: ['a'], 
+      tasks: [{ f: 'foo.bar', a: [], out: ['bar'], type: 'ret' }],
+      outTask: { a: ['bar'] },
+      locals: { foo: {}}
+    };
+    var msg = sprintf('function: %s not found in locals or input params - task[%s]', 
+                      'foo.bar', 0);
+    t.deepEqual(validate(ast), [msg]);  
+    done();
+  });
+
+  test('param func str fn need to map to fn in locals or in params', function (done) {
+    var ast = {
+      inParams: ['a'], 
+      tasks: [{ f: 'a', a: [], out: ['bar'], type: 'ret' }],
+      outTask: { a: ['bar'] },
+      locals: { }
+    };
+    t.deepEqual(validate(ast), []);  
+    done();
+  });
+
+  test('param obj exist func str needs map to fn in locals or in params', function (done) {
+    var ast = {
+      inParams: ['a'], 
+      tasks: [{ f: 'a.b', a: [], out: ['bar'], type: 'ret' }],
+      outTask: { a: ['bar'] },
+      locals: { }
+    };
+    t.deepEqual(validate(ast), []);  
+    done();
+  });
+
+  test('param obj !exist func str needs map to fn in locals or in params', function (done) {
+    var ast = {
+      inParams: ['a'], 
+      tasks: [{ f: 'd.e', a: [], out: ['bar'], type: 'ret' }],
+      outTask: { a: ['bar'] },
+      locals: { }
+    };
+    t.deepEqual(validate(ast), []);  
+    done();
+  });
+
+  test('multiple tasks output the same param, must be unique', function (done) {
+    var ast = {
+      inParams: ['a'], 
+      tasks: [
+        { f: foo, a: [], out: ['baz', 'c'] },
+        { f: bar, a: [], out: ['c'] }
+      ], 
+      outTask: { a: ['baz'] }
+    };
+    var msg = 'multiple tasks output the same param, must be unique. param: c';
+    t.deepEqual(validate(ast), [msg]);  
+    done();
+  });
+
+  test('missing or mispelled input variable', function (done) {
+    var ast = {
+      inParams: [], 
+      tasks: [
+        { f: foo, a: [], out: [] },
+        { f: bar, a: ['abc'], out: [] }
+      ], 
+      outTask: { a: [] }
+    };
+    var msg = 'missing or mispelled variable referenced in flow definition: abc';
+    t.deepEqual(validate(ast), [msg]);  
+    done();  
+  });
+
+  test('missing or mispelled input variables', function (done) {
+    var ast = {
+      inParams: ['aaa', 'bbb'], 
+      tasks: [
+        { f: foo, a: ['aaa', 'cat'], out: ['ccc'] },
+        { f: bar, a: ['abc', 'bbb', 'ccc'], out: [] }
+      ], 
+      outTask: { a: [] }
+    };
+    var messages = [
+      'missing or mispelled variable referenced in flow definition: cat',
+      'missing or mispelled variable referenced in flow definition: abc'
+    ];
+    t.deepEqual(validate(ast), messages);  
+    done();  
+  });
+
+  test('missing or mispelled final output variables', function (done) {
+    var ast = {
+      inParams: ['aaa'], 
+      tasks: [
+        { f: foo, a: ['aaa'], out: ['bbb'] },
+        { f: bar, a: ['bbb'], out: ['ccc'] }
+      ], 
+      outTask: { a: ['ccc', 'ddd', 'eee'] }
+    };
+    var messages = [
+      'missing or mispelled variable referenced in flow definition: ddd',
+      'missing or mispelled variable referenced in flow definition: eee'
+    ];
+    t.deepEqual(validate(ast), messages);  
+    done();  
+  });
+
+  test('missing or mispelled validation ignores properties', function (done) {
+    var ast = {
+      inParams: ['obj'], 
+      tasks: [
+        { f: foo, a: ['obj.foo'], out: [] },
+        { f: bar, a: ['obj.bar'], out: [] }
+      ], 
+      outTask: { a: ['obj.cat'] }
+    };
+    t.deepEqual(validate(ast), []);  
+    done();  
+  });
+
+  test('missing or mispelled validation ignores literals', function (done) {
+    var ast = {
+      inParams: [], 
+      tasks: [
+        { f: foo, a: ['true', 'false', '123', '123.1', 'null'], out: [] },
+        { f: bar, a: ['-123', '-123.4', '"wow"', "'hey'"], out: [] },
+        { f: foo, a: ['"two-words"', "'also-two'", '"two.words"', "'also.two'"], out: [] },
+        { f: foo, a: ['this'], out: [] }
+      ], 
+      outTask: { a: [] }
+    };
+    t.deepEqual(validate(ast), []);  
+    done();  
+  });
+
+}());