Now it is implemented :-). To use, either run py.test –doctest-modules command, or set your configuration with pytest.ini: $ cat pytest.ini # content of pytest.ini [pytest] addopts = –doctest-modules Man page: PyTest: doctest integration for modules and test files.
Running a module (or the tests in it) in PyCharm is done via a Run Configuration. When you right click a module, PyCharm searches for an existing Run Configuration for that module. If a configuration is found (this can be due to a previous run, or a manual creation of a Configuration), PyCharm will only … Read more
The docstring docs actually allude to the problem, but not entirely clearly. A couple of other stackoverflow threads here and here were helpful, but not easy to find given my own search criteria. Here is my actual solution: def remove_CRs(text): r””” >>> output = remove_CRs(“line1 \r” … “still line1\n” … “now line2 \r” … “more … Read more
The Python interpreter ignores None return values, so doctests do the same. Test for is None instead: >>> six_or_none(4) is None True
With doctest.ELLIPSIS, you can use … to mean “match any string here”. You can set doctest options with a doctest directive, to make it active for just one test case: one example in the online docs is: >>> print range(20) # doctest:+ELLIPSIS [0, 1, …, 18, 19] If you want a doctest option to be … Read more
Another good way is to use pprint (in the standard library). >>> import pprint >>> pprint.pprint({“second”: 1, “first”: 0}) {‘first’: 0, ‘second’: 1} According to its source code, it’s sorting dicts for you: http://hg.python.org/cpython/file/2.7/Lib/pprint.py#l158 items = _sorted(object.items())
Just figured out: def long_string(): “”” Returns a string which is wider than the recommended PEP8 linewidth >>> print long_string() 01234567890123456789012345678901234567890123456789012345678901234567890\ 12345678901234567890123456789 “”” return ‘0123456789’ * 10 Hope that helps somebody else out.
Instead of instantiating the object in every method, you can use the extraglobs argument: class Test: def multiply_by_2(self): “”” >>> t.multiply_by_2() 10 “”” return self._number*2 if __name__ == ‘__main__’: import doctest doctest.testmod(extraglobs={‘t’: Test()})
Yes. You can do it. The doctest module documentation and Wikipedia has an example of it. >>> x Traceback (most recent call last): … NameError: name ‘x’ is not defined
Both are valuable. I use both doctest and nose taking the place of unittest. I use doctest for cases where the test is giving an example of usage that is actually useful as documentation. Generally I don’t make these tests comprehensive, aiming solely for informative. I’m effectively using doctest in reverse: not to test my … Read more