Skip to main content

Humilis push event processor plugin

Project description

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).


pip install humilis-push-processor


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


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.


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


This software is licensed under the MIT license

See License file

© 2016 German Gomez-Herrero, FindHotel and others.


German Gomez-Herrero
original idea and implementation

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



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


  • Support deploying Lambda in a VPC and notifying SNS topic


  • Grant full access to S3


  • Support for one-to-many mappers


  • Mappers do not modify input events directly


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


  • Permission to read from S3


  • Fix test suite


  • Initial release (germangh)
  • Practically a clone of the humilis-kinesis-processor

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for humilis-push-processor, version 0.0.10
Filename, size File type Python version Upload date Hashes
Filename, size humilis-push-processor-0.0.10.tar.gz (9.6 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page