预期的构建警告#

在我们的 CI 工作流中,我们使用脚本来检查 Sphinx 引发的任何警告,以确保只有_预期的_警告。预期的警告列表可以在 :code:tests/warning_list.txt 中找到。要添加新条目,请将警告消息(以 :code:WARNING: 开头的消息)复制/粘贴到文件底部。

例如,如果您收到:

Unexpected warning: C:\hostedtoolcache\windows\Python\3.9.13\x64\lib\site-packages\pandas\core\frame.py:docstring of pandas.core.frame.DataFrame.groupby:42: WARNING: undefined label: 'groupby.transform'

将以下内容添加到 txt 文件中:

WARNING: undefined label: 'groupby.transform'