Skip to content

Utilities for locally running and testing Python AWS Lambda functions

License

Notifications You must be signed in to change notification settings

ethantkoenig/run_lambda

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

44 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

run_lambda

run_lambda is a Python package for running Python AWS Lambda functions locally. It offers a Python module for automated testing of Lambda functions, as well as a command-line interface for ad-hoc local invocations.

Doesn't something like this already exist?

Not exactly. There are other programs for locally running Python Lambda functions. However, all of the other utilities (that I know of) only provide a command-line tool. A command-line tool is great for quick manual invocations. However, if you want to create robust, automated tests for your Lambda functions, a Python module that you can import and call is more appropriate. run_lambda is unique because it offers both a simple command-line tool for manual invocations, and an importable Python module for automated tests.

Features

run_lambda supports

  • An interface for examining the result (return value, exception, timeout) of a function call
  • A full implementation of AWS Context objects
  • Function calls with or without a timeout
  • Resource usage profiling (memory and run-time)
  • Convenient mocking of objects and services inside Lambda functions

Installation

The easiest way to install is via pip:

$ pip install run_lambda

You can also download the source from Github.

Documentation

Documentation for the package can be found on Read the Docs.

About

Utilities for locally running and testing Python AWS Lambda functions

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages