Skip to content

Commit

Permalink
Fixed #5677 -- update modpython stdout documentation. Thanks to Manfr…
Browse files Browse the repository at this point in the history
…ed Wassmann for the report, nickefford for the initial patch and Graham Dumpleton for the expert advice.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@14059 bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information
DrMeers committed Oct 9, 2010
1 parent b7a73cf commit c93f5e5
Showing 1 changed file with 18 additions and 6 deletions.
24 changes: 18 additions & 6 deletions docs/howto/deployment/modpython.txt
Original file line number Diff line number Diff line change
Expand Up @@ -158,6 +158,8 @@ the full URL.
When deploying Django sites on mod_python, you'll need to restart Apache each
time you make changes to your Python code.

.. _mod_python documentation: http://modpython.org/live/current/doc-html/directives.html

Multiple Django installations on the same Apache
================================================

Expand Down Expand Up @@ -211,15 +213,25 @@ everything for each request. But don't do that on a production server, or we'll
revoke your Django privileges.

If you're the type of programmer who debugs using scattered ``print``
statements, note that ``print`` statements have no effect in mod_python; they
don't appear in the Apache log, as one might expect. If you have the need to
print debugging information in a mod_python setup, either do this::
statements, note that output to ``stdout`` will not appear in the Apache
log and can even `cause response errors`_.

assert False, the_value_i_want_to_see
.. _cause response errors: http://blog.dscpl.com.au/2009/04/wsgi-and-printing-to-standard-output.html

Or add the debugging information to the template of your page.
If you have the need to print debugging information in a mod_python setup, you
have a few options. You can print to ``stderr`` explicitly, like so::

print >> sys.stderr, 'debug text'
sys.stderr.flush()

(note that ``stderr`` is buffered, so calling ``flush`` is necessary if you wish
debugging information to be displayed promptly.)

A more compact approach is to use an assertion::

.. _mod_python documentation: http://modpython.org/live/current/doc-html/directives.html
assert False, 'debug text'

Another alternative is to add debugging information to the template of your page.

Serving media files
===================
Expand Down

0 comments on commit c93f5e5

Please sign in to comment.