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

celery.exceptions

celery.exceptions

This module contains all exceptions used by the Celery API.

exception celery.exceptions.SecurityError

Security related exceptions.

Handle with care.

exception celery.exceptions.Ignore

A task can raise this to ignore doing state updates.

exception celery.exceptions.QueueNotFound

Task routed to a queue not in CELERY_QUEUES.

exception celery.exceptions.WorkerShutdown

Signals that the worker should perform a warm shutdown.

exception celery.exceptions.WorkerTerminate

Signals that the worker should terminate immediately.

exception celery.exceptions.ImproperlyConfigured

Celery is somehow improperly configured.

exception celery.exceptions.NotRegistered

The task is not registered.

exception celery.exceptions.AlreadyRegistered

The task is already registered.

exception celery.exceptions.TimeoutError

The operation timed out.

exception celery.exceptions.MaxRetriesExceededError

The tasks max restart limit has been exceeded.

exception celery.exceptions.Retry(message=None, exc=None, when=None, **kwargs)

The task is to be retried later.

exc = None

Exception (if any) that caused the retry to happen.

humanize()

message = None

Optional message describing context of retry.

when = None

Time of retry (ETA), either numbers.Real or datetime.

exception celery.exceptions.TaskRevokedError

The task has been revoked, so no result available.

exception celery.exceptions.NotConfigured

Celery has not been configured, as no config module has been found.

exception celery.exceptions.AlwaysEagerIgnored

send_task ignores CELERY_ALWAYS_EAGER option

exception celery.exceptions.InvalidTaskError

The task has invalid data or is not properly constructed.

exception celery.exceptions.ChordError

A task part of the chord raised an exception.

exception celery.exceptions.CPendingDeprecationWarning

exception celery.exceptions.CDeprecationWarning

exception celery.exceptions.FixupWarning

exception celery.exceptions.DuplicateNodenameWarning

Multiple workers are using the same nodename.

exception celery.exceptions.SoftTimeLimitExceeded

The soft time limit has been exceeded. This exception is raised to give the task a chance to clean up.

exception celery.exceptions.TimeLimitExceeded

The time limit has been exceeded and the job has been terminated.

exception celery.exceptions.WorkerLostError

The worker processing a job has exited prematurely.

exception celery.exceptions.Terminated

The worker processing a job has been terminated by user request.