From d26207d56cab21e3767121d53ebaddbbfc78a4ce Mon Sep 17 00:00:00 2001 From: Elena Oat Date: Sun, 8 Nov 2015 10:47:21 +0100 Subject: [PATCH] Fixed #25526 -- Documented how to output colored text in custom management commands. --- docs/howto/custom-management-commands.txt | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) diff --git a/docs/howto/custom-management-commands.txt b/docs/howto/custom-management-commands.txt index 8986075c43..9956891fa6 100644 --- a/docs/howto/custom-management-commands.txt +++ b/docs/howto/custom-management-commands.txt @@ -67,7 +67,7 @@ look like this:: poll.opened = False poll.save() - self.stdout.write('Successfully closed poll "%s"' % poll_id) + self.stdout.write(self.style.SUCCESS('Successfully closed poll "%s"' % poll_id)) .. _management-commands-output: @@ -256,6 +256,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.SUCCESS('...')) + + 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 -------