README.md

jsoffload

Usage

Babel transformation command

node_modules/.bin/babel fixtures/input_file.js --out-dir lib

input file : fixtures/input_file.js
output file (babel transformed result) : lib/input_file.js

Example

• input: fixtures/input_file.js

var a = 1;
let b = 2;

// test comments 1
// test comments 2
function square(n) {
  // test inner 1
  return n * n;
  // test inner 2
}

// test comments 3
function test(n) {
        return n * n;
}
// test comments 4
// <<offload>>
function offloaded(a, b, c) {
  console.log("offloaded");
}

square(3);

• output: lib/input_file.js

"use strict";

var a = 1;
let b = 2; // test comments 1
// test comments 2

function square(n) {
  // test inner 1
  return n * n; // test inner 2
} // test comments 3


function test(n) {
  return n * n;
} // test comments 4
// <<offload>>


function _offloaded(a, b, c) {
  console.log("offloaded");
}

function offloaded(a, b, c) {
  remoteExecution(_offloaded, [a, b, c]);
}

square(3);

Overall

• src/offload_babel_plugin.js

This babel plugin identifies // <<offload>> comment located right above a function,
then generate a function which has '_' prefixed name, e.g. "_test"
if the function name is "test".

The "_test" function has its original function's body content,
and "test" function's body is replaced with |remoteExecution| CallExpression,
which is defined in lib/offload_lib.js library.

• lib/offload_lib.js

It has |remoteExecution| function definition,
which is in charge of passing the js call to server via network,
and receiving the remote execution's result.