Skip to main content

shell

Start shell session with convenient access to celery symbols.

The following symbols will be added to the main globals:

  • celery: the current application.
  • chord, group, chain, chunks, xmap, xstarmap subtask, Task
  • all registered tasks.
def shell(
ctx: click.Context,
ipython: boolean = False,
bpython: boolean = False,
python: boolean = False,
without_tasks: boolean = False,
eventlet: boolean = False,
gevent: boolean = False,
**kwargs: dict
) - > null

Start shell session with convenient access to celery symbols. The following symbols will be added to the main globals: celery, chord, group, chain, chunks, xmap, xstarmap, subtask, Task, and all registered tasks.

Parameters

NameTypeDescription
ctxclick.ContextThe Click context object containing the application instance and configuration.
ipythonboolean = FalseFlag to force the use of the IPython shell environment.
bpythonboolean = FalseFlag to force the use of the bpython shell environment.
pythonboolean = FalseFlag to force the use of the standard default Python interactive shell.
without_tasksboolean = FalseIf true, prevents registered Celery tasks from being automatically added to the shell's local namespace.
eventletboolean = FalseFlag to enable the eventlet monkey patching for concurrent execution within the shell.
geventboolean = FalseFlag to enable the gevent monkey patching for concurrent execution within the shell.
**kwargsdictAdditional keyword arguments passed from the command line interface.

Returns

TypeDescription
nullThis function does not return a value; it starts an interactive shell session and exits when the session ends.