PEP8 appeso specifica trattino

Question

PEP 8 relativa rientro sporgente:

Quando si utilizza un rientro sporgente si applicano le seguenti considerazioni; non ci dovrebbero essere argomenti sulla prima riga e dovrebbe essere usata un'ulteriore rientranza per distinguere chiaramente se stessa come una linea di continuazione.

Esiste una documentazione esplicita su "argomenti secondari"? Per esempio:

some_method(argument_one, argument_two, argument_three=[ 
    'parameter_one', 
    'parameter_two', 
    'parameter_three', 
    ]) 

Al contrario:

some_method(
    argument_one, 
    argument_two, 
    argument_three=[ 
     'parameter_one', 
     'parameter_two', 
     'parameter_three', 
     ] 
    ) 

collegamenti preferibilmente solo discussioni ufficiali.

Answer 1

Dalla sezione del PEP 8 "altre raccomandazioni":

Istruzioni composte (più istruzioni sulla stessa riga) sono generalmente scoraggiato.

Tenendo presente questo suggerimento, il secondo esempio è probabilmente più in linea con la guida di stile PEP 8, in quanto evita di combinare l'invocazione del metodo e la costruzione dell'elenco sulla stessa linea. Anche il 2 ° esempio si legge un po 'più facilmente.