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

celery.utils.imports

celery.utils.import

Utilities related to importing modules and symbols by name.

exception celery.utils.imports.NotAPackage[source]
celery.utils.imports.qualname(obj)[source]
celery.utils.imports.instantiate(name, *args, **kwargs)[source]

Instantiate class by name.

See symbol_by_name().

celery.utils.imports.symbol_by_name(name, aliases={}, imp=None, package=None, sep='.', default=None, **kwargs)

Get symbol by qualified name.

The name should be the full dot-separated path to the class:

modulename.ClassName

Example:

celery.concurrency.processes.TaskPool
                            ^- class name

or using ‘:’ to separate module and symbol:

celery.concurrency.processes:TaskPool

If aliases is provided, a dict containing short name/long name mappings, the name is looked up in the aliases first.

Examples:

>>> symbol_by_name('celery.concurrency.processes.TaskPool')
<class 'celery.concurrency.processes.TaskPool'>
>>> symbol_by_name('default', {
...     'default': 'celery.concurrency.processes.TaskPool'})
<class 'celery.concurrency.processes.TaskPool'>

# Does not try to look up non-string names. >>> from celery.concurrency.processes import TaskPool >>> symbol_by_name(TaskPool) is TaskPool True

celery.utils.imports.cwd_in_path(*args, **kwds)[source]
celery.utils.imports.find_module(module, path=None, imp=None)[source]

Version of imp.find_module() supporting dots.

celery.utils.imports.import_from_cwd(module, imp=None, package=None)[source]

Import module, but make sure it finds modules located in the current directory.

Modules located in the current directory has precedence over modules located in sys.path.

celery.utils.imports.reload_from_cwd(module, reloader=None)[source]
celery.utils.imports.module_file(module)[source]

Return the correct original file name of a module.

Previous topic

celery.utils.timer2

Next topic

celery.utils.log

This Page