remoulade
A fast and reliable distributed task processing library for Python 3. Fork of dramatiq.io
Changelog: https://remoulade.readthedocs.io/en/latest/changelog.html
Documentation: https://remoulade.readthedocs.io
Installation
If you want to use it with RabbitMQ
uv pip install 'remoulade[rabbitmq]'
If you want to use it with PostgreSQL and PGMQ
uv pip install 'remoulade[postgres]'
If you want Redis-backed extras like results or cancellation, add Redis to the broker extra you use:
uv pip install 'remoulade[rabbitmq, redis]'
uv pip install 'remoulade[postgres, redis]'
Quickstart
- Make sure you've got RabbitMQ running, then create a new file called
example.py:
from remoulade.brokers.rabbitmq import RabbitmqBroker
import remoulade
import requests
import sys
broker = RabbitmqBroker()
remoulade.set_broker(broker)
@remoulade.actor
def count_words(url):
response = requests.get(url)
count = len(response.text.split(" "))
print(f"There are {count} words at {url!r}.")
broker.declare_actor(count_words)
if __name__ == "__main__":
count_words.send(sys.argv[1])
- In one terminal, run your workers:
remoulade example
- In another, start enqueueing messages:
python3 example.py http://example.com
python3 example.py https://github.com
python3 example.py https://news.ycombinator.com
Visit the user guide to see more features!.
Releasing
If you want to contribute to the project. First make a Pull request and get approval from a Maintainer and then:
- Merge your pull request
- Push a tag (must start with a
v) from the commit you want (usually, themasterbranch) a. You can create a new release on Github (recommended). This will create and push the tag for you. b. Update your local clone, checkoutmaster,git tagand thengit push --tags
This will trigger a CI/CD pipeline that publish the package
Kubernetes
Remoulade is tailored to run transparently in containers on Kubernetes and to make the most of their features. This does not mean it cannot run outside of Kubernetes ;)
Monitoring/Prometheus
Remoulade provides a Prometheus Middleware that exposes various metrics (processed messages, retries, fails etc.), Check it out.
Tracing/OpenTelemtry
Take a look at opentelemetry-instrumentation-remoulade if you want to enable tracing for Remoulade operations (enqueue, message processing, retries etc.). See here for an example. The library follows OpenTelemetry standards.
License
remoulade is licensed under the LGPL. Please see COPYING and COPYING.LESSER for licensing details.
2 maintainers
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file remoulade-7.0.0.tar.gz.
File metadata
- Download URL: remoulade-7.0.0.tar.gz
- Upload date:
- Size: 110.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2c54a582526dd923dc96e41c7362952373aa9dc56d3b787c366cfa77cbf0b9ab
|
|
| MD5 |
a48aea2594b78fa50d2a3afa683eed75
|
|
| BLAKE2b-256 |
3df7c76b62e06a81b967c526a9672c217d8cb606fab65830502fa0b037fd62a4
|
Provenance
The following attestation bundles were made for remoulade-7.0.0.tar.gz:
Publisher:
pythonpublish.yml on wiremind/remoulade
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
remoulade-7.0.0.tar.gz -
Subject digest:
2c54a582526dd923dc96e41c7362952373aa9dc56d3b787c366cfa77cbf0b9ab - Sigstore transparency entry: 2138271237
- Sigstore integration time:
-
Permalink:
wiremind/remoulade@685411f94ce80a97107318ceedf4685c754e03db -
Branch / Tag:
refs/tags/v7.0.0 - Owner: https://github.com/wiremind
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
pythonpublish.yml@685411f94ce80a97107318ceedf4685c754e03db -
Trigger Event:
push
-
Statement type:
File details
Details for the file remoulade-7.0.0-py3-none-any.whl.
File metadata
- Download URL: remoulade-7.0.0-py3-none-any.whl
- Upload date:
- Size: 164.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ab9dc90ae506c52ca63ae5ac7f0c1df217dcebef839b84535052cf720a0c4752
|
|
| MD5 |
9ec6b8cd92952060e20312f48e595a0c
|
|
| BLAKE2b-256 |
21511bf74a2d8a235840aaad299298fbebeb2b46c47e92f99062a49049faa240
|
Provenance
The following attestation bundles were made for remoulade-7.0.0-py3-none-any.whl:
Publisher:
pythonpublish.yml on wiremind/remoulade
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
remoulade-7.0.0-py3-none-any.whl -
Subject digest:
ab9dc90ae506c52ca63ae5ac7f0c1df217dcebef839b84535052cf720a0c4752 - Sigstore transparency entry: 2138271250
- Sigstore integration time:
-
Permalink:
wiremind/remoulade@685411f94ce80a97107318ceedf4685c754e03db -
Branch / Tag:
refs/tags/v7.0.0 - Owner: https://github.com/wiremind
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
pythonpublish.yml@685411f94ce80a97107318ceedf4685c754e03db -
Trigger Event:
push
-
Statement type:
