Kappa-Lambda is a Node.js package that provides classes and tools to help you test a lambda application locally.

Contents

• Getting Started
  • Requirements
  • Installation
  • Usage
• Contributing
• License

Getting Started

Requirements

Kappa-Lambda requires the following:

• Node.js - click here for the exact version
• npm

Installation

npm install --save-dev kappa-lambda

Usage

Kappa-Lambda is designed to be used with popular frameworks such as Mocha, Chai and Jasmine.

At the top of your test file, create a new KappaLambda and create a variable pointing to your Lambda Function.

The following code is all taken from test/examples/alexa-sdk/index.spec.js.

const KappaLambda = require('kappa-lambda');
const lambdaFile = '../examples/alexa-sdk/index.js';
const kappaLambda = new KappaLambda(lambdaFile);

Adding Kappa-Lambda into a beforeEach function means you can check the return of your lambda easily.

describe('Alexa SDK Example', function(){
    context('No State', function(){
        describe('NewSession', function(){
            beforeEach(function(cb){
                let event = require('../../fixtures/examples/alexa-sdk/requests/LaunchRequest.json');

                kappaLambda.execute(event, cb);
            });

            it('responds with the correct output text', function(){
                expect(kappaLambda.done.response.outputSpeech.ssml)
                    .to.eql('<speak> Welcome to High Low guessing game. You have played 0 times. Would you like to play? </speak>');
            });
        });
    });
});

You can check that a certain error was raised like so:

it('populates error and not done', function () {
    expect(kappaLambda.done).to.be.an('undefined');
    expect(kappaLambda.error.message).to.include("Cannot read property 'substring' of undefined");
});

Examples

Project type | Source | Tests ---|---|--- Alexa SDK | Source | Tests

Contributing

If you wish to submit a bug fix or feature, you can create a pull request and it will be merged pending a code review.

1. Clone it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request

License

Kappa-Lambda is licensed under the MIT License.