You are viewing a plain text version of this content. The canonical link for it is here.
Posted to mod_python-dev@quetz.apache.org by "Nicolas Lehuen (JIRA)" <ji...@apache.org> on 2005/03/07 08:09:54 UTC

[jira] Created: (MODPYTHON-28) Add a standard test handler in the distribution

Add a standard test handler in the distribution
-----------------------------------------------

         Key: MODPYTHON-28
         URL: http://issues.apache.org/jira/browse/MODPYTHON-28
     Project: mod_python
        Type: Bug
    Versions: 2.7.10, 3.1.4    
    Reporter: Nicolas Lehuen
     Fix For: 3.2.0


Improving the testing phase of the installation is crucial as we get a steady stream of question from new users who can't run the mptest or are confused about its meaning (for example, the fact that any URL ending with .py runs the mptest handler is misleading at first).

We should include a standard mptest handler in the distribution so that we can better help beginners, without making them struggle with a new file PYTHONPATH, syntax errors in the handler, etc. Ideally, the mptest handler should display useful informations both in the Apache log and in the result page ; this would help us check their environment and provide better help.

The information displayed could be (both in the log and the result page) :

- Apache version (+MPM type if this information can be queried at runtime)
- Python version
- mod_python version
- sys.path
- mod_python.publisher available yes/no
- mod_python.psp available yes/no

Of course, if anything goes wrong, it should be clearly stated in the Apache log (no misleading 404 errors, please !).

The testing phase of the installation would then be : 1) set "SetHandler mod_python.mptest" directive and 2) watch the results. This would be far less messy as it is currently.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/jira/secure/Administrators.jspa
-
If you want more information on JIRA, or have a bug to report see:
   http://www.atlassian.com/software/jira


[jira] Work started: (MODPYTHON-28) Add a standard test handler in the distribution

Posted by "Nicolas Lehuen (JIRA)" <ji...@apache.org>.
     [ http://issues.apache.org/jira/browse/MODPYTHON-28?page=all ]
     
Work on MODPYTHON-28 started by Nicolas Lehuen

> Add a standard test handler in the distribution
> -----------------------------------------------
>
>          Key: MODPYTHON-28
>          URL: http://issues.apache.org/jira/browse/MODPYTHON-28
>      Project: mod_python
>         Type: Improvement
>     Versions: 2.7.10, 3.1.4
>     Reporter: Nicolas Lehuen
>     Assignee: Nicolas Lehuen
>      Fix For: 3.2.0

>
> Improving the testing phase of the installation is crucial as we get a steady stream of question from new users who can't run the mptest or are confused about its meaning (for example, the fact that any URL ending with .py runs the mptest handler is misleading at first).
> We should include a standard mptest handler in the distribution so that we can better help beginners, without making them struggle with a new file PYTHONPATH, syntax errors in the handler, etc. Ideally, the mptest handler should display useful informations both in the Apache log and in the result page ; this would help us check their environment and provide better help.
> The information displayed could be (both in the log and the result page) :
> - Apache version (+MPM type if this information can be queried at runtime)
> - Python version
> - mod_python version
> - sys.path
> - mod_python.publisher available yes/no
> - mod_python.psp available yes/no
> Of course, if anything goes wrong, it should be clearly stated in the Apache log (no misleading 404 errors, please !).
> The testing phase of the installation would then be : 1) set "SetHandler mod_python.mptest" directive and 2) watch the results. This would be far less messy as it is currently.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira


[jira] Updated: (MODPYTHON-28) Add a standard test handler in the distribution

Posted by "Nicolas Lehuen (JIRA)" <ji...@apache.org>.
     [ http://issues.apache.org/jira/browse/MODPYTHON-28?page=history ]

Nicolas Lehuen updated MODPYTHON-28:
------------------------------------

    type: Improvement  (was: Bug)

> Add a standard test handler in the distribution
> -----------------------------------------------
>
>          Key: MODPYTHON-28
>          URL: http://issues.apache.org/jira/browse/MODPYTHON-28
>      Project: mod_python
>         Type: Improvement
>     Versions: 2.7.10, 3.1.4
>     Reporter: Nicolas Lehuen
>      Fix For: 3.2.0

>
> Improving the testing phase of the installation is crucial as we get a steady stream of question from new users who can't run the mptest or are confused about its meaning (for example, the fact that any URL ending with .py runs the mptest handler is misleading at first).
> We should include a standard mptest handler in the distribution so that we can better help beginners, without making them struggle with a new file PYTHONPATH, syntax errors in the handler, etc. Ideally, the mptest handler should display useful informations both in the Apache log and in the result page ; this would help us check their environment and provide better help.
> The information displayed could be (both in the log and the result page) :
> - Apache version (+MPM type if this information can be queried at runtime)
> - Python version
> - mod_python version
> - sys.path
> - mod_python.publisher available yes/no
> - mod_python.psp available yes/no
> Of course, if anything goes wrong, it should be clearly stated in the Apache log (no misleading 404 errors, please !).
> The testing phase of the installation would then be : 1) set "SetHandler mod_python.mptest" directive and 2) watch the results. This would be far less messy as it is currently.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/jira/secure/Administrators.jspa
-
If you want more information on JIRA, or have a bug to report see:
   http://www.atlassian.com/software/jira


