README

Local-Node-Lambda

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.

Install

# For command line use
npm install -g local-node-lambda

# For Node.js use
npm install local-node-lambda

Usage

# Run from Node.js
var localNodeLambda = require('local-node-lambda');

localNodeLambda.invoke(<eventObj>, <path>, <handler>, <timeout>, function (err, message) {
    if (err) {
        console.log(err);
    } else {
        console.log(message);
    }
    process.exit();
});

# Run from command line
local-node-lambda

Command Line Help

Parameters

-p, --path [Lambda file name] Specify Lambda function file name. Default is "./index"
-e, --eventPath [Event data file name] Specify event data file name. Default is "{}"
-h, --handler [Lambda handler name] Lambda handler name. Default is "handler".
-t, --timeout [Timeout seconds] Seconds until the Lambda function times out. Default is 3 seconds.

Event data

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.

# Command line sample event
module.exports = {
    hello: "world"
};

Inspiration

License

This library is released under the MIT license.

Usage no npm install needed!