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

celery.app.utils

celery.app.utils

App utilities: Compat settings, bugreport tool, pickling apps.

class celery.app.utils.Settings(changes, defaults)[source]

Celery settings object.

BROKER_BACKEND

Deprecated compat alias to BROKER_TRANSPORT.

BROKER_TRANSPORT
BROKER_URL
CELERY_RESULT_BACKEND
CELERY_TIMEZONE
find_option(name, namespace='celery')[source]

Search for option by name.

Will return (namespace, key, type) tuple, e.g.:

>>> from proj.celery import app
>>> app.conf.find_option('disable_rate_limits')
('CELERY', 'DISABLE_RATE_LIMITS',
 <Option: type->bool default->False>))
Parameters:
  • name – Name of option, cannot be partial.
  • namespace – Preferred namespace (CELERY by default).
find_value_for_key(name, namespace='celery')[source]

Shortcut to get_by_parts(*find_option(name)[:-1])

get_by_parts(*parts)[source]

Return the current value for setting specified as a path.

Example:

>>> from proj.celery import app
>>> app.conf.get_by_parts('CELERY', 'DISABLE_RATE_LIMITS')
False
humanize(with_defaults=False, censored=True)[source]

Return a human readable string showing changes to the configuration.

table(with_defaults=False, censored=True)[source]
value_set_for(key)[source]
without_defaults()[source]

Return the current configuration, but without defaults.

celery.app.utils.appstr(app)[source]

String used in __repr__ etc, to id app instances.

celery.app.utils.bugreport(app)[source]

Return a string containing information useful in bug reports.

celery.app.utils.filter_hidden_settings(conf)[source]
celery.app.utils.find_app(app, symbol_by_name=<function symbol_by_name>, imp=<function import_from_cwd>)[source]