[jira] Resolved: (MODPYTHON-28) Add a standard test handler in the distribution

Posted by "Nicolas Lehuen (JIRA)" <ji...@apache.org>.
     [ http://issues.apache.org/jira/browse/MODPYTHON-28?page=all ]
     
Nicolas Lehuen resolved MODPYTHON-28:
-------------------------------------

    Resolution: Fixed

I've added a bit of documentation about testing and using the testhandler. Despite my efforts, I did not manage to install a proper LaTeX environnement to check my modifications, so I hope everything is OK.

> Add a standard test handler in the distribution
> -----------------------------------------------
>
>          Key: MODPYTHON-28
>          URL: http://issues.apache.org/jira/browse/MODPYTHON-28
>      Project: mod_python
>         Type: Improvement
>     Versions: 3.1.4, 2.7.10
>     Reporter: Nicolas Lehuen
>     Assignee: Nicolas Lehuen
>      Fix For: 3.2.0

>
> Improving the testing phase of the installation is crucial as we get a steady stream of question from new users who can't run the mptest or are confused about its meaning (for example, the fact that any URL ending with .py runs the mptest handler is misleading at first).
> We should include a standard mptest handler in the distribution so that we can better help beginners, without making them struggle with a new file PYTHONPATH, syntax errors in the handler, etc. Ideally, the mptest handler should display useful informations both in the Apache log and in the result page ; this would help us check their environment and provide better help.
> The information displayed could be (both in the log and the result page) :
> - Apache version (+MPM type if this information can be queried at runtime)
> - Python version
> - mod_python version
> - sys.path
> - mod_python.publisher available yes/no
> - mod_python.psp available yes/no
> Of course, if anything goes wrong, it should be clearly stated in the Apache log (no misleading 404 errors, please !).
> The testing phase of the installation would then be : 1) set "SetHandler mod_python.mptest" directive and 2) watch the results. This would be far less messy as it is currently.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira


[jira] Commented: (MODPYTHON-28) Add a standard test handler in the distribution

Posted by "Nicolas Lehuen (JIRA)" <ji...@apache.org>.
     [ http://issues.apache.org/jira/browse/MODPYTHON-28?page=comments#action_66620 ]
     
Nicolas Lehuen commented on MODPYTHON-28:
-----------------------------------------

OK, I have integrated your fixes.

> Add a standard test handler in the distribution
> -----------------------------------------------
>
>          Key: MODPYTHON-28
>          URL: http://issues.apache.org/jira/browse/MODPYTHON-28
>      Project: mod_python
>         Type: Improvement
>     Versions: 3.1.4, 2.7.10
>     Reporter: Nicolas Lehuen
>     Assignee: Nicolas Lehuen
>      Fix For: 3.2.0
>  Attachments: modpython2.tex-jg20050528-1.diff
>
> Improving the testing phase of the installation is crucial as we get a steady stream of question from new users who can't run the mptest or are confused about its meaning (for example, the fact that any URL ending with .py runs the mptest handler is misleading at first).
> We should include a standard mptest handler in the distribution so that we can better help beginners, without making them struggle with a new file PYTHONPATH, syntax errors in the handler, etc. Ideally, the mptest handler should display useful informations both in the Apache log and in the result page ; this would help us check their environment and provide better help.
> The information displayed could be (both in the log and the result page) :
> - Apache version (+MPM type if this information can be queried at runtime)
> - Python version
> - mod_python version
> - sys.path
> - mod_python.publisher available yes/no
> - mod_python.psp available yes/no
> Of course, if anything goes wrong, it should be clearly stated in the Apache log (no misleading 404 errors, please !).
> The testing phase of the installation would then be : 1) set "SetHandler mod_python.mptest" directive and 2) watch the results. This would be far less messy as it is currently.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira


[jira] Closed: (MODPYTHON-28) Add a standard test handler in the distribution

