A concurrent.futures.Executor implementation using Celery as backend
Project description
Celery Executor
A concurrent.futures.Executor
implementation using Celery as backend
- Free software: Apache Software License 2.0
- Documentation: https://celery-executor.readthedocs.io.
Features
The package provides a CeleryExecutor
implementing the interface of
concurrent.futures.Executor
>>> from celery_executor.executors import CeleryExecutor >>> executor = CeleryExecutor() >>> for result in executor.map(str.upper, ['one', 'two', 'three']): ... print(result) ONE TWO THREE
Beware that the Executor.map()
interface can yield the results out of order,
if later ones got to finish first.
Caveats
This executor frees the developer to the burden of mark every single task function with the Celery decorators, and to import such tasks on the Worker beforehand. But does not frees from sending the code to the Worker.
The function sent to CeleryExecutor.map()
should be pickable on the client
(caller of .map()
or .submit()
) and should be unpickable on the Celery
Worker handling the "Task" sent. Is not possible to send lambdas for example.
As Celery assumes that is to the developer to put the needed code on the Worker,
be sure that the function/partial code sent to CeleryExecutor
to exist on the
Worker.
To Be Done
- <input type="checkbox" disabled="" /> Document the
CeleryExecutor.__init__()
nonstandard extra optionspredelay
,postdelay
andapplyasync_kwargs
. - <input type="checkbox" disabled="" /> Test behaviours of canceling a Task when canceling a Future
- <input type="checkbox" disabled="" /> Test behaviours of shutting down executors and trying to send new tasks
- <input type="checkbox" disabled="" /> Find a way to test the RUNNING state of Celery Tasks, as its events are not propagated by the test worker Celery provides
Credits
This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage
project template.
======= History
0.1.0 (2018-05-25)
- First release on PyPI.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Filename, size | File type | Python version | Upload date | Hashes |
---|---|---|---|---|
Filename, size celery_executor-0.2.0-py2.py3-none-any.whl (4.6 kB) | File type Wheel | Python version py2.py3 | Upload date | Hashes View |
Filename, size celery-executor-0.2.0.tar.gz (12.6 kB) | File type Source | Python version None | Upload date | Hashes View |
Hashes for celery_executor-0.2.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1ca778c0a59652bf4480af1489e9ba1315d38315ea9939c6ef5df348c3e4ba08 |
|
MD5 | 6ec6b2e03cd0884d2d552514abb0711c |
|
BLAKE2-256 | 71c843caf397e90a0cedb93811aedfe88ce6df9c4ab9eb44881c89b313b59f40 |