Add types for celery.contrib.django.task.DjangoTask (#173)

Author: federicobond

celery-stubs/contrib/__init__.pyi

@@ -0,0 +1,45 @@
+from collections.abc import Mapping
+from datetime import datetime
+from typing import Any, ParamSpec, TypeVar
+
+import celery
+import kombu
+from celery.app.task import Task
+from celery.canvas import Signature
+
+_P = ParamSpec("_P")
+_R = TypeVar("_R", covariant=True)
+
+class DjangoTask(Task[_P, _R]):
+    def delay_on_commit(
+        self, *args: _P.args, **kwargs: _P.kwargs
+    ) -> celery.result.AsyncResult[_R]: ...
+    def apply_async_on_commit(
+        self,
+        args: tuple[Any, ...] | None = ...,
+        kwargs: dict[str, Any] | None = ...,
+        task_id: str | None = ...,
+        producer: kombu.Producer | None = ...,
+        link: Signature[Any] | list[Signature[Any]] | None = ...,
+        link_error: Signature[Any] | list[Signature[Any]] | None = ...,
+        shadow: str | None = ...,
+        *,
+        # options
+        countdown: float = ...,
+        eta: datetime = ...,
+        expires: float | datetime = ...,
+        retry: bool = ...,
+        retry_policy: Mapping[str, Any] = ...,
+        queue: str | kombu.Queue = ...,
+        exchange: str | kombu.Exchange = ...,
+        routing_key: str = ...,
+        priority: int = ...,
+        serializer: str = ...,
+        compression: str = ...,
+        add_to_parent: bool = ...,
+        publisher: kombu.Producer = ...,
+        headers: dict[str, str] = ...,
+        ignore_result: bool = ...,
+        time_limit: int = ...,
+        soft_time_limit: int = ...,
+    ) -> celery.result.AsyncResult[_R]: ...

celery-stubs/contrib/django/__init__.pyi

@@ -9,6 +9,7 @@
 from celery import Celery, shared_task, signature
 from celery.app.task import Task
 from celery.canvas import Signature, chord
+from celery.contrib.django.task import DjangoTask
 from celery.exceptions import Reject
 from celery.result import AsyncResult, allow_join_result, denied_join_result
 from celery.schedules import crontab
@@ -289,3 +290,8 @@ def test_celery_top_level_exports() -> None:
     celery.uuid
     celery.xmap
     celery.xstarmap
+
+
+def test_djangotask(task: DjangoTask[[int, int], Any]) -> None:
+    task.delay_on_commit(1, 2)
+    task.apply_async_on_commit((1, 2), countdown=10.0)