在 Python 中链接方法时正确的换行样式

Question

我有一些这样的代码。休息时间应该在经期之前还是之后？

# before
my_var = somethinglikethis.where(we=do_things).where(we=domore).where(we=everdomore)

# this way
my_var = somethinglikethis.where(we=do_things) \
                          .where(we=domore) \
                          .where(we=everdomore)

# or this way
my_var = somethinglikethis.where(we=do_things). \
                           where(we=domore). \
                           where(we=everdomore)

Answer 1

PEP 8 建议使用括号，这样您就不需要 \，并温和地建议在二元运算符之前而不是之后断开。因此，格式化代码的首选方式如下：

my_var = (somethinglikethis
          .where(we=do_things)
          .where(we=domore)
          .where(we=everdomore))

两个相关段落是来自 最大行长度 部分：

换行长行的首选方法是在圆括号、方括号和大括号内使用 Python 的隐式续行符。通过将表达式括在括号中，可以将长行分成多行。应优先使用这些内容而不是使用反斜杠来继续行。

...以及整个 应该在二元运算符之前还是之后换行？ 部分：

应该在二元运算符之前还是之后换行？

几十年来，推荐的风格是在二元运算符之后中断。
但这会以两种方式损害可读性：操作员往往会得到
分散在屏幕上的不同列中，每个操作员都是
离开其操作数并移至上一行。这里，眼睛
必须做额外的工作来判断添加了哪些项目以及哪些是
减去：

# 否：运算符远离操作数
收入=（工资总额+
          应税利息 +
          （股息 - 合格_股息） -
          ira_扣除 -
          学生贷款利息）

为了解决这个可读性问题，数学家和他们的出版商
遵循相反的约定。唐纳德·高德纳 (Donald Knuth) 解释了传统的
他的计算机和排版系列中的规则是：“虽然公式
在一个段落中总是在二元运算和关系之后中断，
显示的公式总是在二元运算之前中断”

遵循数学传统通常会得到更多结果
可读代码：

# 是：易于将运算符与操作数匹配
收入=（工资总额
          + 应税利息
          +（股息 - 合格_股息）
          - ira_扣除
          - 学生贷款利息）

在Python代码中，允许在二进制文件之前或之后中断
运算符，只要约定在本地一致即可。对于新的
建议使用 Knuth 的代码风格。

请注意，如上面的引用所示，PEP 8 曾经给出了关于在哪里突破运算符的相反建议，如下引用以供后代使用：

换行长行的首选方法是使用 Python 的隐含行
括号、方括号和大括号内的延续。长线可以
通过将表达式括在括号中来分成多行。这些
应优先使用反斜杠来继续行。
确保适当缩进续行。首选地点
突破二元运算符是在该运算符之后，而不是在其之前。
一些例子：

类矩形（Blob）：

    def __init__(自身，宽度，高度，
                 颜色='黑色'，强调=无，突出显示=0）：
        如果（宽度 == 0 且高度 == 0 且
            颜色 == '红色' 且强调 == '强' 或
            突出显示> 100）：
            raise ValueError("对不起，你输了")
        如果宽度 == 0 且高度 == 0 且 (颜色 == '红色' 或
                                           重点是无）：
            raise ValueError("我不这么认为——值为 %s, %s" %
                             （宽度、高度））
        Blob.__init__(自身，宽度，高度，
                      颜色、强调、突出）

Answer 2

FWIW， autopep8 （带有 --aggressive 标志）产生了这个来自你的原始代码：

my_var = somethinglikethis.where(
    we=do_things).where(
    we=domore).where(
    we=everdomore)

但我同意——巴斯蒂安的解决方案更优雅。

Answer 3

做有效的事情。

另外，请查看有关 Python 中缩进神话的白皮书。可以找到这里。

它开始于：

“空格在 Python 源代码中很重要。”

不，一般来说不是。只有语句的缩进级别是
重要（即语句最左边的空白）。
在其他地方，空格并不重要，可以随意使用
就像，就像任何其他语言一样。您还可以插入空行
任何地方都不包含任何内容（或仅包含任意空格）。

我希望这有帮助。