Comment casser une ligne dans une définition de fonction en Python selon pep8 ?

Question

J'ai la ligne de code suivante qui dépasse de peu la limite de 79 caractères :

def ReportResults(self, intTestID, startTime, stopTime, version, serverType):

Comment casser la ligne de la manière correcte selon pep8 ?

Answer 1

Selon PEP8 :

La bibliothèque standard Python est conservatrice et exige de limiter les lignes à 79 caractères (et les docstrings/commentaires à 72).

C'est à mon avis la principale règle à respecter.

En plus de cette règle, PEP8 recommande d'aligner les parenthèses, donc je ferais quelque chose comme :

def report_results(self,
                  intTestID,
                  startTime,
                  stopTime,
                  version,
                  serverType):

Notez que j'ai renommé votre méthode report_results en suivant la recommandation "lower_case_with_underscores".

Answer 2

79 caractères, c'est plus une ligne directrice qu'une règle .

Certaines équipes préfèrent nettement une longueur de ligne plus importante. Pour le code maintenu exclusivement ou principalement par une équipe qui peut se mettre d'accord sur cette question, il est possible d'augmenter la longueur de ligne nominale de 80 à 100 caractères (augmentant effectivement la longueur maximale à 99 caractères), à condition que les commentaires et les docstrings soient toujours enveloppés à 72 caractères.

De plus, cette ligne ne comporte que 77 caractères, donc tout devrait bien se passer. Cependant, si vous souhaitez la rompre, vous pouvez utiliser la continuation implicite :

def ReportResults(self,
                  intTestID,
                  startTime,
                  stopTime,
                  version,
                  serverType):

Si la signature d'une fonction dépasse largement la limite de caractères que vous utilisez, cela indique que la fonction a trop de paramètres.