Allow **kwargs in @task decorator to support custom Task subclasses

[Pietro]

Currently, the @task decorator accepts a fixed set of parameters and passes only those to task_class:

Problem: When using a custom backend with a custom task_class that accepts additional parameters (e.g., max_retries, timeout), there's no way to pass those through the decorator.

def task(
    function=None,
    *,
    priority=DEFAULT_TASK_PRIORITY,
    queue_name=DEFAULT_TASK_QUEUE_NAME,
    backend=DEFAULT_TASK_BACKEND_ALIAS,
    takes_context=False,
):
    # ...
    return task_backends[backend].task_class(
        priority=priority,
        func=f,
        queue_name=queue_name,
        backend=backend,
        takes_context=takes_context,
        run_after=None
    )

Proposed solution: Add kwargs to the decorator signature and pass it through to task_class:

def task(
    function=None,
    *,
    priority=DEFAULT_TASK_PRIORITY,
    queue_name=DEFAULT_TASK_QUEUE_NAME,
    backend=DEFAULT_TASK_BACKEND_ALIAS,
    takes_context=False,
    **kwargs,
):
    def wrapper(f):
        return task_backends[backend].task_class(
            priority=priority,
            func=f,
            queue_name=queue_name,
            backend=backend,
            takes_context=takes_context,
            run_after=None,
            **kwargs,
        )
    

Use case example:

class MyTask(Task):
    def __init__(self, *, max_retries=3, timeout=300, **kwargs):
        super().__init__(**kwargs)
        self.max_retries = max_retries
        self.timeout = timeout

# With the proposed change:
@task(backend="my_backend", max_retries=5, timeout=600)
def my_task():
    pass

This change is backwards compatible and aligns with Django's common extensibility patterns.

[Jake Howard]

This sounds like a reasonable change to me.

As for the solution, my suggestion would be to drop all explicit arguments, and only accept **kwargs in the @task decorator - instead moving the defaults to the Task class itself. That also means that, for whatever reason, a custom Task can override defaults.

[Nilesh Pahari]

PR: ​https://github.com/django/django/pull/20456

[Kerollos Emad]

​PR

[Jacob Walls <jacobtylerwalls@…>]

In e27f23b:

Fixed #36816 -- Allowed kwargs in @task decorator.

The decorator was updated to accept kwargs and forward them to
task_class, allowing additional parameters to be passed to custom
Task subclasses.