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

celery.utils.text

Text formatting utilities.

celery.utils.text.abbr(S: str, max: int, ellipsis: str | bool = '...') → str

Abbreviate word.

celery.utils.text.abbrtask(S: str, max: int) → str

Abbreviate task name.

celery.utils.text.dedent(s: str, sep: str = '\n') → str

Remove indentation.

celery.utils.text.dedent_initial(s: str, n: int = 4) → str

Remove indentation from first line of text.

celery.utils.text.ensure_newlines(s: str, n: int = 2) → str

Ensure text s ends in separator sep’.

celery.utils.text.ensure_sep(sep: str, s: str, n: int = 2) → str

Ensure text s ends in separator sep’.

celery.utils.text.fill_paragraphs(s: str, width: int, sep: str = '\n') → str

Fill paragraphs with newlines (or custom separator).

celery.utils.text.indent(t: str, indent: int = 0, sep: str = '\n') → str

Indent text.

celery.utils.text.join(l: list[str], sep: str = '\n') → str

Concatenate list of strings.

celery.utils.text.pluralize(n: float, text: str, suffix: str = 's') → str

Pluralize term when n is greater than one.

celery.utils.text.pretty(value: str, width: int = 80, nl_width: int = 80, sep: str = '\n', **kw: Any) → str

Format value for printing to console.

celery.utils.text.simple_format(s: str, keys: dict[str, str | Callable], pattern: Pattern[str] = re.compile('%(\\w)'), expand: str = '\\1') → str

Format string, expanding abbreviations in keys’.

celery.utils.text.str_to_list(s: str) → list[str]

Convert string to list.

celery.utils.text.truncate(s: str, maxlen: int = 128, suffix: str = '...') → str

Truncate text to a maximum number of characters.