This document describes the current stable version of Celery (4.2). For development docs, go here.

celery.worker.request

Task request.

This module defines the Request class, that specifies how tasks are executed.

class celery.worker.request.Request(message, on_ack=<function noop>, hostname=None, eventer=None, app=None, connection_errors=None, request_dict=None, task=None, on_reject=<function noop>, body=None, headers=None, decoded=False, utc=True, maybe_make_aware=<function maybe_make_aware>, maybe_iso8601=<function maybe_iso8601>, **opts)

A request for task execution.

acknowledge()

Acknowledge task.

acknowledged = False

app

argsrepr

body

chord

connection_errors

content_encoding

content_type

correlation_id

delivery_info

errbacks

eta

eventer

execute(loglevel=None, logfile=None)

Execute the task in a trace_task().

Parameters:

• loglevel (int) – The loglevel used by the task.
• logfile (str) – The logfile used by the task.

execute_using_pool(pool, **kwargs)

Used by the worker to send this task to the pool.

Parameters:pool (TaskPool) – The execution pool used to execute this request. Raises:celery.exceptions.TaskRevokedError – if the task was revoked.

expires

group

hostname

humaninfo()

id

info(safe=False)

kwargsrepr

maybe_expire()

If expired, mark the task as revoked.

name

on_accepted(pid, time_accepted)

Handler called when task is accepted by worker pool.

on_ack

on_failure(exc_info, send_failed_event=True, return_ok=False)

Handler called if the task raised an exception.

on_reject

on_retry(exc_info)

Handler called if the task should be retried.

on_success(failed__retval__runtime, **kwargs)

Handler called if the task was successfully processed.

on_timeout(soft, timeout)

Handler called if the task times out.

parent_id

reject(requeue=False)

reply_to

request_dict

revoked()

If revoked, skip task and mark state.

root_id

send_event(type, **fields)

store_errors

task

task_id

task_name

terminate(pool, signal=None)

time_limits = (None, None)

time_start = None

type

tzlocal

utc

worker_pid = None