From a9f1ea32750be33385d7ba014f9ed63d6ee695d6 Mon Sep 17 00:00:00 2001 From: Elena Oat Date: Sun, 8 Nov 2015 10:47:21 +0100 Subject: [PATCH] [1.8.x] Fixed #25526 -- Documented how to output colored text in custom management commands. Backport of d26207d56cab21e3767121d53ebaddbbfc78a4ce from master --- docs/howto/custom-management-commands.txt | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/docs/howto/custom-management-commands.txt b/docs/howto/custom-management-commands.txt index 4e55111b81e..fb091d28666 100644 --- a/docs/howto/custom-management-commands.txt +++ b/docs/howto/custom-management-commands.txt @@ -320,6 +320,21 @@ All attributes can be set in your derived class and can be used in because attempting to set the locale needs access to settings. This condition will generate a :class:`CommandError`. +.. attribute:: BaseCommand.style + + An instance attribute that helps create colored output when writing to + ``stdout`` or ``stderr``. For example:: + + self.stdout.write(self.style.NOTICE('...')) + + See :ref:`syntax-coloring` to learn how to modify the color palette and to + see the available styles (use uppercased versions of the "roles" described + in that section). + + If you pass the :djadminopt:`--no-color` option when running your + command, all ``self.style()`` calls will return the original string + uncolored. + Methods -------