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

celery.bin.base

Click customizations for Celery.

class celery.bin.base.CLIContext(app, no_color, workdir, quiet=False)[source]

Context Object for the CLI.

property ERROR
property OK
echo(message=None, **kwargs)[source]
error(message=None, **kwargs)[source]
pretty(n)[source]
pretty_dict_ok_error(n)[source]
pretty_list(n)[source]
say_chat(direction, title, body='', show_body=False)[source]
secho(message=None, **kwargs)[source]
style(message=None, **kwargs)[source]
class celery.bin.base.CeleryCommand(name: str | None, context_settings: MutableMapping[str, Any] | None = None, callback: Callable[[...], Any] | None = None, params: List[Parameter] | None = None, help: str | None = None, epilog: str | None = None, short_help: str | None = None, options_metavar: str | None = '[OPTIONS]', add_help_option: bool = True, no_args_is_help: bool = False, hidden: bool = False, deprecated: bool = False)[source]

Customized command for Celery.

format_options(ctx, formatter)[source]

Write all the options into the formatter if they exist.

class celery.bin.base.CeleryDaemonCommand(*args, **kwargs)[source]

Daemon commands.

class celery.bin.base.CeleryOption(*args, **kwargs)[source]

Customized option for Celery.

get_default(ctx, *args, **kwargs)[source]

Get the default for the parameter. Tries Context.lookup_default() first, then the local default.

Parameters:
  • ctx – Current context.

  • call – If the default is a callable, call it. Disable to return the callable instead.

Changed in version 8.0.2: Type casting is no longer performed when getting a default.

Changed in version 8.0.1: Type casting can fail in resilient parsing mode. Invalid defaults will not prevent showing help text.

Changed in version 8.0: Looks at ctx.default_map first.

Changed in version 8.0: Added the call parameter.

class celery.bin.base.CommaSeparatedList[source]

Comma separated list argument.

convert(value, param, ctx)[source]

Convert the value to the correct type. This is not called if the value is None (the missing value).

This must accept string values from the command line, as well as values that are already the correct type. It may also convert other compatible types.

The param and ctx arguments may be None in certain situations, such as when converting prompt input.

If the value cannot be converted, call fail() with a descriptive message.

Parameters:
  • value – The value to convert.

  • param – The parameter that is using this type to convert its value. May be None.

  • ctx – The current context that arrived at this value. May be None.

name: str = 'comma separated list'

the descriptive name of this type

class celery.bin.base.DaemonOption(*args, **kwargs)[source]

Common daemonization option

daemon_setting(ctx: Context, opt: CeleryOption, value: Any) Any[source]

Try to fetch deamonization option from applications settings. Use the daemon command name as prefix (eg. worker -> worker_pidfile)

class celery.bin.base.ISO8601DateTime[source]

ISO 8601 Date Time argument.

convert(value, param, ctx)[source]

Convert the value to the correct type. This is not called if the value is None (the missing value).

This must accept string values from the command line, as well as values that are already the correct type. It may also convert other compatible types.

The param and ctx arguments may be None in certain situations, such as when converting prompt input.

If the value cannot be converted, call fail() with a descriptive message.

Parameters:
  • value – The value to convert.

  • param – The parameter that is using this type to convert its value. May be None.

  • ctx – The current context that arrived at this value. May be None.

name: str = 'iso-86091'

the descriptive name of this type

class celery.bin.base.ISO8601DateTimeOrFloat[source]

ISO 8601 Date Time or float argument.

convert(value, param, ctx)[source]

Convert the value to the correct type. This is not called if the value is None (the missing value).

This must accept string values from the command line, as well as values that are already the correct type. It may also convert other compatible types.

The param and ctx arguments may be None in certain situations, such as when converting prompt input.

If the value cannot be converted, call fail() with a descriptive message.

Parameters:
  • value – The value to convert.

  • param – The parameter that is using this type to convert its value. May be None.

  • ctx – The current context that arrived at this value. May be None.

name: str = 'iso-86091 or float'

the descriptive name of this type

class celery.bin.base.JsonArray[source]

JSON formatted array argument.

convert(value, param, ctx)[source]

Convert the value to the correct type. This is not called if the value is None (the missing value).

This must accept string values from the command line, as well as values that are already the correct type. It may also convert other compatible types.

The param and ctx arguments may be None in certain situations, such as when converting prompt input.

If the value cannot be converted, call fail() with a descriptive message.

Parameters:
  • value – The value to convert.

  • param – The parameter that is using this type to convert its value. May be None.

  • ctx – The current context that arrived at this value. May be None.

name: str = 'json array'

the descriptive name of this type

class celery.bin.base.JsonObject[source]

JSON formatted object argument.

convert(value, param, ctx)[source]

Convert the value to the correct type. This is not called if the value is None (the missing value).

This must accept string values from the command line, as well as values that are already the correct type. It may also convert other compatible types.

The param and ctx arguments may be None in certain situations, such as when converting prompt input.

If the value cannot be converted, call fail() with a descriptive message.

Parameters:
  • value – The value to convert.

  • param – The parameter that is using this type to convert its value. May be None.

  • ctx – The current context that arrived at this value. May be None.

name: str = 'json object'

the descriptive name of this type

class celery.bin.base.LogLevel[source]

Log level option.

convert(value, param, ctx)[source]

Convert the value to the correct type. This is not called if the value is None (the missing value).

This must accept string values from the command line, as well as values that are already the correct type. It may also convert other compatible types.

The param and ctx arguments may be None in certain situations, such as when converting prompt input.

If the value cannot be converted, call fail() with a descriptive message.

Parameters:
  • value – The value to convert.

  • param – The parameter that is using this type to convert its value. May be None.

  • ctx – The current context that arrived at this value. May be None.

celery.bin.base.handle_preload_options(f)[source]

Extract preload options and return a wrapped callable.