django-bg-task 0.0.0

A small Django DRF extension for managing background task with celery

django-task

django-task is a library designed to assist you in tracking Celery tasks within your Django project. It provides a seamless integration with your current database and offers RESTful APIs for managing and monitoring your tasks.

Features

• Task Tracking: With django-task, you can easily track the status, progress, and result of your Celery tasks. The library stores this information in your database, allowing you to retrieve and analyze task data at any time.

• RESTful APIs: django-task exposes a set of RESTful APIs that enable you to interact with your Celery tasks programmatically. You can create, update, delete, and retrieve tasks using these APIs, providing flexibility in managing your task workflow.

• Integration with Celery: This library seamlessly integrates with Celery, a widely-used distributed task queue framework. You can use all the powerful features of Celery, such as task scheduling, distributed processing, and task retries, while leveraging django-task for task tracking and management.

Installation

You can install django-task using pip:

pip install django-task

Make sure you have Celery and Django installed as well.

Usage

Once installed and configured, you can start tracking your Celery tasks using django-task. Here's a basic example of how to use the library:

from django_task.models import Task
from django_task.serializers import TaskSerializer

# Create a new task
task = Task.objects.create(name='my_task', status='PENDING', progress=0)

# Update task status and progress
task.status = 'STARTED'
task.progress = 50
task.save()

# Retrieve task information
serialized_task = TaskSerializer(task)
print(serialized_task.data)

This example demonstrates creating a new task, updating its status and progress, and retrieving the task information using the provided serializer.

For detailed usage instructions and available APIs, please refer to the documentation.

Contributing

Contributions to django-task are welcome! If you encounter any issues, have suggestions, or would like to contribute new features, please feel free to open an issue or submit a pull request on the GitHub repository.

When contributing, please ensure that you follow the existing coding style, write tests for new functionality, and update the documentation accordingly.

License

This project is licensed under the MIT License.