The missing test library for Celery.
Project description
The missing test library for the Celery Python library. Some of the things graveolens can help with include:
Provide resultss to Celery task calls without hitting your broker.
Ensuring that you know exactly which tasks are called.
Easily assert the arguments of task calls.
Easily handle results when using send_task in Celery.
The binomial name for celery is Apium graveolens.
Returning Results
from my_app.celery import app
import graveolens
def test_my_task():
with graveolens.activate() as celery:
celery.add('my_app.task', {'done': True, 'status': 'OK'})
result = app.send_task('my_app.task', 'test', id=3)
# The result is an EagerResult from Celery.
assert result.get() == {'done': True, 'status': 'OK'}
# You can also check ALL the calls that Celery received.
assert len(celery.calls) == 1
assert celery.calls[0].name == 'http://twitter.com/api/1/foobar'
assert celery.calls[0].args == ('test', )
assert celery.calls[0].kwargs == {'id': 3}
Asserting Celery Calls
By default, if a result is added and unused this raises an AssertionError when the context manager exits, e.g.:
import graveolens
def test_my_task():
with graveolens.activate() as celery:
celery.add('my_app.task')
# Assertion will be raised here because 'my_app.task' is never called.
This can be configured using the assert_all_tasks_called flag to activate().
Additionally, if a Celery task is called without having a result set-up then graveolens.NotMockedTask will be raised.
from my_app.celery import app
import graveolens
def test_my_task():
with graveolens.activate() as celery:
try:
result = app.send_task('my_app.task', 'test', id=3)
except graveolens.NotMockedTask:
# Exception will be raised since my_app.task has no result.
pass
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Hashes for graveolens-0.1.4-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d4311cfb664157bbe50e3074ce3ad2421ce69e0d57d815c9af11994254b45547 |
|
MD5 | b75a8edc8d39b788dbd23ee68b0cc0a4 |
|
BLAKE2b-256 | 7960f7767ce467f24d6787bfc44cc3b6cd199bac016c2fedd0a63dfcafa25200 |