python - Doctest 在 Sphinx 中不起作用，无法导入 python 文件 Python

Question

我在尝试从 Sphinx Tutorial 运行 doctest 时遇到问题.我有下面的目录树，但我无法为 lumache.py 运行 doctest。如何才能使 lumache.py 可以通过 conf.py 中的 pathlib 函数导入，这是 sys. path.insert(0, pathlib.Path(__file__).parents[2].resolve().as_posix())。我要执行的代码与教程中的代码相同(超链接在第一句话)。

conf.py 内容

# If extensions (or modules to document with autodoc) are in another directory,
# add these directories to sys.path here.
import pathlib
import sys
sys.path.insert(0, pathlib.Path(__file__).parents[2].resolve().as_posix())

extensions = [
    'sphinx.ext.duration',
    'sphinx.ext.doctest',
]

...

内容 lumache.py

def get_random_ingredients(kind=None):
    return ["shells", "gorgonzola", "parsley"]

命令执行

C:\docs>make doctest
ModuleNotFoundError: No module named 'lumache'

目录树:

docs/
├─build/
│ ├─doctest/
│ │ └─0 folder(s), 1 file(s)
│ ├─doctrees/
│ │ └─0 folder(s), 3 file(s)
│ └─html/
│   └─3 folder(s), 7 file(s)
├─make.bat
├─Makefile
└─source/
  ├─conf.py
  ├─index.rst
  ├─lumache.py
  ├─usage.rst
  ├─_static/
  │ └─0 folder(s), 0 file(s)
  └─_templates/
    └─0 folder(s), 0 file(s)

Answer 1

将 lumache.py 移动到您的项目文件夹(即与 docs/ 当前所在的文件夹相同)。