Skip to main content

Humilis kinesis stream processor plugin

Project description

Kinesis event stream processor

Build Status PyPI

A humilis plugin to deploy a Lambda function that maps events in a Kinesis event stream using a list of Python callables.

Installation

pip install humilis-kinesis-processor

Development

Assuming you have virtualenv installed:

make develop

Configure humilis:

.env/bin/humilis configure --local

Testing

Unit tests

To run the local test suite:

make test

Integration tests

Before running the integration test suite you need to set a few deployment secrets using the command:

s3keyring set [group]/[STAGE] [key] [secret]

In group humilis-kinesis-processor the following secrets need to be set:

By the default, the integration tests will deploy on a stage called DEV so the command to set the Sentry DSN is:

s3keyring set humilis-kinesis-processor:DEV sentry.dsn [SENTRYDSN]

To run the integration test suite:

make testi

The command above will deploy a Kinesis processor to your AWS account, and will also create additional resources (such as several Kinesis streams) needed to test that the deployment was successful. Once deployed, the integration tests will run, and once they have completed the test environment will be destroyed.

If you do not want the test environment to be destroyed after tests have completed you should run instead:

make testi DESTROY=no

You can also modify the name of the deployment stage by setting the STAGE environment variable. For instance, to deploy to a TEST stage:

make testi STAGE=TEST

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 Anatoly Bubenkov, German Gomez-Herrero, FindHotel and others.

Authors

Anatoly Bubenkov

initial idea and first alpha implementation

German Gomez-Herrero

actual implementation and further developments

Changelog

0.8.9

  • Add error annotations to events that failed to be processed

0.8.6

  • Bugfix in error handling logic.

0.8.5

  • Better error handling.

0.7.7

  • Support for multiple delivery streams for input, error, and output(s)

0.7.6

  • Support for one-to-many mappers

0.7.5

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

0.6.8

  • Set environment variables for the humilis environment/layer/stage

0.4.0

  • Major bugfix: permission to put records in delivery streams

0.3.0

  • Major bugfix: give permission to write state to DynamodDB

0.2.0

  • Package becomes a generic map-multiplex-map processor (germangh)

0.1.1

  • Cleanup package data (bubenkoff)

0.1.0

  • Major refactoring to simplify and clean the code (germangh)

0.0.1

  • Initial release (bubenkoff)

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

humilis-kinesis-processor-0.8.9.tar.gz (10.4 kB view details)

Uploaded Source

File details

Details for the file humilis-kinesis-processor-0.8.9.tar.gz.

File metadata

File hashes

Hashes for humilis-kinesis-processor-0.8.9.tar.gz
Algorithm Hash digest
SHA256 c93779c6aebbf3e7d8e5aa1a20aded16be455bfcf1cce7d1548d7bdb0d322617
MD5 5ff03dd8c8b3a17a6d0829427725f62e
BLAKE2b-256 b8c1a5852f266b4620ca64f947c2afa5ceecf6296a8262e24c37ae6bff970736

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page