This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author ezio.melotti
Recipients chris.jerdonek, docs@python, ezio.melotti, sbt
Date 2012-08-12.14:35:33
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1344782134.47.0.273788617967.issue15629@psf.upfronthosting.co.za>
In-reply-to
Content
> If I understand correctly, do you mean for example that 
> Lib/test/test_textwrap.py could be responsible for loading
> the doctests in Doc/library/textwrap.rst?

One advantage of this is that I could explicitly add a test in test_textwrap.py that loads the doctests in textwrap.rst and runs them.
This would allow me to decide if those tests should be run or not, and which ones are runnable.  If I know that textwrap.rst has no runnable tests I won't add the test, so by simply running test_textwrap I would be running all the tests I want/need to run.

OTOH this has disadvantages too.  If the tests are loaded explicitly it means that every test file that wants to load the doctests should be modified.  Even if foo.rst has no runnable doctests and no test to load them is added to test_foo.py, a `make doctest` might still include the file unless we mark it in some way (either by a module-wide directive, or by marking all the individual snippets of code).
History
Date User Action Args
2012-08-12 14:35:34ezio.melottisetrecipients: + ezio.melotti, chris.jerdonek, docs@python, sbt
2012-08-12 14:35:34ezio.melottisetmessageid: <1344782134.47.0.273788617967.issue15629@psf.upfronthosting.co.za>
2012-08-12 14:35:33ezio.melottilinkissue15629 messages
2012-08-12 14:35:33ezio.melotticreate