使用Black自由格式化Python

开发 后端
在本系列中,我们将介绍七个可以帮助你解决常见 Python 问题的 PyPI 库。在第一篇文章中,我们了解了 Cython。今天,我们将使用 Black 这个代码格式化工具。

[[265528]]

在我们覆盖 7 个 PyPI 库的系列文章中了解解决 Python 问题的更多信息。

Python 是当今使用最多的流行编程语言之一,因为:它是开源的,它有广泛的用途(例如 Web 编程、业务应用、游戏、科学编程等等),它有一个充满活力和专注的社区支持它。这个社区可以让我们在 Python Package Index(PyPI)中有如此庞大、多样化的软件包,用以扩展和改进 Python 并解决不可避免的问题。

在本系列中,我们将介绍七个可以帮助你解决常见 Python 问题的 PyPI 库。在***篇文章中,我们了解了 Cython。今天,我们将使用 Black 这个代码格式化工具。

Black

有时创意可能是一件美妙的事情。有时它只是一种痛苦。我喜欢创造性地解决难题,但我希望我的 Python 格式尽可能一致。没有人对使用“有趣”缩进的代码印象深刻。

但是比不一致的格式更糟糕的是除了检查格式之外什么都没有做的代码审查。这对审查者来说很烦人,对于被审查者来说甚至更烦人。当你的 linter 告诉你代码缩进不正确时,但没有提示正确的缩进量,这也会令人气愤。

使用 Black,它不会告诉你做什么,它是一个优良、勤奋的机器人:它将为你修复代码。

要了解它如何工作的,请随意写一些非常不一致的内容,例如:

  1. def add(a, b): return a+b
  2.  
  3. def mult(a, b):
  4. return \
  5. a * b

Black 抱怨了么?并没有,它为你修复了!

  1. $ black math
  2. reformatted math
  3. All done! 🍰
  4. 1 file reformatted.
  5. $ cat math
  6. def add(a, b):
  7. return a + b
  8.  
  9.  
  10. def mult(a, b):
  11. return a * b

Black 确实提供了报错而不是修复的选项,甚至还有输出 diff 编辑样式的选项。这些选项在持续集成 (CI)系统中非常有用,可以在本地强制运行 Black。此外,如果 diff 输出被记录到 CI 输出中,你可以直接将其粘贴到 patch 中,以便在极少数情况下你需要修复输出,但无法本地安装 Black 使用。

  1. $ black --check --diff bad
  2. --- math 2019-04-09 17:24:22.747815 +0000
  3. +++ math 2019-04-09 17:26:04.269451 +0000
  4. @@ -1,7 +1,7 @@
  5. -def add(a, b): return a + b
  6. +def add(a, b):
  7. + return a + b
  8. def mult(a, b):
  9. - return \
  10. - a * b
  11. + return a * b
  12. would reformat math
  13. All done! 💥 💔 💥
  14. 1 file would be reformatted.
  15. $ echo $?
  16. 1

在本系列的下一篇文章中,我们将介绍 attrs ,这是一个可以帮助你快速编写简洁、正确的代码的库。 

责任编辑:庞桂玉 来源: Linux中国
相关推荐

2023-12-05 18:04:58

PyCharmPython

2024-01-08 22:03:22

python代码开发

2009-06-05 15:27:23

Eclipse工具格式化模板应用

2010-08-03 10:46:41

Flex代码格式化

2010-03-16 11:20:38

Python格式化

2020-09-02 07:19:41

printf 格式化输出Unix

2020-11-03 10:21:33

MySQL

2022-06-26 08:39:19

Spring容器字段格式化

2009-08-03 14:25:59

C#日期格式化

2021-06-09 07:55:18

Python格式化字符串

2019-07-30 10:51:45

Markdown格式化文档Linux

2022-05-09 08:17:37

InstantJava字符

2010-01-21 13:41:05

VB.NET磁盘格式化

2010-07-29 11:12:30

Flex日期格式化

2009-08-03 16:24:05

C#格式化

2011-03-07 15:01:42

MySQLXML数据

2022-05-17 07:54:40

代码前端格式化

2010-07-16 16:00:08

Perl格式化输出

2015-01-07 15:21:30

Android Stu代码格式化

2018-11-02 10:45:35

windowsU盘格式化
点赞
收藏

51CTO技术栈公众号