react 0.2.6 → 0.5.0

package/lib/fstr.js

@@ -1,119 +0,0 @@
-'use strict';
-/*jshint regexp: false */
-
-var sprintf = require('sprintf').sprintf;
-var core = require('./core.js');
-var parse = require('./parse.js');
-var tutil = require('./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,
-  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;

package/lib/pcode.js

@@ -1,173 +0,0 @@
-'use strict';
-/*jshint regexp: false */
-
-var sprintf = require('sprintf').sprintf;
-var core = require('./core.js');
-var parse = require('./parse.js');
-var tutil = require('./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;

package/oldExamples/analyze.js

@@ -1,29 +0,0 @@
-'use strict';
-
-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 analyze(fn) {
-  console.log(fn.toString());
-}
-
-var fn = analyze(function loadAndSend(filename, uid, outDirname, cb,
-                         R, filedata, outDirName, dircreated, emailmd, emailHtml,
-                                   custEmailHtml, deliveredEmail, err, user, html, bytesWritten) {
-  R.async(loadUser, uid).cb(err, user)
-    .async(loadFile, filename).cb(err, filedata)
-    .sync(markdown, filedata).returns(filedata)
-    .async(prepareDirectory, outDirName).cb(dircreated)
-    .async(writeOutput, html, user).cb(err, bytesWritten).after(prepareDirectory)
-    .async(loadEmailTemplate).cb(err, emailmd)
-    .sync(markdown, emailmd).returns(emailHtml)
-    .sync(customizeEmail, user, emailHtml).returns(custEmailHtml)
-    .sync(deliverEmail, custEmailHtml).returns(deliveredEmail).after(writeOutput)
-    .finalCb(err, html, user, bytesWritten);
-});

package/oldExamples/analyze2.js

@@ -1,29 +0,0 @@
-'use strict';
-
-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 react(fn) {
-  console.log(fn.toString());
-}
-
-var fn = react(function (R, filename, uid, outDirname, cb) {
-  var filedata, outDirName, dircreated, emailmd, emailHtml,
-    custEmailHtml, deliveredEmail, err, user, html, bytesWritten;
-  R.async(loadUser).in(uid).out(err, user)
-    .async(loadFile).in(filename).out(err, filedata)
-    .sync(markdown, filedata).out(filedata)
-    .async(prepareDirectory, outDirName).out(dircreated)
-    .async(writeOutput, html, user).out(err, bytesWritten).after(prepareDirectory)
-    .async(loadEmailTemplate).out(err, emailmd)
-    .sync(markdown, emailmd).out(emailHtml)
-    .sync(customizeEmail, user, emailHtml).out(custEmailHtml)
-    .sync(deliverEmail, custEmailHtml).out(deliveredEmail).after(writeOutput)
-    .cb(err, html, user, bytesWritten);
-});

package/oldExamples/example10-dsl.js

@@ -1,63 +0,0 @@
-
-
-var reactMod = require(__dirname+'/../lib/react.js'); 
-var react = reactMod.react;
-
-var r = react('allStart, titlesFile, numQueries, numFactors, cb').define(
-    openTitlesStream, 'titlesFile         -> err, fileStream', { tasks: [
-      split,          'fileStream         -> err, lineStream',
-      filterLines,    'lineStream, numQueries -> err, filteredLineStream',
-      trimLines,      'filteredLineStream -> err, trimmedLineStream',
-      recordTime,     '                   -> returns qStart', { after: trimLines },
-      runQuery,       'trimmedLineStream, numFactors -> err, qResults', { after: recordTime },
-      calcTime,       'qStart             -> returns qTime', { after: runQuery },
-      sumTotal,       'qTime              -> returns qTotal', { reduce: true }
-    ], cb:'-> err, qTotal' },
-    calcTime,         'allStart           -> returns allElapsed', { after: openTitlesStream }
-  ).callbackDef('allElapsed, qTotal, numQueries, numFactors');
-
-
-
-//new simpler syntax
-
-var react = require('react');
-
-var loadAndSave = react('allStart, titlesFile, numQueries, numFactors, cb',
-                        foo, 'bar -> err, baz',
-                        cat, 'baz -> err, zoo',
-                        '-> err, allElapse, qTotal');
-
-var loadAndSave = react('allStart, titlesFile, numQueries, numFactors, cb', [
-                        foo, 'bar -> err, baz',
-                        cat, 'baz -> returns zoo'
-                        ], 'err, allElapse, qTotal');
-
-var loadAndSave = react('allStart, titlesFile, numQueries, numFactors, cb', [
-                        foo, 'bar => err, baz',
-                        cat, 'baz -> returns zoo'
-                        ], 'err, allElapse, qTotal');
-
-var loadAndSave = react('allStart, titlesFile, numQueries, numFactors, cb', [
-                        foo, 'bar -> err, baz',
-                        'zoo <- ', cat, 'baz',
-                        ], 'err, allElapse, qTotal');
-
-
-
-var loadAndSave = react('allStart, titlesFile, numQueries, numFactors, cb -> err, allElapse, qTotal',
-                        foo, 'bar -> err, baz',
-                        cat, 'baz -> err, zoo');
-loadAndSave(1, 2, 3, cb);
-
-OR using AST
-
-var loadAndSave = react();
-loadAndSave.ast.inputs(['one', 'two'])
-   .tasks({ })
-   .outTask({ });
-
-loadAndSave(1,2,cb);
-
-
-
-

package/oldExamples/example11.js

@@ -1,62 +0,0 @@
-'use strict';
-
-var react = require('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 fn = react(function (r, filename, uid, outDirname, cb) {
-  var err, user, html, bytesWritten;
-  r.sync(loadUser).in(uid).out(err, user)
-    .cb(err, html, user, bytesWritten);
-});
-
-
-/*
-var r = react();
-    r.ast.inputNames = ['filename', 'uid', 'outDirname', 'cb'];
-    r.ast.taskDefs = [
-      { f:loadUser,          a:['uid'],               cb:['user'] },
-      { f:loadFile,          a:['filename'],          cb:['filedata'] },
-      { f:markdown,          a:['filedata'],          ret:['html'] },
-      { f:prepareDirectory,  a:['outDirname'],        cb:['dircreated'] },
-      { f:writeOutput,       a:['html', 'user'],      cb:['bytesWritten'],   after:['prepareDirectory'] },
-      { f:loadEmailTemplate, a:[],                    cb:['emailmd'] },
-      { f:markdown,          a:['emailmd'],           ret:['emailHtml'] },
-      { f:customizeEmail,    a:['user', 'emailHtml'], ret:['custEmailHtml'] },
-      { f:deliverEmail,      a:['custEmailHtml'],     cb:['deliveredEmail'], after:['writeOutput'] }
-    ];
-    r.ast.finalOutputNames = ['html', 'user', 'bytesWritten'];
-*/
-
-var fn = react(function (r, filename, uid, outDirname, cb) {
-  var filedata, outDirName, dircreated, emailmd, emailHtml, custEmailHtml, deliveredEmail;
-  var err, user, html, bytesWritten;
-  
-  r.async(loadUser).in(uid).out(err, user)
-    .async(loadFile).in(filename).out(filedata)
-    .sync(markdown).in(filedata).out(html)
-    .async(prepareDirectory).in(outDirName).out(dircreated)
-    .async(writeOutput).in(html, user).out(bytesWritten).after(prepareDirectory)
-    .async(loadEmailTemplate).out(emailmd)
-    .sync(markdown).in(emailmd).out(emailHtml)
-    .sync(customizeEmail).in(user, emailHtml).out(custEmailHtml)
-    .async(deliveredEmail).in(custEmailHtml).out(deliveredEmail).after(writeOutput)
-    .cb(err, html, user, bytesWritten);
-});