Skip to main content

A Redis Backend for Celery with polling instead of pub/sub

Project description

Celery Redis Poll Backend

A specialized Redis backend for Celery that replaces the default pub/sub mechanism for task result retrieval with a polling-based approach.

Why Polling Instead of Pub/Sub?

The default Celery Redis backend uses Redis pub/sub for real-time task result notifications. While pub/sub provides immediate updates, it can face challenges in certain scenarios:

  • Deadlocks in highly concurrent/multi-threaded workloads due to single-threaded nature of Redis and Celery clients.
  • Higher overhead with SUBSCRIBE channels.

This backend provides a more robust alternative by using a polling mechanism instead.

Features

  • Polling-Based Results: Replaces pub/sub with a polling mechanism for task result retrieval
  • Compatible with Existing Code: Drop-in replacement for the standard Redis backend
  • Configurable Polling: Adjust polling intervals and timeouts to match your needs
  • Resource Efficient: Reduces Redis memory usage by eliminating pub/sub channels

Installation

pip install celery-redis-poll

Usage

Configure your Celery application to use the polling backend:

from celery import Celery

app = Celery('your_app',
             broker='redis://localhost:6379/0',
             backend='redispoll://localhost:6379/0')

For clustered Redis, use redisclusterpoll instead of redispoll.

Requirements

  • Python >= 3.7
  • Celery >= 5.0.0
  • Redis >= 4.5.0
  • celery-redis-cluster >= 0.1.6

Development

For development, install extra dependencies:

pip install celery-redis-poll[dev]

License

This project is licensed under the MIT License.

Contributing

Contributions are welcome! Please feel free to submit issues and pull requests.

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

celery_redis_poll-0.1.4.tar.gz (4.3 kB view details)

Uploaded Source

Built Distribution

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

celery_redis_poll-0.1.4-py3-none-any.whl (4.3 kB view details)

Uploaded Python 3

File details

Details for the file celery_redis_poll-0.1.4.tar.gz.

File metadata

  • Download URL: celery_redis_poll-0.1.4.tar.gz
  • Upload date:
  • Size: 4.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.1

File hashes

Hashes for celery_redis_poll-0.1.4.tar.gz
Algorithm Hash digest
SHA256 705e61692ee0081004a79a7064259cf585eda1e4726f6b131cff2c70db0a3097
MD5 f13ff984515b621f3aeb7af28afef8de
BLAKE2b-256 7df1653264b18bd8e6df211502a3f355da94b5c1c614dc42d725db3c4f254339

See more details on using hashes here.

File details

Details for the file celery_redis_poll-0.1.4-py3-none-any.whl.

File metadata

File hashes

Hashes for celery_redis_poll-0.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 afc85e1a56d2aec17656bf3bbdd5d7ef9e0126c2a50122eef11333119c710d0c
MD5 651b81b16eb20afd0a96e61b36bcd1f8
BLAKE2b-256 dbffc432c55e9de6f1ad68009be0579b098abeb5c46eac78cad98535808a72b6

See more details on using hashes here.

Supported by

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