在 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 块中。

.. 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

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

In Python Sphinx, is there a way to hide autodoc setup code?

python

doctest

python-sphinx

autodoc