Posted by "Graham Dumpleton (JIRA)" <ji...@apache.org>.
     [ http://issues.apache.org/jira/browse/MODPYTHON-28?page=all ]
     
Graham Dumpleton closed MODPYTHON-28:
-------------------------------------


> Add a standard test handler in the distribution
> -----------------------------------------------
>
>          Key: MODPYTHON-28
>          URL: http://issues.apache.org/jira/browse/MODPYTHON-28
>      Project: mod_python
>         Type: Improvement
>     Versions: 3.1.4, 2.7.10
>     Reporter: Nicolas Lehuen
>     Assignee: Nicolas Lehuen
>      Fix For: 3.2.7
>  Attachments: modpython2.tex-jg20050528-1.diff
>
> Improving the testing phase of the installation is crucial as we get a steady stream of question from new users who can't run the mptest or are confused about its meaning (for example, the fact that any URL ending with .py runs the mptest handler is misleading at first).
> We should include a standard mptest handler in the distribution so that we can better help beginners, without making them struggle with a new file PYTHONPATH, syntax errors in the handler, etc. Ideally, the mptest handler should display useful informations both in the Apache log and in the result page ; this would help us check their environment and provide better help.
> The information displayed could be (both in the log and the result page) :
> - Apache version (+MPM type if this information can be queried at runtime)
> - Python version
> - mod_python version
> - sys.path
> - mod_python.publisher available yes/no
> - mod_python.psp available yes/no
> Of course, if anything goes wrong, it should be clearly stated in the Apache log (no misleading 404 errors, please !).
> The testing phase of the installation would then be : 1) set "SetHandler mod_python.mptest" directive and 2) watch the results. This would be far less messy as it is currently.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira


[jira] Assigned: (MODPYTHON-28) Add a standard test handler in the distribution

Posted by "Nicolas Lehuen (JIRA)" <ji...@apache.org>.
     [ http://issues.apache.org/jira/browse/MODPYTHON-28?page=all ]

Nicolas Lehuen reassigned MODPYTHON-28:
---------------------------------------

    Assign To: Nicolas Lehuen

> Add a standard test handler in the distribution
> -----------------------------------------------
>
>          Key: MODPYTHON-28
>          URL: http://issues.apache.org/jira/browse/MODPYTHON-28
>      Project: mod_python
>         Type: Improvement
>     Versions: 2.7.10, 3.1.4
>     Reporter: Nicolas Lehuen
>     Assignee: Nicolas Lehuen
>      Fix For: 3.2.0

>
> Improving the testing phase of the installation is crucial as we get a steady stream of question from new users who can't run the mptest or are confused about its meaning (for example, the fact that any URL ending with .py runs the mptest handler is misleading at first).
> We should include a standard mptest handler in the distribution so that we can better help beginners, without making them struggle with a new file PYTHONPATH, syntax errors in the handler, etc. Ideally, the mptest handler should display useful informations both in the Apache log and in the result page ; this would help us check their environment and provide better help.
> The information displayed could be (both in the log and the result page) :
> - Apache version (+MPM type if this information can be queried at runtime)
> - Python version
> - mod_python version
> - sys.path
> - mod_python.publisher available yes/no
> - mod_python.psp available yes/no
> Of course, if anything goes wrong, it should be clearly stated in the Apache log (no misleading 404 errors, please !).
> The testing phase of the installation would then be : 1) set "SetHandler mod_python.mptest" directive and 2) watch the results. This would be far less messy as it is currently.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira


[jira] Commented: (MODPYTHON-28) Add a standard test handler in the distribution

Posted by "Nicolas Lehuen (JIRA)" <ji...@apache.org>.
     [ http://issues.apache.org/jira/browse/MODPYTHON-28?page=comments#action_64201 ]
     
Nicolas Lehuen commented on MODPYTHON-28:
-----------------------------------------

OK, the handler is named mod_python.testhandler and display a whole range of information about the configuration. Now we need a little bit of documentation on how to use it.

> Add a standard test handler in the distribution
> -----------------------------------------------
>
>          Key: MODPYTHON-28
>          URL: http://issues.apache.org/jira/browse/MODPYTHON-28
>      Project: mod_python
>         Type: Improvement
>     Versions: 2.7.10, 3.1.4
>     Reporter: Nicolas Lehuen
>     Assignee: Nicolas Lehuen
>      Fix For: 3.2.0

>
> Improving the testing phase of the installation is crucial as we get a steady stream of question from new users who can't run the mptest or are confused about its meaning (for example, the fact that any URL ending with .py runs the mptest handler is misleading at first).
> We should include a standard mptest handler in the distribution so that we can better help beginners, without making them struggle with a new file PYTHONPATH, syntax errors in the handler, etc. Ideally, the mptest handler should display useful informations both in the Apache log and in the result page ; this would help us check their environment and provide better help.
> The information displayed could be (both in the log and the result page) :
> - Apache version (+MPM type if this information can be queried at runtime)
> - Python version
> - mod_python version
> - sys.path
> - mod_python.publisher available yes/no
> - mod_python.psp available yes/no
> Of course, if anything goes wrong, it should be clearly stated in the Apache log (no misleading 404 errors, please !).
> The testing phase of the installation would then be : 1) set "SetHandler mod_python.mptest" directive and 2) watch the results. This would be far less messy as it is currently.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira


