celery-progress 0.0.2

Drop in, configurable, dependency-free progress bars for your Django/Celery applications.

Drop in, dependency-free progress bars for your Django/Celery applications.

Super simple setup. Lots of customization available.

Usage

Recording Progress

In your task you should add something like this:

from celery_progress.backend import ProgressRecorder

@shared_task(bind=True)
def my_task(self, seconds):
    progress_recorder = ProgressRecorder(self)
    for i in range(seconds):
        time.sleep(i)
        progress_recorder.set_progress(i, seconds)
    return 'done'

Displaying progress

In the view where you call the task you need to get the task ID like so:

views.py

def progress_view(request):
    result = my_task.delay(10)
    return render(request, 'display_progress.html', context={'task_id': task_id})

Then in the page you want to show the progress bar you just do the following.

1. Add the following HTML wherever you want your progress bar to appear:

display_progress.html

<div class='progress-wrapper'>
  <div id='progress-bar' class='progress-bar' style="background-color: #68a9ef; width: 0%;">&nbsp;</div>
</div>
<div id="progress-bar-message">Waiting for progress to start...</div>

2. Import the javascript file.

display_progress.html

<script src="{% static 'celery_progress/celery_progress.js' %}"></script>

3. Initialize the progress bar:

// vanilla JS version
var progressUrl = "{% url 'celery_progress:task_status' task_id %}";
document.addEventListener("DOMContentLoaded", function () {
  CeleryProgressBar.initProgressBar(progressUrl);
});

or

// JQuery
var progressUrl = "{% url 'celery_progress:task_status' task_id %}";
$(function () {
  CeleryProgressBar.initProgressBar(progressUrl)
});

Customization

The initProgressBar function takes an optional object of options. The following options are supported:

Option	What it does	Default Value
pollInter val	How frequently to poll for progress (in milliseconds)	500
progressB arId	Override the ID used for the progress bar	‘progress-bar’
progressB arMessage Id	Override the ID used for the progress bar message	‘progress-bar-me ssage’
progressB arElement	Override the element used for the progress bar. If specified, progressBarId will be ignored.	document.getElem entById(progress BarId)
progressB arMessage Element	Override the element used for the progress bar message. If specified, progressBarMess ageId will be ignored.	document.getElem entById(progress BarMessageId)
onProgres s	function to call when progress is updated	CeleryProgressBa r.onProgressDefa ult
onSuccess	function to call when progress successfully completes	CeleryProgressBa r.onSuccessDefau lt
onError	function to call when progress completes with an error	CeleryProgressBa r.onErrorDefault