├── index.js
├── .gitignore
├── lib
    ├── utils.js
    ├── context.js
    └── invoke.js
├── package.json
├── LICENSE
├── bin
    └── local-node-lambda
└── README.md


/index.js:
--------------------------------------------------------------------------------
1 | var invoke = require('./lib/invoke.js');
2 | 
3 | function localNodeLambda () {};
4 | 
5 | localNodeLambda.invoke = invoke;
6 | 
7 | module.exports = localNodeLambda;
8 | 


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
 1 | # Logs
 2 | logs
 3 | *.log
 4 | 
 5 | # Runtime data
 6 | pids
 7 | *.pid
 8 | *.seed
 9 | 
10 | # Directory for instrumented libs generated by jscoverage/JSCover
11 | lib-cov
12 | 
13 | # Coverage directory used by tools like istanbul
14 | coverage
15 | 
16 | # Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
17 | .grunt
18 | 
19 | # node-waf configuration
20 | .lock-wscript
21 | 
22 | # Compiled binary addons (http://nodejs.org/api/addons.html)
23 | build/Release
24 | 
25 | # Dependency directory
26 | # https://www.npmjs.org/doc/misc/npm-faq.html#should-i-check-my-node_modules-folder-into-git
27 | node_modules
28 | 


--------------------------------------------------------------------------------
/lib/utils.js:
--------------------------------------------------------------------------------
 1 | /*
 2 |  * utility functions
 3 |  */
 4 | 
 5 | module.exports = Utils;
 6 | function Utils () {}
 7 | 
 8 | Utils.hexChars = "0123456789abcdef".split('');
 9 | Utils.generateRandomHex = function (length) {
10 | 	var hexVal = '';
11 | 	for (var i=0; i<length; i++) {
12 | 		hexVal += Utils.hexChars[Math.floor(Math.random() * Utils.hexChars.length)];
13 | 	}
14 | 	return hexVal;
15 | };
16 | 
17 | Utils.getAbsolutePath = function (path) {
18 | 	var absolutePath;
19 | 	if (path.match(/^\//)) {
20 | 		absolutePath = path;
21 | 	} else {
22 | 		absolutePath = [process.cwd(), path].join('/');
23 | 	}
24 | 	return absolutePath; 
25 | };
26 | 
27 | 
28 | 


--------------------------------------------------------------------------------
/package.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "name": "local-node-lambda",
 3 |   "version": "0.0.2",
 4 |   "description": "Local-Node-Lambda lets you run Amazon Lambda functions locally. You can run them from the command line or integrate calls within a regular Node.js script, e.g. to use in unit testing or simply as part of a regular application.",
 5 |   "license": "MIT",
 6 |   "main": "index.js",
 7 |   "keywords": [
 8 |     "lambda"
 9 |   ],
10 |   "author": {
11 |     "name": "Tobias Christensen",
12 |     "email": "tobiaschristensen@gmail.com",
13 |     "url": "http://deeprapid.com/"
14 |   },
15 |   "dependencies": {
16 |     "aws-sdk": "^2.1.6",
17 |     "commander": "^2.6.0"
18 |   },
19 |   "contributors": [
20 |     {
21 |       "name": "Tobias Christensen",
22 |       "email": "tobiaschristensen@gmail.com",
23 |       "url": "http://deeprapid.com/"
24 |     }
25 |   ],
26 |   "repository": {
27 |     "type": "git",
28 |     "url": "git+https://github.com/tobiasc/local-node-lambda.git"
29 |   },
30 |   "bugs": {
31 |     "url": "https://github.com/tobiasc/local-node-lambda/issues"
32 |   },
33 |   "bin": {
34 |     "local-node-lambda": "./bin/local-node-lambda"
35 |   }
36 | }
37 | 


--------------------------------------------------------------------------------
/lib/context.js:
--------------------------------------------------------------------------------
 1 | /*
 2 |  * Creating Lambda's context object
 3 |  */
 4 | 
 5 | var utils = require('./utils.js');
 6 | 
 7 | /*
 8 |  * doneStatus & postDone were minimum; probably defined internally in Lambda.
 9 |  */
10 | var doneStatus = false;
11 | var postDone = function (error, message) {};
12 | 
13 | function Context () {};
14 | 
15 | /*
16 |  * exports
17 |  */
18 | module.exports = Context;
19 | /*
20 |  * create random invokeid. 
21 |  * Assuming that invokeid follows the format: 
22 |  * 8hex-4hex-4hex-4hex-12hex
23 |  */
24 | Context.invokeid = (function(){ 
25 | 	return [ 
26 | 		utils.generateRandomHex(8),
27 | 		utils.generateRandomHex(4),
28 | 		utils.generateRandomHex(4),
29 | 		utils.generateRandomHex(4),
30 | 		utils.generateRandomHex(12)
31 | 		].join('-'); 
32 | })();
33 | 
34 | Context.setCallback = function (cb) {
35 | 	callback = cb;
36 | }
37 | 
38 | /*
39 |  * The context methods
40 |  */
41 | Context.done = function (err, message) {
42 | 	callback(err, message);
43 | };
44 | 
45 | Context.succeed = function (message) {
46 | 	callback(null, message);
47 | };
48 | 
49 | Context.fail = function (err, message) {
50 | 	callback(err, message);
51 | };
52 | 


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
 1 | The MIT License (MIT)
 2 | 
 3 | Copyright (c) 2015 Tobias Christensen
 4 | 
 5 | Permission is hereby granted, free of charge, to any person obtaining a copy
 6 | of this software and associated documentation files (the "Software"), to deal
 7 | in the Software without restriction, including without limitation the rights
 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 | 
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 | 
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 | SOFTWARE.
22 | 
23 | 


