最新的 black (25.1.0) 在文档字符串之后和异常类中的传递之前添加了换行符
当最新版本 – 25.1.0 – 重新格式化以下代码以在文档字符串和pass
之间添加丑陋的(对我来说)换行符时,我提交了针对 Black 的错误报告:
类模型错误(异常): “模型可以引发此错误,该错误将显示给用户” 经过
Black 维护者 Jelle Zijlstra 确认这是针对Black 2025 稳定风格的有意行为,但也帮助我理解了那里的pass
实际上是不必要的,因此我可以通过完全删除它来修复美观问题。
我链接到这个问题是因为这是一个很好的例子,说明了我如何使用uvx来复制步骤来创建单行代码,您可以将其粘贴到终端中以查看我报告的错误。在这种情况下,我分享了以下内容:
这是使用
uvx
来查看这种情况发生的方法。与之前的黑色版本相比:echo '类模型错误(异常): “模型可以引发此错误,该错误将显示给用户” 通过' | uvx --with ' black==24.10.0 '黑色 -这输出:
class ModelError(Exception): "Models can raise this error, which will be displayed to the user" pass All done! ✨ 🍰 ✨ 1 file left unchanged.
但如果你升级到
25.1.0
就会发生这种情况:echo '类模型错误(异常): “模型可以引发此错误,该错误将显示给用户” 通过' | uvx --with ' black==25.1.0 '黑色 -输出:
class ModelError(Exception): "Models can raise this error, which will be displayed to the user" pass reformatted - All done! ✨ 🍰 ✨ 1 file reformatted.
原文: https://simonwillison.net/2025/Jan/31/black-newline-docstring/#atom-everything