feature(lambda): Add lambda tests and client

1 files changed, 56 insertions, 0 deletions

diff --git a/docs/integrations/awslambda.rst b/docs/integrations/awslambda.rst
new file mode 100644
index 0000000..a1dacc1
--- /dev/null
+++ b/docs/integrations/awslambda.rst
@@ -0,0 +1,56 @@
+Amazon Web Services Lambda
+==========================
+
+.. default-domain:: py
+
+
+
+Installation
+------------
+
+To use `Sentry`_ with `AWS Lambda`_, you have to install `raven` as an external
+dependency. This involves creating a `Deployment package`_ and uploading it
+to AWS.
+
+To install raven into your current project directory:
+
+.. code-block:: console
+
+    pip install raven -t /path/to/project-dir
+
+Setup
+-----
+
+Create a `LambdaClient` instance and wrap your lambda handler with
+the `capture_exeptions` decorator:
+
+
+.. sourcecode:: python
+
+    from raven.contrib.awslambda import LambdaClient
+
+
+    client = LambdaClient()
+
+    @client.capture_exceptions
+    def handler(event, context):
+        ...
+        raise Exception('I will be sent to sentry!')
+
+
+By default this will report unhandled exceptions and errors to Sentry.
+
+Additional settings for the client are configured using environment variables or
+subclassing `LambdaClient`.
+
+
+
+Advanced Usage
+--------------
+
+
+.. _Sentry: https://getsentry.com/
+.. _AWS Lambda: https://aws.amazon.com/lambda
+.. _Deployment package: https://docs.aws.amazon.com/lambda/latest/dg/lambda-python-how-to-create-deployment-package.html
+
+