python-rq
Port variant v13
Summary Library for procesing background jobs (3.13)
Package version 2.4.1
Homepage https://python-rq.org/
Keywords python
Maintainer Python Automaton
License Not yet specified
Other variants v12
Ravenports Buildsheet | History
Ravensource Port Directory | History
Last modified 20 JUL 2025, 18:08:53 UTC
Port created 01 JAN 2023, 17:21:46 UTC
Subpackage Descriptions
single RQ (_Redis Queue_) is a simple Python library for queueing jobs and processing them in the background with workers. It is backed by Redis or Valkey and is designed to have a low barrier to entry while scaling incredibly well for large applications. It can be integrated into your web stack easily, making it suitable for projects of any size—from simple applications to high-volume enterprise systems. RQ requires Redis >= 5 or Valkey >= 7.2. [Build status] [PyPI] [Coverage] [![Code style: Ruff]](https://github.com/astral-sh/ruff) Full documentation can be found [here][d]. ## Support RQ If you find RQ useful, please consider supporting this project via [Tidelift]. ## Getting started First, run a Redis server, of course: ```console $ redis-server ``` To put jobs on queues, you don't have to do anything special, just define your typically lengthy or blocking function: ```python import requests def count_words_at_url(url): """Just an example function that's called async.""" resp = requests.get(url) return len(resp.text.split()) ``` Then, create an RQ queue: ```python from redis import Redis from rq import Queue queue = Queue(connection=Redis()) ``` And enqueue the function call: ```python from my_module import count_words_at_url job = queue.enqueue(count_words_at_url, 'https://stamps.id') ``` ## Job Prioritization By default, jobs are added to the end of a single queue. RQ offers two ways to give certain jobs higher priority: #### 1. Enqueue at the front You can enqueue a job at the front of its queue so it’s picked up before other jobs: ```python job = queue.enqueue(count_words_at_url, 'https://stamps.id', at_front=True) ``` #### 2. Use multiple queues You can create multiple queues and enqueue jobs into different queues based on their priority: ```python from rq import Queue high_priority_queue = Queue('high', connection=Redis()) low_priority_queue = Queue('low', connection=Redis()) # This job will be picked up before jobs in the low priority queue # even if it was enqueued later high_priority_queue.enqueue(urgent_task) low_priority_queue.enqueue(non_urgent_task) ``` Then start workers with a prioritized queue list: ```console $ rq worker high low ``` This command starts a worker that listens to both `high` and `low` queues. The worker will process jobs from the `high` queue first, followed by the `low` queue. You can also run different workers for different queues, allowing you to scale your workers based on the number of jobs in each queue.
Configuration Switches (platform-specific settings discarded)
PY312 OFF Build using Python 3.12 PY313 ON Build using Python 3.13
Package Dependencies by Type
Build (only) python313:dev:std
python-pip:single:v13
autoselect-python:single:std
Build and Runtime python313:primary:std
Runtime (only) python-click:single:v13
python-redis:single:v13
Download groups
main mirror://PYPIWHL/8a/c4/ffd7a6d9a706a50ab91c8bd42ff54cd9b228613d6bb80f7728a5144518b1
Distribution File Information
a3a0839ba3213a9be013b398670caf71d9360a0c8525f343687cf2c2199e5ec8 108014 python-src/rq-2.4.1-py3-none-any.whl
Ports that require python-rq:v13
python-django-rq:v13 Django integration of Redis Queue (3.13)
python-rq-scheduler:v13 Job scheduling capabilities to Redis Queue (3.13)