sphinx.ext.doctest should ensure that output is patched before importing the target

[Julian]

Problem

• sphinx.ext.doctest will import the target before making sure that docutils has patched sys.stdout and sys.stderr with _SpoofOut objects. If the target module has already gotten a reference to stdout and stderr and writes to them doctests will fail.

Procedure to reproduce the problem

doctest a function like:

def f(stdout=sys.stdout):
    """
    .. testcode::
        f()
    .. testoutput::
        hello
    """
    stdout.write("hello")

Expected results

a successful doctest, where sys.stdout should be patched before the module under test is imported

Actual results

The output goes to the real sys.stdout, and the doctest fails claiming no output was produced

[tk0miya]

The doctest extension uses docstring as a testcase.
But the default argument parameter is recognized before the docstring appeared.
So I think this is very difficult to resolve your problem...