react 0.3.4 → 0.5.2

package/dsl/fstr.js

@@ -1,121 +0,0 @@
-'use strict';
-/*jshint regexp: false */
-
-var sprintf = require('sprintf').sprintf;
-var core = require('../lib/core.js');
-var parse = require('../lib/parse.js');
-var tutil = require('../lib/task.js');
-
-var INPARAMS_NO_MATCH = 'input params in wrong format, wanted "foo, bar" -  found: %s';
-var OUTPARAMS_NO_MATCH = 'output params in wrong format, wanted "foo, bar" - found: %s';
-var INOUT_PARAMS_NO_MATCH = 'task params in wrong format, wanted "foo, bar -> err, baz" - found: %s';
-var EXTRA_TASKARG = 'extra unmatched task arg: %s';
-
-var ERR_NAMES_RE = /^err$/i; // err, ERR, Err, ...
-
-function filterOutLeadingErrParam(args) { // if leading err param, filter it out
-  if (args.length && args[0].match(ERR_NAMES_RE)) args.shift();
-  return args;
-}
-
-
-var inOutDefParse = {
-  regex: /^([^\-]*)(->)?\s*(returns?\s+)?(.*)$/i,  //TODO this will not work if literal has dash
-  fn: function (m) {
-    var reMatchReturns = /returns?/i;
-    return {
-      type: (m[3] && m[3].match(reMatchReturns)) ? 'ret' : 'cb',
-      inDef: parse.splitTrimFilterArgs(m[1]),
-      outDef: filterOutLeadingErrParam(parse.splitTrimFilterArgs(m[4]))
-    };
-  }
-};
-
-function filterOutTrailingCbParam(args) { // if has trailing cb | callback param, filter it out
-  var cbNamesRe = /^cb|callback$/i;  //cb, Cb, CB, callback, Callback
-  if (args.length && args[args.length - 1].match(cbNamesRe)) args.pop();
-  return args;
-}
-
-function parseInParams(str) {
-  var objDef = parse.parseStr(str, [inOutDefParse], INPARAMS_NO_MATCH);
-  objDef.inDef = filterOutTrailingCbParam(objDef.inDef);
-  return objDef;
-}
-
-function parseInOutParams(str) {
-  var objDef = parse.parseStr(str, [inOutDefParse], INOUT_PARAMS_NO_MATCH);
-  objDef.inDef = filterOutTrailingCbParam(objDef.inDef);
-  return objDef;
-}
-
-function parseOutParams(str) {
-  if (str.indexOf('->') === -1) str = '-> ' + str; // prefix so does out err process
-  return parse.parseStr(str, [inOutDefParse], OUTPARAMS_NO_MATCH);
-} 
-
-function parseTasks(arr) {
-  var tasks = [];
-  var fn, obj, result;
-  while (arr.length >= 2) {
-    obj = {};
-    fn = arr.shift();
-    result = parseInOutParams(arr.shift());
-    if (typeof(arr[0]) === 'object') obj = arr.shift(); // has options, use as obj
-    obj.f = fn;
-    obj.a = result.inDef;
-    var type = result.type;
-    obj.out = result.outDef;
-    obj.type = type;
-    tasks.push(obj);
-  }
-  if (arr.length) throw new Error(sprintf(EXTRA_TASKARG, arr[0]));
-  return tasks;
-}
-
-
-function fstrDefine(inParamStr, taskDefArr, outParamStr, options) {
-  if (!inParamStr) inParamStr = '';
-  if (!taskDefArr) taskDefArr = [];
-  if (!outParamStr) outParamStr = '';
-
-  var reactFn = core();
-  var ast = {
-    inParams: parseInParams(inParamStr).inDef,
-    tasks: parseTasks(taskDefArr),
-    outTask: { a: parseOutParams(outParamStr).outDef }
-  };
-  if (options) Object.keys(options).forEach(function (k) { ast[k] = options[k]; });
-  var errors = reactFn.setAndValidateAST(ast);
-  if (errors.length) {
-    var errorStr = errors.join('\n');
-    throw new Error(errorStr);
-  }
-  return reactFn;
-}
-
-function selectFirst(inParamStr, taskDefArr, outParamStr, options) {
-  if (!inParamStr) inParamStr = '';
-  if (!taskDefArr) taskDefArr = [];
-  if (!outParamStr) outParamStr = '';
-  var tasks = tutil.serializeTasks(parseTasks(taskDefArr));
-
-  var reactFn = core();
-  var ast = {
-    inParams: parseInParams(inParamStr).inDef,
-    tasks: tasks,
-    outTask: { type: 'finalcbFirst', a: parseOutParams(outParamStr).outDef },
-  };
-  if (options) Object.keys(options).forEach(function (k) { ast[k] = options[k]; });  
-  var errors = reactFn.setAndValidateAST(ast);
-  if (errors.length) {
-    var errorStr = errors.join('\n');
-    throw new Error(errorStr);
-  }
-  return reactFn;
-}
-
-module.exports = fstrDefine;
-module.exports.selectFirst = selectFirst;
-module.exports.options = core.options;
-module.exports.events = core.events;

