Welcome to Relé’s documentation!

Release v1.0.0. (Installation)

https://travis-ci.org/mercadona/rele.svg?branch=master https://img.shields.io/badge/license-Apache%202-blue.svg

Relé makes integration with Google PubSub easier and is ready to integrate seamlessly into any Django project.

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.


Out of the box, Relé includes 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

# Subscribe to the Pub/Sub topic
from rele import sub
def photo_uploaded(data, **kwargs):
    print(f"Customer {data['customer_id']} has uploaded an image")

# Publish to the topic
import rele
rele.publish(topic='photo-uploaded', data={'customer_id': 123})


Relé supports Python 3.6+ and installing via pip

$ pip install rele

or with Django integration

$ pip install rele[django,flask]


Here you can see the full list of the settings options for your deployment of Relé.

API Docs

This is the part of documentation that details the inner workings of Relé. If you are looking for information on a specific function, class or method, this part of the documentation is for you.


Here you can see the full list of changes between each Relé release.

Indices and tables