--------------------------------------------------------------------------------
/bin/local-node-lambda:
--------------------------------------------------------------------------------
 1 | #!/usr/bin/env node
 2 | 
 3 | /*
 4 |  * Local executor for Amazon Lambda function
 5 |  */
 6 | (function(){
 7 | 	var invoke = require('../lib/invoke.js');
 8 | 	var utils = require('../lib/utils.js');
 9 | 
10 | 	// process opts
11 | 	var program = require('commander');
12 | 	program
13 | 		.option('-p, --path [Lambda file name] Specify Lambda function file name. Default is "./index"')
14 | 		.option('-e, --eventPath [Event data file name] Specify event data file name. Default is "{}"')
15 | 		.option('-h, --handler [Lambda handler name] Lambda handler name. Default is "handler"')
16 | 		.option('-t, --timeout [Timeout seconds] Seconds until the Lambda function times out. Default is 3 seconds.')
17 | 		.parse(process.argv);
18 | 
19 | 	// load event & context
20 | 	var eventObj = {};
21 | 	if (program.eventPath) {
22 | 		var eventAbsolutePath = utils.getAbsolutePath(program.eventPath);
23 | 		eventObj = require(eventAbsolutePath);
24 | 	}
25 | 
26 | 	invoke(eventObj, program.path, program.handler, program.timeout, function (err, message) {
27 | 		if (err) {
28 | 			console.log(err);
29 | 			program.help();
30 | 		} else {
31 | 			console.log(message);
32 | 		}
33 | 		process.exit();
34 | 	});
35 | })();
36 | 
37 | 


--------------------------------------------------------------------------------
/lib/invoke.js:
--------------------------------------------------------------------------------
 1 | var utils = require('./utils.js');
 2 | 
 3 | /*
 4 |  * exports
 5 |  */
 6 | module.exports = function (eventObj, path, handler, timeout, callback) {
 7 | 
 8 | 	// default event
 9 | 	if (!eventObj) {
10 | 		eventObj = {};
11 | 	}
12 | 
13 | 	// default path
14 | 	if (!path) {
15 | 		path = "./index";
16 | 	}
17 | 
18 | 	// default handler name
19 | 	if (!handler) {
20 | 		handler = "handler";
21 | 	}
22 | 
23 | 	// default timeout
24 | 	if (!timeout) {
25 | 		timeout = 3000;
26 | 	} else {
27 | 		timeout = timeout * 1000;
28 | 	}
29 | 
30 | 	// load lambda function
31 | 	var lambdaAbsolutePath = utils.getAbsolutePath(path);
32 | 	var lambdaFunc = require(lambdaAbsolutePath);
33 | 
34 | 	// load context
35 | 	var context = require('./context.js');
36 | 
37 | 	var timeoutReached = false;
38 | 	var timer = setTimeout(function(){
39 | 		timeoutReached = true;
40 | 		callback(new Error("Task timed out after " + (timeout / 1000).toFixed(2) + " seconds"));
41 | 	}, timeout); 
42 | 
43 | 	context.setCallback(function (err, message) {
44 | 		if (!timeoutReached) {
45 | 			callback(err, message);
46 | 		}
47 | 	});
48 | 
49 | 	// execute lambda function
50 | 	if (lambdaFunc[handler]) {
51 | 		lambdaFunc[handler](eventObj, context);
52 | 	} else {
53 | 		callback(new Error('Could not find Lambda handler'));
54 | 	}
55 | 	clearTimeout(timer);
56 | };
57 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | Local-Node-Lambda
 2 | ============
 3 | 
 4 | Local-Node-Lambda lets you run Amazon Lambda functions locally. You can run them from the command line or integrate calls within a regular Node.js script, e.g. to use in unit testing or simply as part of a regular application.
 5 | 
 6 | 
 7 | Install
 8 | ----------
 9 | ```bash
10 | # For command line use
11 | npm install -g local-node-lambda
12 | ```
13 | 
14 | ```bash
15 | # For Node.js use
16 | npm install local-node-lambda
17 | ```
18 | 
19 | Usage
20 | ----------
21 | 
22 | ```js
23 | # Run from Node.js
24 | var localNodeLambda = require('local-node-lambda');
25 | 
26 | localNodeLambda.invoke(<eventObj>, <path>, <handler>, <timeout>, function (err, message) {
27 | 	if (err) {
28 | 		console.log(err);
29 | 	} else {
30 | 		console.log(message);
31 | 	}
32 | 	process.exit();
33 | });
34 | ```
35 | 
36 | ```bash
37 | # Run from command line
38 | local-node-lambda
39 | ```
40 | 
41 | Command Line Help
42 | ----------
43 | #### Parameters
44 | *    -p, --path [Lambda file name] Specify Lambda function file name. Default is "./index"
45 | *    -e, --eventPath [Event data file name] Specify event data file name. Default is "{}"
46 | *    -h, --handler [Lambda handler name] Lambda handler name. Default is "handler".
47 | *    -t, --timeout [Timeout seconds] Seconds until the Lambda function times out. Default is 3 seconds.
48 | 
49 | #### Event data
50 | From the regular node execution you can pass in a JSON object as the event object, while from the command line you can pass in a js file that exports a JSON object.
51 | 
52 | ```js
53 | # Command line sample event
54 | module.exports = {
55 | 	hello: "world"
56 | };
57 | ```
58 | 
59 | Inspiration
60 | ----------
61 | * https://github.com/ashiina/lambda-local
62 | * https://github.com/RebelMail/node-lambda
63 | 
64 | 
65 | License
66 | ----------
67 | This library is released under the MIT license.
68 | 
69 | 


--------------------------------------------------------------------------------