package/dsl/pcode.js

@@ -1,175 +0,0 @@
-'use strict';
-/*jshint regexp: false */
-
-var sprintf = require('sprintf').sprintf;
-var core = require('../lib/core.js');
-var parse = require('../lib/parse.js');
-var tutil = require('../lib/task.js');
-
-var INPARAMS_NO_MATCH = 'input params in wrong format, wanted "foo, bar, cb" -  found: %s';
-var OUTPARAMS_NO_MATCH = 'output params in wrong format, wanted "cb(err, foo)" - found: %s';
-var INOUT_PARAMS_NO_MATCH = 'task params in wrong format, wanted "foo, bar := func(baz, cat, cb) " - found: %s';
-var EXTRA_TASKARG = 'extra unmatched task arg: %s';
-
-var ERR_NAMES_RE = /^err$/i; // err, ERR, Err, ...
-
-function filterOutLeadingErrParam(args) { // if leading err param, filter it out
-  if (args.length && args[0].match(ERR_NAMES_RE)) args.shift();
-  return args;
-}
-
-
-/**
-  Examples:
-  var react = require('react');
-  
-  var locals = { falpha: falpha, fbeta: fbeta, fcharlie: fcharlie };
-  var fn = react.pcodeDefine('a, b', [
-    'd := fbeta(a, b)',
-    'e = fcharlie(a, b)',
-    'c := falpha(a, b) when fbeta:done and fcharlie:done',
-    'cb(err, c, d, e);'
-  ], locals);
-
-  function cb(err, d, e) { }
-  fn(10, 20, cb);
- */
-
-function splitAndFilterArgs(commaSepArgs) { // split, trim, filter out empty and (cb or callback)
-  var args = parse.splitTrimFilterArgs(commaSepArgs);
-  var cbNamesRe = /^cb|callback$/i;  //cb, Cb, CB, callback, Callback
-  if (args.length && args[args.length - 1].match(cbNamesRe)) args.pop();
-  return args;
-}
-
-function extractNamesFromWhenClause(str) { //given 'foo:done and bar.baz:done' return ['foo', 'bar.baz']
-  var reSplit = /\s+and\s+/i;
-  var reDone = /^([^:]+):done$/i;
-  var names = str.split(reSplit).map(function (x) {
-    x = x.trim();
-    var m = x.match(reDone); // if foo:done, we'll use foo
-    return (m) ? m[1] : x; 
-  });
-  return names;
-}
-
-var inParse = {
-  regex: /^(.*)$/, 
-  fn: function (m) {
-    return {
-      inDef: splitAndFilterArgs(m[1]),
-    };
-  }
-};
-
-var cbParse = {
-  regex: /^\s*(var\s+)?([^:]*)\s*:=\s*([a-zA-Z0-9_\.\-]+)\s*\(\s*([^)]*)\)\s*(when\s+([^;]+))?;?\s*$/,
-  fn: function (m) {
-    var taskDef = {
-      type: 'cb',
-      f: m[3],
-      inDef: (m[4]) ? splitAndFilterArgs(m[4]) : [],
-      outDef: (m[2]) ? parse.splitTrimFilterArgs(m[2]) : []
-    };
-    if (m[6]) taskDef.after = extractNamesFromWhenClause(m[6]);
-    return taskDef;
-  }
-};
-
-var retParse = {
-  regex: /^\s*(var\s+)?([^:]*)\s*=\s*([a-zA-Z0-9_\.\-]+)\s*\(\s*([^)]*)\)\s*(when\s+([^;]+))?;?\s*$/,
-  fn: function (m) {
-    var taskDef = {
-      type: 'ret',
-      f: m[3],
-      inDef: (m[4]) ? splitAndFilterArgs(m[4]) : [],
-      outDef: (m[2]) ? parse.splitTrimFilterArgs(m[2]) : []
-    };
-    if (m[6]) taskDef.after = extractNamesFromWhenClause(m[6]);
-    return taskDef;
-  }
-};
-
-var finalCbParse = {
-  regex: /^\s*(cb|callback)\s*\(([^)]*)\)\s*;?$/i,
-  fn: function (m) {
-    return {
-      outDef: (m[2]) ? filterOutLeadingErrParam(parse.splitTrimFilterArgs(m[2])) : []
-    };
-  }
-};
-
-function parseInParams(str) {
-  return parse.parseStr(str, [inParse], INPARAMS_NO_MATCH);
-}
-
-function parseTask(str) {
-  var result = parse.parseStr(str, [cbParse, retParse], INOUT_PARAMS_NO_MATCH);
-  var type = result.type;
-  var task = {
-    f: result.f,
-    a: result.inDef
-  };
-  task.out = result.outDef;
-  task.type = type;
-  if (result.after) task.after = result.after;
-  return task;
-}
-
-function parseOutParams(str) {
-  if (!str.trim().length) return { outDef: [] };
-  return parse.parseStr(str, [finalCbParse], OUTPARAMS_NO_MATCH);
-} 
-
-function parseTasks(arr) { return arr.map(parseTask); }
-
-
-function pcodeDefine(inParamStr, taskStrArr, locals, options) {
-  if (!inParamStr) inParamStr = '';
-  if (!taskStrArr) taskStrArr = [];
-  var outTaskStr = (taskStrArr.length) ? taskStrArr.pop() : '';
-  if (!locals) locals = { };
-
-  var reactFn = core();
-  var ast = {
-    inParams: parseInParams(inParamStr).inDef,
-    tasks: parseTasks(taskStrArr),
-    outTask: { a: parseOutParams(outTaskStr).outDef },
-    locals: locals
-  };
-  if (options) Object.keys(options).forEach(function (k) { ast[k] = options[k]; });  
-  var errors = reactFn.setAndValidateAST(ast);
-  if (errors.length) {
-    var errorStr = errors.join('\n');
-    throw new Error(errorStr);
-  }
-  return reactFn;
-}
-
-function selectFirst(inParamStr, taskStrArr, locals, options) {
-  if (!inParamStr) inParamStr = '';
-  if (!taskStrArr) taskStrArr = [];
-  var outTaskStr = (taskStrArr.length) ? taskStrArr.pop() : '';
-  if (!locals) locals = { };
-  var tasks = tutil.serializeTasks(parseTasks(taskStrArr));
-  
-  var reactFn = core();
-  var ast = {
-    inParams: parseInParams(inParamStr).inDef,
-    tasks: tasks,
-    outTask: { type: 'finalcbFirst', a: parseOutParams(outTaskStr).outDef },
-    locals: locals
-  };
-  if (options) Object.keys(options).forEach(function (k) { ast[k] = options[k]; });  
-  var errors = reactFn.setAndValidateAST(ast);
-  if (errors.length) {
-    var errorStr = errors.join('\n');
-    throw new Error(errorStr);
-  }
-  return reactFn;
-}
-
-module.exports = pcodeDefine;
-module.exports.selectFirst = selectFirst;
-module.exports.options = core.options;
-module.exports.events = core.events;

