Poprawny styl łamania linii podczas łączenia metod w Pythonie

PEP 8 zaleca używanie nawiasów, aby nie było potrzeby \, i delikatnie sugeruje łamanie przed operatorami binarnymi zamiast po nich. Tak więc preferowany sposób formatowania kodu jest następujący:

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

Dwa istotne fragmenty to ten z Maksymalna długość linii sekcja:

Preferowanym sposobem owijania długich linii jest użycie implikowanej linii Pythona w nawiasach, nawiasach i nawiasach klamrowych. Długie linie mogą być łamane przez wiele linii przez zawijanie wyrażeń w nawiasy. Powinny one być używane zamiast odwrotnego ukośnika dla kontynuacji linii.

... a cały powinien przerwać wiersz przed czy po operatorze binarnym? sekcja:

Czy linia powinna pękać przed czy po operatorze binarnym?

Przez dziesięciolecia zalecanym stylem było zerwanie po operatorach binarnych. Ale może to zaszkodzić czytelności na dwa sposoby: operatorzy mają tendencję do rozproszone w różnych kolumnach na ekranie, a każdy operator jest odszedł od operandu i przeszedł na poprzednią linię. Tutaj, oko musi wykonać dodatkową pracę, aby stwierdzić, które elementy są dodawane, a które są odejmowane:

# No: operators sit far away from their operands
income = (gross_wages +
          taxable_interest +
          (dividends - qualified_dividends) -
          ira_deduction -
          student_loan_interest)

Aby rozwiązać ten problem czytelności, matematycy i ich wydawcy postępuj zgodnie z przeciwną konwencją. Donald Knuth wyjaśnia tradycyjne zasada w serii komputerów i składu : "chociaż formuły w obrębie akapitu zawsze przerwa po operacji binarnych i relacje, wyświetlane formuły zawsze pękają przed operacjami binarnymi "

Podążanie za tradycją z matematyki zwykle skutkuje bardziej czytelny kod:

# Yes: easy to match operators with operands
income = (gross_wages
          + taxable_interest
          + (dividends - qualified_dividends)
          - ira_deduction
          - student_loan_interest)

W kodzie Pythona dozwolone jest łamanie przed lub po binarnym operator, o ile konwencja jest spójna lokalnie. Dla nowych sugerowany jest styl kodu Knutha.

Zauważ, że, jak wskazano w powyższym cytacie, PEP 8 użył , aby dać przeciwną Radę o tym, gdzie złamać wokół operator, cytowany poniżej dla potomności:

Preferowanym sposobem owijania długich linii jest użycie domyślnej linii Pythona kontynuacja wewnątrz nawiasów, nawiasów i szelek. Długie linie mogą być łamane przez wiele linii przez zawijanie wyrażeń w nawiasy. Te powinien być używany zamiast odwrotnego ukośnika dla kontynuacji linii. Upewnij się, że kontynuowana linia jest odpowiednio wcięta. Preferowane miejsce złamanie wokół operatora binarnego to po {[7] } centrala, nie wcześniej. Niektóre przykłady:

class Rectangle(Blob):

    def __init__(self, width, height,
                 color='black', emphasis=None, highlight=0):
        if (width == 0 and height == 0 and
            color == 'red' and emphasis == 'strong' or
            highlight > 100):
            raise ValueError("sorry, you lose")
        if width == 0 and height == 0 and (color == 'red' or
                                           emphasis is None):
            raise ValueError("I don't think so -- values are %s, %s" %
                             (width, height))
        Blob.__init__(self, width, height,
                      color, emphasis, highlight)