[jira] Updated: (MODPYTHON-28) Add a standard test handler in the distribution

Posted by "Jim Gallacher (JIRA)" <ji...@apache.org>.
     [ http://issues.apache.org/jira/browse/MODPYTHON-28?page=all ]

Jim Gallacher updated MODPYTHON-28:
-----------------------------------

    Attachment: modpython2.tex-jg20050528-1.diff

A few small documentation fixes.

> Add a standard test handler in the distribution
> -----------------------------------------------
>
>          Key: MODPYTHON-28
>          URL: http://issues.apache.org/jira/browse/MODPYTHON-28
>      Project: mod_python
>         Type: Improvement
>     Versions: 3.1.4, 2.7.10
>     Reporter: Nicolas Lehuen
>     Assignee: Nicolas Lehuen
>      Fix For: 3.2.0
>  Attachments: modpython2.tex-jg20050528-1.diff
>
> Improving the testing phase of the installation is crucial as we get a steady stream of question from new users who can't run the mptest or are confused about its meaning (for example, the fact that any URL ending with .py runs the mptest handler is misleading at first).
> We should include a standard mptest handler in the distribution so that we can better help beginners, without making them struggle with a new file PYTHONPATH, syntax errors in the handler, etc. Ideally, the mptest handler should display useful informations both in the Apache log and in the result page ; this would help us check their environment and provide better help.
> The information displayed could be (both in the log and the result page) :
> - Apache version (+MPM type if this information can be queried at runtime)
> - Python version
> - mod_python version
> - sys.path
> - mod_python.publisher available yes/no
> - mod_python.psp available yes/no
> Of course, if anything goes wrong, it should be clearly stated in the Apache log (no misleading 404 errors, please !).
> The testing phase of the installation would then be : 1) set "SetHandler mod_python.mptest" directive and 2) watch the results. This would be far less messy as it is currently.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira


[jira] Commented: (MODPYTHON-28) Add a standard test handler in the distribution

Posted by "Graham Dumpleton (JIRA)" <ji...@apache.org>.
     [ http://issues.apache.org/jira/browse/MODPYTHON-28?page=comments#action_60425 ]
     
Graham Dumpleton commented on MODPYTHON-28:
-------------------------------------------

Most of the time the problem is that people using 2.7.X follow the instructions
for 3.1.X. Adding a test module in a future version will not change that. One
may be better off adding notes within the documentation of the latest version
on the web site where the mptest example is given, highlighting that it is only
valid for 3.1 and later and that people should check which version they are
using and refer to older documentation if they are using an older version. That
would stop a reasonable number of the questions.

> Add a standard test handler in the distribution
> -----------------------------------------------
>
>          Key: MODPYTHON-28
>          URL: http://issues.apache.org/jira/browse/MODPYTHON-28
>      Project: mod_python
>         Type: Improvement
>     Versions: 2.7.10, 3.1.4
>     Reporter: Nicolas Lehuen
>      Fix For: 3.2.0

>
> Improving the testing phase of the installation is crucial as we get a steady stream of question from new users who can't run the mptest or are confused about its meaning (for example, the fact that any URL ending with .py runs the mptest handler is misleading at first).
> We should include a standard mptest handler in the distribution so that we can better help beginners, without making them struggle with a new file PYTHONPATH, syntax errors in the handler, etc. Ideally, the mptest handler should display useful informations both in the Apache log and in the result page ; this would help us check their environment and provide better help.
> The information displayed could be (both in the log and the result page) :
> - Apache version (+MPM type if this information can be queried at runtime)
> - Python version
> - mod_python version
> - sys.path
> - mod_python.publisher available yes/no
> - mod_python.psp available yes/no
> Of course, if anything goes wrong, it should be clearly stated in the Apache log (no misleading 404 errors, please !).
> The testing phase of the installation would then be : 1) set "SetHandler mod_python.mptest" directive and 2) watch the results. This would be far less messy as it is currently.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/jira/secure/Administrators.jspa
-
If you want more information on JIRA, or have a bug to report see:
   http://www.atlassian.com/software/jira


