Skip to main content

Lambda processor for push event sources

Build Status PyPI

A humilis plugin to deploy a Lambda function that processes event notification from an event sources that pushes events to Lambda (e.g. S3 or SNS, as opposed to Kinesis).

Installation

pip install humilis-push-processor

Development

Assuming you have virtualenv installed:

make develop

Configure humilis:

.env/bin/humilis configure --local

You can crate a development deployment (on a deployment stage called DEV) of the Lambda function using:

make create STAGE=DEV

The command above will also create additional resources (such as a S3 bucket) needed to produce a self-contained deployment that you can play with. You can destroy the DEV deployment using:

make delete STAGE=DEV

Testing

To run the local test suite:

make test

To run the integration test suite:

make testi STAGE=[STAGE] DESTROY=[yes|no]

Note that the command above will deploy the processor to the specified deployment stage. If a deployment stage is not specified then TEST will be used. If DESTROY is set to yes all deployed resources will be deleted after tests have completed (this is also the default behaviour if the DESTROY parameter is not provided). You can manually destroy the test infrastructure with:

make delete STAGE=[STAGE]

Deployment secrets

The S3 event processor supports Sentry monitoring out of the box. To activate it you just need to store your Sentry DSN in your local keychain. Using Python’s keyring module:

keyring set humilis-push-processor:[STAGE] sentry.dsn [SENTRY_DSN]

Alternatively you can set environment variable SENTRY_DSN

More information

See humilis documentation.

Contact

If you have questions, bug reports, suggestions, etc. please create an issue on the GitHub project page.

License

This software is licensed under the MIT license

See License file

© 2016 German Gomez-Herrero, FindHotel and others.

Authors

German Gomez-Herrero

original idea and implementation

These people have contributed to humilis-push-processor, in alphabetical order:

Changelog

0.0.10

  • Add support for injection of env vars and KMS key decrypt

0.0.8

  • Support deploying Lambda in a VPC and notifying SNS topic

0.0.7

  • Grant full access to S3

0.0.6

  • Support for one-to-many mappers

0.0.5

  • Mappers do not modify input events directly

0.0.4

  • Users can also specify input/output/error streams by name instead of as references to another layer outputs.

0.0.3

  • Permission to read from S3

0.0.2

  • Fix test suite

0.0.1

  • Initial release (germangh)

  • Practically a clone of the humilis-kinesis-processor

Release files for humilis-push-processor 0.0.10

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for humilis-push-processor 0.0.10
File Size Uploaded
humilis-push-processor-0.0.10.tar.gz 9.6 kB Details

Release files / humilis-push-processor-0.0.10.tar.gz

Download URL humilis-push-processor-0.0.10.tar.gz
Size 9.6 kB
Tags Source
SHA-256 checksum
How to use checksums
69bb22b1b4e5adc4a62d793f0aacea94eb35abbe13247531aa56e100c2cb141d
BLAKE2b-256 checksum
How to use checksums
f337a8d3febc6c5ecff0c55ba77047334433e4486cc129966b4e0d6bd4040d79
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

0.0.10 This release

1 release file

0.0.8

1 release file

0.0.7

1 release file

0.0.6

1 release file

0.0.3

1 release file

0.0.2

1 release file

0.0.1

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page