1. Georg Brandl
  2. sphinx-contrib
  3. Issues
Issue #52 new

Allow to ignore the output in doctest

Luca Cerone
created an issue

Hi everybody, I am relatively new to Sphinx, so I'd like to take the chance to thank all the developers and contributors for their work and effort.

I don't know how technically difficult this is, but I think it would be nice to have the option to test a command while completely ignoring the output.

While doctest has an ELLIPSIS directive for this, it allows to ignore portion of the output. Unfortunately ... denotes both line continuation and ellipsis, and prevents Sphinx to understand some text like:

.. doctest::

          >>> print "whatever you like" # doctest: +ELLIPSIS
          ...

I think it would be useful to test that a command is correctly executed regardless of its output (e.g. in the code I am documenting, one of the commands prints the name of some temporary files, and the output can be different when tested on different computers).

The only workaround I found is to add a SKIP directive, but I think some way to ignore al the output in a doctest might be useful.

Comments (0)

  1. Log in to comment