爲什麼在使用Sphinx的`make doctest`運行時，doctests會引發NameError？

Question

我有一個簡單function with a doctest，它在與獅身人面像的make doctest運行，使我有以下錯誤：

File "scheemey.rst", line ?, in default 
Failed example: 
    verify_balanced('asdf (foo [bar] [[baz], {},()]') 
Exception raised: 
    Traceback (most recent call last): 
     File "/usr/local/Cellar/python/2.7.8/Frameworks/Python.framework/Versions/2.7/lib/python2.7/doctest.py", line 1315, in __run 
     compileflags, 1) in test.globs 
     File "<doctest default[0]>", line 1, in <module> 
     verify_balanced('asdf (foo [bar] [[baz], {},()]') 
    NameError: name 'verify_balanced' is not defined 

可能是什麼造成的？

Answer 1

如果具有測試函數的模塊沒有正確導入，我可以在問題中重現錯誤。

要使其工作，你可以使用一個testsetup指令：

.. testsetup:: 

    from yourmodule import verify_balanced 

>>> verify_balanced('asdf (foo) [bar] [[baz], {},()]') 
>>> verify_balanced('asdf (foo [bar] [[baz], {},()]') 
5 

注意，文檔測試忽略None返回值（見Python doctests: test for None）。