Python doctest 不会运行命名为 signal.py 的文件

Question

问题

我在 Fedora 28 上使用 python 3.6.6。我的项目结构如下：

test/__init__.py
test/signal.py
test/notsignal.py

如果我运行$ python3 -m doctest -v test/signal.py 我得到：

10 items had no tests:
    signal
    signal.Handlers
    signal.ItimerError
    signal.Sigmasks
    signal.Signals
    signal._enum_to_int
    signal._int_to_enum
    signal.struct_siginfo
    signal.struct_siginfo.__reduce__
    signal.struct_siginfo.__repr__
0 tests in 10 items.
0 passed and 0 failed.
Test passed.

对我来说，这清楚地表明 doctest 正在尝试运行内置 signal 模块。通过重命名文件，我能够运行 docset。我是不是遗漏了什么或者这是一个错误？

重现

您可以使用以下 shell 脚本。

#!/bin/sh
mkdir -p test
touch test/__init__.py
echo -e ""'"'""'"'""'"'"\n>>> _ = print(f'Doctest at {__name__} was run.')\n"'"'""'"'""'"'"" > test/signal.py
cp test/signal.py test/notsignal.py
python3 -m doctest -v test/signal.py
python3 -m doctest -v test/notsignal.py

Answer 1

如果您查看 doctest source，您可以看到 doctest 尝试导入您传递给它的模块。

很可能标准库的信号模块已经被导入：

$ python -c 'import sys;import doctest;print("signal" in sys.modules)'
True

当 doctest 尝试导入时，Python 解释器发现 sys.modules 和 returns 中已经有一个名为 "signal" 的模块，而不是您的信号模块。

也许这是一个错误 - 也许 doctest 可以更聪明地了解它的导入方式 - 但实际上我认为最好的做法是重命名你的模块。一般来说，与标准库模块同名的模块几乎总是会导致问题。

Python doctest 不会 运行 命名为 signal.py 的文件

Python doctest does not run on files named as signal.py

python

doctest

问题

重现

Python doctest 不会运行命名为 signal.py 的文件