rele · PyPI

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.10+ 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

Download files

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

Source Distribution

rele-1.17.2.tar.gz (222.6 kB view details)

Uploaded Aug 7, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

rele-1.17.2-py3-none-any.whl (30.3 kB view details)

Uploaded Aug 7, 2026 Python 3

File details

Details for the file rele-1.17.2.tar.gz.

File metadata

Download URL: rele-1.17.2.tar.gz
Upload date: Aug 7, 2026
Size: 222.6 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for rele-1.17.2.tar.gz
Algorithm	Hash digest
SHA256	`2bfdbc0fed1421964ca44aaa5964e0038f2bc220ebce4aeb57d4b228f4944321`
MD5	`a4a41f0af19fed7a97b8ea136951a191`
BLAKE2b-256	`ca538c3a5354a369c4851fb19e469d7e7edd473a3645b942078b9b560222f7e7`

See more details on using hashes here.

Provenance

The following attestation bundles were made for rele-1.17.2.tar.gz:

Publisher: release-please.yml on mercadona/rele

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: rele-1.17.2.tar.gz
- Subject digest: 2bfdbc0fed1421964ca44aaa5964e0038f2bc220ebce4aeb57d4b228f4944321
- Sigstore transparency entry: 2369254652
- Sigstore integration time: Aug 7, 2026
Source repository:
- Permalink: mercadona/rele@6c00b8f1ef9bf52b799175a0211191e82106c42d
- Branch / Tag: refs/heads/master
- Owner: https://github.com/mercadona
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release-please.yml@6c00b8f1ef9bf52b799175a0211191e82106c42d
- Trigger Event: push