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.5.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.5-py3-none-any.whl (4.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: celery_redis_poll-0.1.5.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.5.tar.gz
Algorithm Hash digest
SHA256 d20308a2eccec0d65361b8f99b8af7a1788c4ed9c1b99a765bcbd94b9c7cdcb7
MD5 d68f8a305df54aff502dedabe0465f1f
BLAKE2b-256 791296fa9ae3c25d5dae17b75f454b1927856e588b5006357b818d250661c2b9

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for celery_redis_poll-0.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 bb2bc27aeb40fcb62af247d58312edf7d6f9fdbc3e9b686ab120a4bf5358ae10
MD5 9fa80b0232faa0b3dc552066bc0420d7
BLAKE2b-256 a3d20f9f87b97769c309fdcff991244d3ef9a5ab3f03df05bc43f877d21313b7

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