package/examples/chain-events1.js

@@ -1,55 +0,0 @@
-'use strict';
-
-var chainDefine = require('../dsl/chain'); // require('react/dsl/chain');
-require('../lib/track-tasks');  // require('react/lib/track-tasks'); // turn on tracking
-
-//output events as tasks start and complete
-chainDefine.events.on('flow.*', function (obj) {
-  /*jshint validthis: true */
-  var time = new Date();
-  time.setTime(obj.time);
-  var argsNoCb = obj.args.filter(function (a) { return (typeof(a) !== 'function'); });
-  var eventTimeStr = time.toISOString();
-  if (this.event === 'flow.complete') {
-    var env = obj; 
-    console.error('%s: %s \tmsecs:(%s) \n\targs:(%s) \n\tresults:(%s)\n',
-                  this.event, env.name, env.elapsedTime, argsNoCb, env.results);   
-  } else {
-    var name = obj.name;
-    var args = obj.args;
-    console.error('%s: %s \n\targs:(%s)\n', this.event, name, argsNoCb);
-  }
-});
-
-chainDefine.events.on('task.*', function (obj) {
-  /*jshint validthis: true */
-  var time = new Date();
-  time.setTime(obj.time);
-  var argsNoCb = obj.args.filter(function (a) { return (typeof(a) !== 'function'); });
-  var eventTimeStr = time.toISOString();
-  if (this.event === 'task.complete') {
-    var task = obj;
-    console.error('%s: %s \tmsecs:(%s) \n\targs:(%s) \n\tresults:(%s)\n',
-                  this.event, task.name, task.elapsedTime, argsNoCb, task.results);
-  } else {
-    var name = obj.name;
-    var args = obj.args;
-    console.error('%s: %s \n\targs:(%s)\n', this.event, name, argsNoCb);
-  }
-});
-
-function multiply(a, b, cb) { cb(null, a * b); }
-function add(a, b) { return a + b; }
-
-var fn = chainDefine()
-  .in('a', 'b', 'cb')                                   // input params
-  .out('err', 'm', 's')                                 // final callback output params
-  .async(multiply).in('a', 'b', 'cb').out('err', 'm')   // task def - async fn, in params, callback out params
-  .sync(add).in('m', 'a').out('s')                      // task def - sync fn, in params, return value
-  .end();
-
-fn(2, 3, function (err, m, s) {
-  console.error('err:', err); // null
-  console.error('m:', m);  // 2 * 3 = 6
-  console.error('s:', s);  // 6 + 2 = 8
-});

