From Wikipedia, the free encyclopedia

--Ctheune 13:38, 2 November 2006 (UTC)

• I'd like to add a section with good usage examples and bad usage examples (in addition to the pros and cons)

• Maybe also put the pros/cons into a section called 'criticism'

Although I like the idea of a criticism section, I think that one has to be wary of criticising it for not being a Unit test like jUnit.
Doctest I think should be judged on how well it allows interactive shell sessions to be turned into tests embedded in docstrings, and how such embedded tests work both as tests, and as documentation.

Anything that makes writing good tests easier is likely to improve programmers productivity so I 'cut <doctest> a lot of slack'. --Paddy 07:39, 4 November 2006 (UTC)

I re-inserted the example unique_words.py so I could refer to how it runs the doctests if executed but not if imported.. --Paddy 07:39, 4 November 2006 (UTC)

[edit] Not a tutorial

I don't think there are any doctest equivalents outside of Python in regular use, so Non Python programmers may not have come across the idea. The article tries to explain its use through example but is not a tutorial. Please explain in much more detail what is wrong with the article before slapping the 'big i' on it --Paddy 03:29, 4 August 2007 (UTC)

[edit] Doctest in other languages

I have noticed that there are now doctest-like utilities for Javascript and Ruby. I would ask you not to add them to the main article before they are established within their languages community by, for example, being added to the languages standard library, or being documented, (not necessarily wiki'd), on the languages home site.

From experience on other articles, it keeps the page focused. --Paddy 05:12, 24 August 2007 (UTC)