Donald is here
Project description
Donald – A simple task engine for Asyncio.
The main goal for Donald to run async/sync code without blocking main loop.
Donald supports synchronous and asynchronous paradigms. The package is running coroutines and functions in multi loops. Donald could run periodic tasks and listen AMQP queues.
Requirements
python 3.8+
Installation
Donald should be installed using pip:
pip install donald
Usage
From shell:
$ donald --help
From asynchronous python code:
# Init Donald
donald = Donald(
# Params (default values)
# -----------------------
# Run tasks imediatelly in the same process/thread
fake_mode=False,
# Number of workers
num_workers=multiprocessing.cpu_count() - 1,
# Maximum concurent tasks per worker
max_tasks_per_worker=100,
# Ensure that the Donald starts only once (set to filename to lock)
filelock=None,
# logging level
loglevel='INFO',
# AMQP params
queue=False,
queue_name='donald',
queue_params={},
)
# Schedule periodic tasks
@donald.schedule(crontab_string | seconds_float | datetime_timedelta, *args, **kwargs)
async def task(*args, **kwargs):
# ...
# Start the donald
await donald.start()
# ...
# Submit a task to donald
donald.submit(corofunction or function, *args, **kwargs)
# Submit and wait for result
result = await donald.submit(corofunction or function, *args, **kwargs)
# Submit a task to queue
queue.submit(corofunction or function, *args, **kwargs)
await donald.queue.submit(corofunction or function, *args, **kwargs)
# note: queue dont support waiting for results
# ...
# Stop the donald
await donald.stop()Connect and receive tasks using AMQP
donald = Donald()
await donald.start()
await donald.queue.start()
# ...
# Stop the donald
await donald.queue.stop()
await donald.stop()Submit tasks to AMQP
# Send task to queue
await donald.queue.submit(<coro or func>, *args, **kwargs)
# ...Bug tracker
If you have any suggestions, bug reports or annoyances please report them to the issue tracker at https://github.com/klen/donald/issues
Contributing
Development of starter happens at github: https://github.com/klen/donald
Contributors
klen (Kirill Klenov)
License
Licensed under a BSD license.
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.
Source Distribution
Built Distribution
File details
Details for the file donald-0.8.0.tar.gz.
File metadata
- Download URL: donald-0.8.0.tar.gz
- Upload date:
- Size: 9.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.1 importlib_metadata/4.5.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.0 CPython/3.9.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 0a21fde5a2274fa04a40d91d2858218c6e14353a5e76f9e7b3a69e51eaed582c |
|
| MD5 | 51502ad9c3adfc6f83cd1d4cf1f9423e |
|
| BLAKE2b-256 | f21c2a2d1c09a0ed34d1e4b6b3dfab7cddd974c2365a9fdaa6645ea65d6d81b4 |
File details
Details for the file donald-0.8.0-py3-none-any.whl.
File metadata
- Download URL: donald-0.8.0-py3-none-any.whl
- Upload date:
- Size: 10.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.1 importlib_metadata/4.5.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.0 CPython/3.9.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 2501c3bbfcc2c407edf18377239be6e74a387e15868b8652ffab555bb0c3fb24 |
|
| MD5 | 0353bbf14f5000f8b078248698cb89a9 |
|
| BLAKE2b-256 | c680f415218a387d80dda08e2c96f45bb4570404808cf34f2be4014cb9fdd62c |