package/examples/chain1.js

@@ -1,19 +0,0 @@
-'use strict';
-
-var chainDefine = require('../dsl/chain'); // require('react/dsl/chain');
-
-function multiply(a, b, cb) { cb(null, a * b); }
-function add(a, b) { return a + b; }
-
-var fn = chainDefine()
-  .in('a', 'b', 'cb')                                   // input params
-  .out('err', 'm', 's')                                 // final callback output params
-  .async(multiply).in('a', 'b', 'cb').out('err', 'm')   // task def - async fn, in params, callback out params
-  .sync(add).in('m', 'a').out('s')                      // task def - sync fn, in params, return value
-  .end();
-
-fn(2, 3, function (err, m, s) {
-  console.error('err:', err); // null
-  console.error('m:', m);  // 2 * 3 = 6
-  console.error('s:', s);  // 6 + 2 = 8
-});

package/examples/fstr-events1.js

@@ -1,38 +0,0 @@
-'use strict';
-/*jshint white: false */
-
-var fstr = require('../dsl/fstr'); // require('react/dsl/fstr');
-require('../lib/log-events').logEvents(fstr); // require('react/lib/log-events').logEvents(react);
-
-function loadUser(uid, cb){ setTimeout(cb, 100, null, "User"+uid); }
-function loadFile(filename, cb){ setTimeout(cb, 100, null, 'Filedata'+filename); }
-function markdown(filedata) { return 'html'+filedata; }
-function prepareDirectory(outDirname, cb){ setTimeout(cb, 200, null, 'dircreated-'+outDirname); }
-function writeOutput(html, user, cb){  setTimeout(cb, 300, null, html+'_bytesWritten'); }
-function loadEmailTemplate(cb) { setTimeout(cb, 50, null, 'emailmd'); }
-function customizeEmail(user, emailHtml, cb) { return 'cust-'+user+emailHtml; }
-function deliverEmail(custEmailHtml, cb) { setTimeout(cb, 100, null, 'delivered-'+custEmailHtml); }
-
-function useHtml(err, html, user, bytesWritten) {
-  if(err) {
-    console.log('***Error: %s', err);
-    return;
-  }
-  console.log('final result: %s, user: %s, written:%s', html, user, bytesWritten);
-}
-
-var loadAndSave = fstr('filename, uid, outDirname, cb', [  // input params
-  loadUser,         'uid              -> err, user',     // calling async fn loadUser with uid, callback is called with err and user
-  loadFile,         'filename         -> err, filedata',
-  markdown,         'filedata         -> returns html',    // using a sync function
-  prepareDirectory, 'outDirname       -> err, dircreated',
-  writeOutput,      'html, user       -> err, bytesWritten', { after: prepareDirectory },  // only after prepareDirectory done
-  loadEmailTemplate, '                 -> err, emailmd',
-  markdown,         'emailmd          -> returns emailHtml',   // using a sync function
-  customizeEmail,   'user, emailHtml  -> returns custEmailHtml',
-  deliverEmail,     'custEmailHtml    -> err, deliveredEmail', { after: writeOutput }  // only after writeOutput is done
-], 'err, html, user, bytesWritten');   // callback output params
-
-loadAndSave('file.md', 100, '/tmp/foo', useHtml);  // executing the flow
-
-

