Question

我试图在我的文档字符串上使用prospector在python文件之上。

以下是我的文档字符串的示例：

"""item_exporters.py contains Scrapy item exporters.

Once you have scraped your items, you often want to persist or export those items, to use the data in some other
application. That is, after all, the whole purpose of the scraping process.

For this purpose Scrapy provides a collection of Item Exporters for different output formats, such as XML, CSV or JSON.

More Info:
    https://doc.scrapy.org/en/latest/topics/exporters.html

"""

它有一个问题：

pep257: D213 / Multi-line docstring summary should start at the second line

因此我将第一行向下移动，它将从第二行开始：

"""
item_exporters.py contains Scrapy item exporters.

Once you have scraped your items, you often want to persist or export those items, to use the data in some other
application. That is, after all, the whole purpose of the scraping process.

For this purpose Scrapy provides a collection of Item Exporters for different output formats, such as XML, CSV or JSON.

More Info:
    https://doc.scrapy.org/en/latest/topics/exporters.html

"""

然后，如果我再次运行探矿者，我会将D212作为错误。

pep257: D212 / Multi-line docstring summary should start at the first line

D212和D213有问题吗？

Answer 1

D212 and D213 are mutually exclusive. You should enable one or none of them. By default, they are both disabled, but if you used the ignore flag, you need to also add them.

使用ignore标志：

--ignore=D212

Answer 2

根本原因：

正如@zachgates在接受的答案中指出的那样，问题是两个互斥的规则。而且，尽管他的解决方案可在其他样机中使用，但不能解决不支持--ignore标志的Prospector中的问题。

针对Prospector用户的解决方案：

特别是对于Prospector，似乎没有命令行方法可以忽略各个规则。 docs建议创建一个配置文件，但这对于我的用例来说还不够便携。

解决方法是从内置配置文件列表here中选择默认配置文件之一。

事实证明，名为default的配置文件足够聪明，不会尝试捕获两个互斥的错误。我仍然不知道为什么探矿者默认使用的配置没有其自己的内置配置文件default的常识。

解决方案：

如果使用Prospector，这应该可以解决您的问题：

--profile=default

PEP257 - D212和D213有冲突吗？

2 个答案: