From 48d92fea672928b4571ddaab03667e74671391c0 Mon Sep 17 00:00:00 2001 From: jkrzy <j@jkrzy.com> Date: Fri, 18 Aug 2017 13:52:06 -0700 Subject: [PATCH] Fixed #28367 -- Doc'd how to override management commands. --- docs/howto/custom-management-commands.txt | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/docs/howto/custom-management-commands.txt b/docs/howto/custom-management-commands.txt index 453896b29a..77405a1622 100644 --- a/docs/howto/custom-management-commands.txt +++ b/docs/howto/custom-management-commands.txt @@ -181,6 +181,24 @@ Testing Information on how to test custom management commands can be found in the :ref:`testing docs <topics-testing-management-commands>`. +Overriding commands +=================== + +Django registers the built-in commands and then searches for commands in +:setting:`INSTALLED_APPS` in reverse. During the search, if a command name +duplicates an already registered command, the newly discovered command +overrides the first. + +In other words, to override a command, the new command must have the same name +and its app must be before the overridden command's app in +:setting:`INSTALLED_APPS`. + +Management commands from third-party apps that have been unintentionally +overridden can be made available under a new name by creating a new command in +one of your project's apps (ordered before the third-party app in +:setting:`INSTALLED_APPS`) which imports the ``Command`` of the overridden +command. + Command objects ===============