Skip to main content

Connect systems via many brokers such as Kafka, AWS SQS, RabbitMQ and more.

Project description

Author:

Elvio Toccalino

Date:
2018-07-27
Version:
1.2.0

Provides higher level interfaces to work with data producers and consumers. plumb supports five backends: RabbitMQ, Redis, Amazon SQS and SNS services, Kafka, and a memory implementation (designed to be a testing artifact).

The focus is on python 3 and boto3 (for AWS support).

The API

plumb uses the concepts of Source and Sink to abstract the backend. Data is transfered encoded in JSON, and by default compressed using zlib.

To fetch raw packages use a “Package Source” object, which handles a backend connection and its configuration and exposes a “get()” method. Similarly, a “Package Sink” object exposes a “put(pkg)” method.

You can either create the Sources and Sinks directly by instantiating them from their packages or use the convenience factory functions exposed in the plumb package. This functions receive a JSON with the configuration for the Sources or Sinks and returns a list of such configured devices.

Tests

The library is provided with unit tests and integration tests for Redis and AWS. To run the unit tests:

python setup.py test

or using nose:

nosetests tests/unit

The integration tests can be run using nose:

nosetests tests/integration

Keep in mind that boto3 will fetch your AWS credentials. It currently tries the environment variables AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY, then tries the ~/.aws directory. For details, see Boto3 Credentials Configuration.

Project details


Download files

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

Source Distribution

plumb-1.2.0.tar.gz (8.8 kB view hashes)

Uploaded Source

Built Distribution

plumb-1.2.0-py3-none-any.whl (12.5 kB view hashes)

Uploaded Python 3

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