python - 在Python Sphinx中，有没有办法隐藏autodoc设置代码？

Question

我正在使用 Sphinx autodoc 来记录我的 Python 代码。我的文档中的示例包含:

• 无趣的设置代码，我不想在 HTML 文档中呈现
• 应出现在文档中的代码

例如:

Then you process file `example.txt` with `frobnicate()`:

    >>> with open('example.txt', 'w') as f:
    ...     _ = f.write("first boring line\\n")
    ...     _ = f.write("second boring line\\n")

    >>> frobnicate('example.txt')
    True

我希望 Sphinx autodoc 隐藏无趣的设置代码，以便 Sphinx 渲染的 HTML 输出仅包含:

Then you process file example.txt with frobnicate():

    >>> frobnicate('example.txt')
    True

显然我仍然希望 doctest 像往常一样执行整个示例。

Answer 1

您可以将无趣的设置代码放在 testsetup 中 block 。

.. testsetup:: *

   with open('example.txt', 'w') as f:
       _ = f.write("first boring line\\n")
       _ = f.write("second boring line\\n")

Then you process file `example.txt` with `frobnicate()`:

>>> frobnicate('example.txt')
True