summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/howto/custom-management-commands.txt15
1 files changed, 15 insertions, 0 deletions
diff --git a/docs/howto/custom-management-commands.txt b/docs/howto/custom-management-commands.txt
index 4e55111b81..fb091d2866 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
-------