package/examples/fstr1.js

@@ -1,37 +0,0 @@
-'use strict';
-/*jshint white: false */
-
-var fstr = require('../dsl/fstr'); // require('react/dsl/fstr');
-
-function loadUser(uid, cb){ setTimeout(cb, 100, null, "User"+uid); }
-function loadFile(filename, cb){ setTimeout(cb, 100, null, 'Filedata'+filename); }
-function markdown(filedata) { return 'html'+filedata; }
-function prepareDirectory(outDirname, cb){ setTimeout(cb, 200, null, 'dircreated-'+outDirname); }
-function writeOutput(html, user, cb){  setTimeout(cb, 300, null, html+'_bytesWritten'); }
-function loadEmailTemplate(cb) { setTimeout(cb, 50, null, 'emailmd'); }
-function customizeEmail(user, emailHtml, cb) { return 'cust-'+user+emailHtml; }
-function deliverEmail(custEmailHtml, cb) { setTimeout(cb, 100, null, 'delivered-'+custEmailHtml); }
-
-function useHtml(err, html, user, bytesWritten) {
-  if(err) {
-    console.log('***Error: %s', err);
-    return;
-  }
-  console.log('final result: %s, user: %s, written:%s', html, user, bytesWritten);
-}
-
-var loadAndSave = fstr('filename, uid, outDirname, cb', [  // input params
-  loadUser,         'uid              -> err, user',     // calling async fn loadUser with uid, callback is called with err and user
-  loadFile,         'filename         -> err, filedata',
-  markdown,         'filedata         -> returns html',    // using a sync function
-  prepareDirectory, 'outDirname       -> err, dircreated',
-  writeOutput,      'html, user       -> err, bytesWritten', { after: prepareDirectory },  // only after prepareDirectory done
-  loadEmailTemplate, '                 -> err, emailmd',
-  markdown,         'emailmd          -> returns emailHtml',   // using a sync function
-  customizeEmail,   'user, emailHtml  -> returns custEmailHtml',
-  deliverEmail,     'custEmailHtml    -> err, deliveredEmail', { after: writeOutput }  // only after writeOutput is done
-], 'err, html, user, bytesWritten');   // callback output params
-
-loadAndSave('file.md', 100, '/tmp/foo', useHtml);  // executing the flow
-
-