blue 0.9.1

什么是blue？

blue 是一个比 black（Python格式化工具的老大）稍微妥协一点的代码格式化工具。我们喜欢自动格式化Python代码的想法，这是受到 black 的启发，但是我们反对 black 一些决策。对 black 为Python代码格式化做出的开创性贡献和其出色的实现表示敬意。

当 blue 维护者与 black 在风格（不可配置）选择上意见不一致时，我们会 monkeypatch 来改变这些决策以满足我们的喜好。我们希望这些差异尽可能小；即使在某些情况下我们更愿意有所不同，我们也可以为了保持一致性而接受很多。

我们希望避免分叉或猴子补丁。相反，我们的希望是最终能够与 black 的维护者合作，仅添加少量配置，并将其合并回 black 项目。如果 blue 最终被废弃，我们将非常高兴。在此之前，我们将维护我们在 black 之上的小型修改集，并仔细考虑需要哪些其他偏差来缓和我们敏感但经验丰富的眼睛。

如何使用 blue？

与使用 black 完全相同。调用和配置 blue 的方式与 black 相同——只需用 blue 命令替换 black 命令，然后坐下来，享受更好的格式化 Python 代码！关于此处未列出的任何内容，您都可以参考 black 的文档。

现在就使用 iblueit.dev 尝试一下吧。

有什么不同之处？

以下是 blue 和 black 之间的一些不同之处。

• blue 默认使用单引号字符串。这可能是我们眼中 black 最痛苦的选择，也是 blue 的灵感来源。我们强烈倾向于使用单引号字符串，而不是双引号字符串，用于除文档字符串和三引号字符串 (TQS) 之外的所有内容。不要问我们为什么我们喜欢双引号用于 TQS；对我们来说，它看起来更好！对于所有其他字符串，blue 默认使用单引号字符串。在文档字符串的情况下，这些总是使用带有双引号的三引号字符串。

• blue 默认的行长度为 79 个字符。几乎所有项目都创建一个 pyproject.toml 文件只是为了更改这个设置，因此使其与 PEP 8 保持一致似乎是相对无害的。

• blue 保留了位于井号前的空格，用于右侧悬挂的注释。

• blue 支持多个配置文件：pyproject.toml、setup.cfg、tox.ini 和 .blue。

我们正在 积累 我们正在考虑的其他偏差列表。当我们决定实施任何特定的建议时，我们将将其转化为单独的问题，并逐一解决。如果您有关于从 black 的选择中偏离的建议，请在我们的跟踪器上打开单独的工单，我们将看看结果如何！

为什么是“blue”？

有几个原因！如果您的格式化器会打你的代码，它会把它弄得又黑又蓝，或者在这种情况下，是黑 或 蓝。蓝色更好！

我们还考虑了“tan”，因为，yum！但那个项目名已经被占用。坦白地说，“blue”也被占用了，但基本没有被使用。感谢 Nick Ficano 将项目命名空间捐赠给我们！

蓝色也是 LinkedIn 的颜色，作者是我们慷慨的雇主，我们打算在我们公司的代码库中推广其使用。

贡献者

blue 感谢以下贡献者名单，因为它们带来了所有美好的东西。

• black 项目中的 美好的人们。

• Grant Jenks

• Barry Warsaw

• FutureSpaceDesigns 的 Corey，为非官方标志和 blue 项目商品。

blue 在 Apache 许可证 Version 2.0 的条款下许可。 black 在 MIT 许可证的条款下许可。

项目详情

• 项目主页： https://github.com/grantjenks/blue

• 在以下链接报告错误和建议： https://github.com/grantjenks/blue/issues

• 代码托管： https://github.com/grantjenks/blue.git

• 文档： https://blue.readthedocs.io/en/latest

• 试用： https://iblueit.dev