导入模块之前的nose-doctest模块夹具

Question

我使用鼻子进行测试收集，我也想使用它的 doctest 插件。我有一个需要固定装置才能导入的模块。因此，我不能使用鼻子的模块夹具，因为它们是从被测模块加载的。有没有办法在模块之外为 nose-doctest 指定模块夹具？

对于某些用例，一个选项是检测是否在 doctest 下运行并在模块的开头应用夹具。我也很想听听这个用例的答案。

但是，在某些情况下这不起作用：当导入由于SyntaxError 而失败时，不会运行任何模块代码。就我而言，我主要开发与 python 2 和 python 3 兼容的代码（没有2to3）。但是，在 python 2 下运行时，有一些特定于 python 3 的模块根本不应该被鼻子检查。我最好的选择是什么？

编辑：MWE（针对SyntaxError 情况）

我有一个包含许多小模块的包，其中一些使用 python 3 语法。 这是包结构：

~/pckg/
  __init__.py
  py3only.py
  ... (other modules)
  tests/
    test_py3only.py

有些测试写成unittest.TestCase，但我也想要测试文档字符串中的代码示例。 ~/pckg/__init__.py 为空。

~/pckg/py3only.py:

def fancy_py3_func(a:"A function argument annotation (python 3 only syntax)"):
    """ A function using fancy syntax doubling it's input.

    >>> fancy_py3_func(4)
    8
    """
    return a*2

~/pckg/tests/test_py3only.py:

import sys, unittest

def setup_module():
    if sys.version_info[0] < 3:
        raise unittest.SkipTest("py3only unavailable on python "+sys.version)

class TestFancyFunc(unittest.TestCase):
    def test_bruteforce(self):
        from pckg.py3only import fancy_py3_func
        for k in range(10):
            self.assertEqual(fancy_py3_func(k),2*k)

在 python 3 上测试，一切都经过测试并通过（从封闭文件夹运行，例如~）：

~ nosetests3 -v --with-doctest pckg
Doctest: pckg.py3only.fancy_py3_func ... ok
test_bruteforce (test_py3only.TestFancyFunc) ... ok

在 python 2 上，~/pckg/tests/test_py2only.py 的模块夹具正确地检测到了这种情况并跳过了测试。然而，我们从~/pckg/py3only.py 得到一个SyntaxError：

~ nosetests -v --with-doctest pckg 
Failure: SyntaxError (invalid syntax (py3only.py, line 1)) ... ERROR
SKIP: py3only unavailable on python 2.7.6 (default, Mar 22 2014, 22:59:56)

一个类似于~/pckg/tests/test_py3only.py:setup_module() 的函数可以解决这个问题，如果我能让nose 在它的doctest 插件甚至尝试导入该模块之前运行该代码。

看来我最好的选择是编写一个适当的顶级测试脚本来处理测试的集合......

Answer 1

可以使用nose-excludenose 插件排除特定的测试文件、目录、类或方法。它有--exclude-* 选项。

要处理缺失的模块，您必须使用mock 修补sys.modules。

F.e，mycalc 模块中有一个 Calc 类，但我无法访问它，因为它丢失了。还有两个模块，mysuper_calc 和 mysuper_calc3，后者是 Python 3 特有的。这两个模块导入 mycalc 和 mysuper_calc3 不应该在 Python 2 下进行测试。如何从模块中对它们进行 doctest，即在纯文本文件中？我认为这是OP的情况。

calc/mysuper_calc3.py

from sys import version_info
if version_info[0] != 3:
    raise Exception('Python 3 required')
from mycalc import Calc
class SuperCalc(Calc):
    '''This class implements an enhanced calculator
    '''
    def __init__(self):
        Calc.__init__(self)

    def add(self, n, m):
        return Calc.add(self, n, m)

calc/mysuper_calc.py

from mycalc import Calc

class SuperCalc(Calc):
    '''This class implements an enhanced calculator
    '''
    def __init__(self):
        Calc.__init__(self)

    def add(self, n, m):
        return Calc.add(self, n, m)

现在模拟出mycalc，

>>> from mock import Mock, patch
>>> mock = Mock(name='mycalc')

模块mycalc 有类Calc，它有方法add。我用2+3 测试SuperCalc 实例add 方法。

>>> mock.Calc.add.return_value = 5  

现在补丁sys.modules 和mysuper_calc3 可以在with 块内有条件地导入。

>>> with patch.dict('sys.modules',{'mycalc': mock}):
...     from mysuper_calc import SuperCalc
...     if version_info[0] == 3:
...         from mysuper_calc3 import SuperCalc

calc/doctest/mysuper_calc_doctest.txt

>>> from sys import version_info
>>> from mock import Mock, patch
>>> mock = Mock(name='mycalc')
>>> mock.Calc.add.return_value = 5

>>> with patch.dict('sys.modules',{'mycalc': mock}):
...     from mysuper_calc import SuperCalc
...     if version_info[0] == 3:
...         from mysuper_calc3 import SuperCalc
>>> c = SuperCalc()
>>> c.add(2,3)
5

文件mysuper_calc_doctest.txt 必须单独在其自己的目录中，否则nosetests 在非测试模块中搜索doctest。

PYTHONPATH=.. nosetests --with-doctest --doctest-extension=txt --verbosity=3

Doctest: mysuper_calc_doctest.txt ...好的

---

在 0.038 秒内运行 1 次测试

好的

nosetests 周围的包装器，用于检测 Python 3，它将没有语法错误的 .py 文件传递​​给 nosetests

mynostests.py

import sys
from subprocess import Popen, PIPE
from glob import glob

f_list = []

py_files = glob('*py')
try:
    py_files.remove(sys.argv[0])
except ValueError:
    pass

for py_file in py_files:
    try:
        exec open(py_file)
    except SyntaxError:
        continue
    else:
        f_list.append(py_file)

proc = Popen(['nosetests'] + sys.argv[1:] + f_list,stdout=PIPE, stderr=PIPE)
print('%s\n%s' % proc.communicate())
sys.exit(proc.returncode)

Answer 2

鼻子有以下选项：

  --doctest-fixtures=SUFFIX
                    Find fixtures for a doctest file in module with this
                    name appended to the base name of the doctest file

也许您可以将固定装置隔离到一个单独的文件中？