[issue15521] Dev Guide should say how to run tests in 2.7

New submission from Chris Jerdonek:
The Dev Guide should say the preferred way (or even a way) to run tests using the Python 2.7 build:
http://docs.python.org/devguide/runtests.html
This will help submitters who want to check that their patch works with 2.7.
In Python 2.7, this did not work (for obvious reasons):
$ ./python.exe -m test .../python.exe: No module named test.__main__; 'test' is a package and cannot be directly executed
But this did:
$ ./python.exe -m test.regrtest
Is the latter the preferred way?
---------- assignee: docs@python components: Devguide, Documentation keywords: easy messages: 167099 nosy: cjerdonek, docs@python, ezio.melotti priority: normal severity: normal stage: needs patch status: open title: Dev Guide should say how to run tests in 2.7
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue15521 _______________________________________

Ezio Melotti added the comment:
FWIW this is already mentioned in the quick start [0]. Do you want to propose a patch for runtest.rst?
[0]: http://docs.python.org/devguide/#quick-start
---------- type: -> enhancement
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue15521 _______________________________________

Chris Jerdonek added the comment:
FWIW this is already mentioned in the quick start [0].
I didn't catch that, thanks.
Do you want to propose a patch for runtest.rst?
Sure.
----------
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue15521 _______________________________________

Chris Jerdonek added the comment:
Attaching a patch for review.
---------- keywords: +patch stage: needs patch -> patch review Added file: http://bugs.python.org/file26645/issue-15521-1.patch
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue15521 _______________________________________

Ezio Melotti added the comment:
Thanks for the patch. I'm not sure it's necessary to add a new section though, unless you are planning to add more differences there.
+base command instead of the one described above: ::
You can just use "... above::" here.
----------
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue15521 _______________________________________

Chris Jerdonek added the comment:
It is a relatively large section (nine paragraphs + six code snippets) and is primarily about the in-development branch, so I did not want to interrupt the flow with a remark specific to 2.7. I also liked that the instructions in a subsection could be linked to.
But here is a new patch.
---------- Added file: http://bugs.python.org/file26652/issue-15521-2.patch
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue15521 _______________________________________

Roundup Robot added the comment:
New changeset 851adff2d434 by Ezio Melotti in branch 'default': #15521: mention that test.regrtest is necessary to run tests on 2.7. Patch by Chris Jerdonek. http://hg.python.org/devguide/rev/851adff2d434
---------- nosy: +python-dev
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue15521 _______________________________________

Ezio Melotti added the comment:
Fixed, thanks for the patch!
---------- assignee: docs@python -> ezio.melotti resolution: -> fixed stage: patch review -> committed/rejected status: open -> closed
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue15521 _______________________________________
participants (3)
-
Chris Jerdonek
-
Ezio Melotti
-
Roundup Robot