您将如何正确打破这条线以匹配 pep8 规则？

Question

给定这个 Python 类，实现一个 Django 表单，你将如何正确地打破它以满足 PEP8 标准？

class MyForm(forms.Form):
    categories = forms.CharField(required=False,
                                 widget=forms.SelectMultiple(choices=CATEGORY_VALUE),                                               
                                 label="Categories")
    additional_item_ship_cost = forms.CharField(required=False, max_length=10,                                                      
                                                label="Additional Item Ship Cost")

具体来说，widget= 和 label= 参数违反了 PEP8 的行长规则。

立即想到的是，我可以在类之外定义小部件和标签，然后在类定义中使用它们，但这感觉很不符合 Python 风格。

Answer 1

我同意对续行使用双（8 列）缩进，因为它很容易区分续行和块缩进。我还希望缩进与第一行的长度无关；长度会随着代码的维护而改变，但这不应该改变续行。

所以不要将续行与第一行的任何内容对齐；相反，对任何续行使用相同的相对缩进。

用于继续的反斜杠是有问题的（不可见的尾随空格会改变效果），幸运的是几乎从不需要，因为 Python 会自动在开括号语法中继续语句。 在左括号中中断函数调用（以及左括号中的字典、左括号中的列表等）是我首先要做的。

所以我会这样做：

class MyForm(forms.Form):
    categories = forms.CharField(
            required=False,
            widget=forms.SelectMultiple(
                choices=CATEGORY_VALUE),
            label="Categories")
    additional_item_ship_cost = forms.CharField(
            required=False, max_length=10,
            label="Additional Item Ship Cost")

Answer 2

您已经知道可以在括号内以逗号分隔一行。您知道吗，您始终可以使用反斜杠-换行符组合来分割无法分割的行？：

class MyForm(forms.Form):
    categories = forms.CharField(required=False,
                                 widget=forms.SelectMultiple(choices=\
                                     CATEGORY_VALUE),                                               
                                 label="Categories")
    additional_item_ship_cost = forms.CharField(required=False, max_length=10,                                                      
                                                label=\
                                                "Additional Item Ship Cost")

另外，你可能不知道 Python 会连接相邻的文字字符串， 扔掉它们之间的任何空格，所以上面可以重写为：

class MyForm(forms.Form):
    categories = forms.CharField(required=False,
                                 widget=forms.SelectMultiple(choices=CATEGORY_VALUE),                                               
                                 label=\
                                     "Categories")
    additional_item_ship_cost = forms.CharField(required=False, max_length=10,                                                      
                                                label="Additional"\
                                                    " Item Ship Cost")

最后，在括号内，您可以在“点”处拆分行，就像在逗号处一样，您可以使用括号来获得此功能：

class MyForm(forms.Form):
    categories = forms.CharField(required=False,
                                 widget=forms.
                                     SelectMultiple(choices=\
                                     CATEGORY_VALUE),                                               
                                 label="Categories")
    additional_item_ship_cost = (forms.
                                     CharField(required=False, max_length=10,                                                      
                                               label="Additional "\
                                                   "Item Ship Cost"))

将所有这些与后续拆分行的明智去缩进结合起来，您应该能够避免超过 80 个字符的行。

Answer 3

我不认为 PEP8 对此有太多说明，但我会简单地对参数使用双缩进：

class MyForm(forms.Form):
    categories = forms.CharField(
            required=False,
            widget=forms.SelectMultiple(choices=CATEGORY_VALUE),
            label="Categories"
        )
    additional_item_ship_cost = forms.CharField(
            required=False,
            max_length=10,
            label="Additional Item Ship Cost"
        )