sphinx-doc/sphinx
GitHub で見るsphinx.ext.doctest should ensure that output is patched before importing the target
Open
#3,891 opened on 2017年6月25日
builderextensions:doctesthelp wantedtype:proposal
説明
Problem
- sphinx.ext.doctest will import the target before making sure that docutils has patched
sys.stdoutandsys.stderrwith_SpoofOutobjects. 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