Commit 8f5236fa authored by Russell Keith-Magee's avatar Russell Keith-Magee
Browse files

[1.2.X] Fixed #13747 -- Reverted documentation suggesting the use of... 

[1.2.X] Fixed #13747 -- Reverted documentation suggesting the use of self.stdout/err in management commands in 1.2. Thanks to metamemetics for the report.

Strictly, self.stdout/err is a feature addition; however, it's a
feature that is required in order to achieve a massive speedup in the
tests and to maintain parity between 1.2.X and trunk tests. However,
the feature is completely transparent -- the old technique will work
fine, it just isn't as testable. Therefore, we'll treat this as an
undocumented feature in the 1.2 branch.

git-svn-id: http://code.djangoproject.com/svn/django/branches/releases/1.2.X@13364 bcc190cf-cafb-0310-a4f2-bffc1f526a37
parent b1b17211

docs/howto/custom-management-commands.txt

+1 −8
Original line number Diff line number Diff line
@@ -62,14 +62,7 @@ look like this: 
                poll.opened = False

                poll.save()



                self.stdout.write('Successfully closed poll "%s"\n' % poll_id)



.. note::

    When you are using management commands and wish to provide console

    output, you should write to ``self.stdout`` and ``self.stderr``,

    instead of printing to ``stdout`` and ``stderr`` directly. By

    using these proxies, it becomes much easier to test your custom

    command.

                print 'Successfully closed poll "%s"' % poll_id



The new custom command can be called using ``python manage.py closepoll

<poll_id>``.