在 Sphinx 中避免来自父级的文档字符串

Question

我将 Sphinx 用于自动文档，但我发现它默认将父类文档字符串附加到我的文档字符串的方式很烦人。

结果是，对于从unittest.TestCase继承的每个记录的测试类，我得到文档字符串“创建一个在执行时将使用命名测试方法的类的实例。如果该实例没有一个方法，则引发 ValueError指定的名称。” 附加。 所以这两句话一遍又一遍地乱扔我的测试文档。

如何阻止 Sphinx 从父级中提取文档字符串？

Answer 1

有一个设置：

autodoc_inherit_docstrings

此值控制文档字符串继承。 如果设置为True类或方法的文档字符串，如果没有明确设置，则是继承形式（原文如此）父母。

默认值为True 。

1.7 版中的新功能。

尽管小心使用 - 此设置似乎破坏了我在文档字符串中调用的指令。