edx-celeryutils

library2.0.0pypypiunverified

Utilities for using Celery in edx-platform. Version 2.0.0 supports Python 3.12, dropped Python 3.11. Maintained by Open edX.

workflow

pip install edx-celeryutils

github ↗package ↗

INSTALL

IMPORT

SIG · EDX-CELERYUTILS

edx-celeryutils

workflowpythonv2.0.0

Install

5.5s avg

Import

—

Disk

87MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v2.0.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 89.5MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 5.5s · import 0.000s · 90MB

87MB installed

● package 87MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

TaskProgress

✓ from celery_utils import TaskProgress

✗ from celery_utils import TaskProgress

Basic usage of TaskProgress to track Celery task progress.

from edx_celeryutils import TaskProgress # Create a task progress tracker progress = TaskProgress('my_task', total_steps=10) progress.update_work()

Debug

Known issues

breakingDropped Python 3.11 support in v2.0.0; use Python 3.12+.

fix

Upgrade to Python 3.12 or later.

affects: >=2.0.0

gotchaThe package no longer includes 'arbi-bom' references; old imports related to that may break.

fix

Remove any usage of 'arbi_bom' from your codebase.

affects: >=2.0.0

deprecatedThe 'celery' task decorator usage with this package is deprecated in favor of class-based tasks.

fix

Use Celery's @shared_task decorator or custom task classes.

affects: >=1.3.0

gotchaIf using with Django, ensure 'celery' app is properly configured before importing edx_celeryutils.

fix

Configure your Django settings with CELERY_BROKER_URL and other Celery settings before importing from edx_celeryutils.

affects: all

Upgrade

Version history

2.0.0latest on PyPI · released Apr 7, 2026

Audit

Dependencies

celeryrequiredCore dependency for task creation and management.

djangooptionalSupports Django model integration for task tracking.

Agent activity

24 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

githubhttps://github.com/openedx/edx-celeryutils ↗

packagehttps://pypi.org/project/edx-celeryutils/ ↗