[jira] Commented: (MODPYTHON-28) Add a standard test handler in the distribution

Posted by "Jim Gallacher (JIRA)" <ji...@apache.org>.
     [ http://issues.apache.org/jira/browse/MODPYTHON-28?page=comments#action_66505 ]
     
Jim Gallacher commented on MODPYTHON-28:
----------------------------------------

You got the LaTex mostly right. There is one error (a stray backslash) which I've corrected in the attached patch.

As for the testing documentation itself, in section 2.4 item 7 you mention the need to "use a higher level handler such as mod_python publisher (see 3.1), mpservlets or Vampire". It may not be obvious to the reader that mpservlets and Vampire are not included with mod_python.

Maybe add somthing at the end of section 2.4 such:

\begin{seealso}
  \seeurl{http://home.comcast.net/~d.popowich/mpservlets}{mpservlets}
  \seeurl{http://www.dscpl.com.au/projects/vampire}{Vampire}
\end{seealso}

> Add a standard test handler in the distribution
> -----------------------------------------------
>
>          Key: MODPYTHON-28
>          URL: http://issues.apache.org/jira/browse/MODPYTHON-28
>      Project: mod_python
>         Type: Improvement
>     Versions: 3.1.4, 2.7.10
>     Reporter: Nicolas Lehuen
>     Assignee: Nicolas Lehuen
>      Fix For: 3.2.0
>  Attachments: modpython2.tex-jg20050528-1.diff
>
> Improving the testing phase of the installation is crucial as we get a steady stream of question from new users who can't run the mptest or are confused about its meaning (for example, the fact that any URL ending with .py runs the mptest handler is misleading at first).
> We should include a standard mptest handler in the distribution so that we can better help beginners, without making them struggle with a new file PYTHONPATH, syntax errors in the handler, etc. Ideally, the mptest handler should display useful informations both in the Apache log and in the result page ; this would help us check their environment and provide better help.
> The information displayed could be (both in the log and the result page) :
> - Apache version (+MPM type if this information can be queried at runtime)
> - Python version
> - mod_python version
> - sys.path
> - mod_python.publisher available yes/no
> - mod_python.psp available yes/no
> Of course, if anything goes wrong, it should be clearly stated in the Apache log (no misleading 404 errors, please !).
> The testing phase of the installation would then be : 1) set "SetHandler mod_python.mptest" directive and 2) watch the results. This would be far less messy as it is currently.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira


[jira] Commented: (MODPYTHON-28) Add a standard test handler in the distribution

Posted by "Nicolas Lehuen (JIRA)" <ji...@apache.org>.
     [ http://issues.apache.org/jira/browse/MODPYTHON-28?page=comments#action_64202 ]
     
Nicolas Lehuen commented on MODPYTHON-28:
-----------------------------------------

I've also added a warning in the documentation, so that people using mod_python 2.7.x do not follow the 3.x testing instructions.

> Add a standard test handler in the distribution
> -----------------------------------------------
>
>          Key: MODPYTHON-28
>          URL: http://issues.apache.org/jira/browse/MODPYTHON-28
>      Project: mod_python
>         Type: Improvement
>     Versions: 2.7.10, 3.1.4
>     Reporter: Nicolas Lehuen
>     Assignee: Nicolas Lehuen
>      Fix For: 3.2.0

>
> Improving the testing phase of the installation is crucial as we get a steady stream of question from new users who can't run the mptest or are confused about its meaning (for example, the fact that any URL ending with .py runs the mptest handler is misleading at first).
> We should include a standard mptest handler in the distribution so that we can better help beginners, without making them struggle with a new file PYTHONPATH, syntax errors in the handler, etc. Ideally, the mptest handler should display useful informations both in the Apache log and in the result page ; this would help us check their environment and provide better help.
> The information displayed could be (both in the log and the result page) :
> - Apache version (+MPM type if this information can be queried at runtime)
> - Python version
> - mod_python version
> - sys.path
> - mod_python.publisher available yes/no
> - mod_python.psp available yes/no
> Of course, if anything goes wrong, it should be clearly stated in the Apache log (no misleading 404 errors, please !).
> The testing phase of the installation would then be : 1) set "SetHandler mod_python.mptest" directive and 2) watch the results. This would be far less messy as it is currently.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira