Django Academy · درس

كتابة واستدعاء @shared_task

تشغيل الدوال بشكل غير متزامن باستخدام delay()

الدرس 3 من 413 خطوة

كتابة واستدعاء @shared_task درس مجاني في Django Academy على CoddyKit. هذا هو الدرس 3 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في Django Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة Django Academy 4 دروس في المجموع.

بعض أجزاء هذا الدرس لم تُترجم بعد وتظهر باللغة الإنجليزية.

Tasks Are Just Functions

A Celery task is an ordinary Python function with a decorator on top. The decorator teaches Celery how to queue and run it later.

Why shared_task

Use @shared_task instead of @app.task so your tasks do not depend on a specific Celery app. It is the standard choice inside Django apps.

Write Your First Task

Put tasks in a tasks.py inside an app. Decorate a plain function and Celery picks it up via autodiscover.

from celery import shared_task

@shared_task
def add(x, y):
    return x + y

Call It with delay

To run a task in the background, call .delay() instead of calling the function directly. It queues the job and returns at once.

add.delay(2, 3)  # queued, runs on a worker

delay vs Calling Directly

Calling add(2, 3) runs it right now in your web process. Calling add.delay(2, 3) sends it to the queue. Same function, very different timing.

Pass Simple Arguments

Arguments are serialized to JSON and sent to the broker, so pass simple values like IDs and strings, not whole model objects.

send_email.delay(user.id)   # good
send_email.delay(user)      # avoid: not serializable

The AsyncResult Handle

delay() returns an AsyncResult. You can store its id and later check status or fetch the return value from the result backend.

result = add.delay(2, 3)
print(result.id)

More Control with apply_async

Need a countdown or a specific queue? Use apply_async(), the fuller version of delay with extra options.

add.apply_async((2, 3), countdown=10)  # run after 10s

Retry on Failure

Bind a task and call self.retry() to re-run it after an error, perfect for flaky network calls that may succeed next time.

@shared_task(bind=True, max_retries=3)
def fetch(self):
    try:
        call_api()
    except Exception as e:
        raise self.retry(exc=e)

Idempotent Tasks Win

Because tasks can retry, aim to make them idempotent: running twice should be safe and not double-charge or double-send. 🔁

Watch the Worker Log

When you call delay, watch the worker terminal. You will see the task received and its result, which is the fastest way to debug. 👀

Quick Check

How do you run a Celery task in the background?

أجب عليها في الدرس التفاعلي

Recap: Writing Tasks

Decorate a function with @shared_task, call it with .delay() to queue it, pass simple ids, and design tasks to retry safely. 🎯

البدء مجانًا

تعلم Python مع معلم ذكاء اصطناعي — مجانًا

اكتب وقم بتشغيل أكوادك الفعلية في المتصفح، واحصل على مساعدة فورية من معلم ذكاء اصطناعي متاح 24/7، واستمر من حيث توقفت على الويب أو في التطبيق.

الدورات: 30
الدروس: 120

ابدأ التعلم مجانًا عرض الدورة الكاملة

الأسئلة الشائعة

هل درس «كتابة واستدعاء @shared_task» مجاني؟

نعم — نص درس «كتابة واستدعاء @shared_task» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة Django Academy، انتقل إلى CoddyKit PRO. تتضمن دورة Django Academy 4 دروس في المجموع.

ماذا ستتعلم في «كتابة واستدعاء @shared_task»؟

تشغيل الدوال بشكل غير متزامن باستخدام delay() تتمرن على Django Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ Django Academy؟

لا تُشترط خبرة سابقة. Django Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 3 من أصل 4.

كم من الوقت يستغرق درس «كتابة واستدعاء @shared_task»؟

معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.

هل يمكنني كتابة وتشغيل أكواد في درس Django Academy هذا؟

نعم. كل درس في Django Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.

جميع الدروس في هذه الدورة

← العودة إلى Django Academy