rele

Easy to use Google Pub/Sub

Description

The Publish-Subscribe pattern and specifically the Google Cloud PubSub library are very powerful tools but you can easily cut your fingers on it. Relé makes integration seamless by providing Publisher, Subscriber and Worker classes with the following features: - Powerful Publishing API - Highly Scalable Worker - Intuitive Subscription Management - Easily Extensible Middleware - Optional Django Integration - And much more!

Programming language: Python

License: Apache License 2.0

Tags: Django     Queue     Distributed Computing     Google     1.11     2.0     2.1     2.2     3.0     3.1     3.2    

Latest version: v1.0.0

README

Relé makes integration with Google PubSub straightforward and easy.

Motivation and Features

The Publish-Subscribe pattern and specifically the Google Cloud Pub/Sub library are very powerful tools but you can easily cut your fingers on it. Relé makes integration seamless by providing Publisher, Subscriber and Worker classes with the following features:

• Powerful Publishing API
• Highly Scalable Worker
• Intuitive Subscription Management
• Easily Extensible Middleware
• Ready to go Django/Flask integration
• CLI
• And much more!

What it looks like

# Publish to the topic
import rele

rele.publish(topic='photo-uploaded', data={'customer_id': 123})

# Subscribe to the Pub/Sub topic
from rele import sub

@sub(topic='photo-uploaded')
def photo_uploaded(data, **kwargs):
    print(f"Customer {data['customer_id']} has uploaded an image")

What's in the name

"Relé" is Spanish for relay, a technology that has played a key role in history in the evolution of communication and electrical technology, including the telegraph, telephone, electricity transmission, and transistors.

Install

Relé supports Python 3.6+ and installing via pip

pip install rele

or with Django integration

pip install rele[django]

or with Flask integration

pip install rele[flask]

Quickstart

Please see our documentation to get started.

You can also read more about it here

---

Running Tests

Does the code actually work?

  make test