#8856·ruff

docstring 代码格式化器: 当代码片段无法格式化时,发出警告消息

作者: BurntSushi创建于 2023年11月27日更新于 2026年9月16日
标签docstringformatterwish

#8811 添加了对在文档字符串中格式化 doctest 代码片段的初始支持,但它确实有一些默默无声的行为,可能应该更加明显。例如,如果它检测到一个无效的 Python 代码片段,则会默默地跳过该代码片段。另一个例子更加病态,但在某些情况下,代码片段格式化器可能会生成无效的 Python(由于在某些情况下存在嵌套的三重引号字符串)。在这种情况下,我们会检测到它并放弃重新格式化该代码片段。理想情况下,我们还应该对此发出警告,尽管这在当前实现中可以视为是一个 bug。