Coding style - keep parentheses on the same line or new line?

Question

Suppose you are calling a function, where there's clearly a need to break down the statement into few lines, for readability's sake. However there are at least two way to do it:

Would you do this:

return render(request, template,
              {
                'var1' : value1,
                'var2' : value2,
                'var3' : value3
               }
             )

Or would you rather do that:

return render \
(
    request, template,
    {
        'var1' : value1,
        'var2' : value2,
        'var3' : value3
    }
)

Or, please suggest your own formatting. Please also list reasons why would you use a particular formatting and what's wrong with the other one.

Thanks

Answer 1

Python's official PEP-8 suggests the first one.

Answer 2

I'd probably do:

return render(
    request, 
    template,
    {
        'var1' : value1,
        'var2' : value2,
        'var3' : value3
    }
)

I would keep the bracket on the same line, so that searches for render( work. And because I find it clearer. But I'd put all the arguments on new lines.

Answer 3

The second one looks like it escaped from a C[#+]* program. Backslash line continuation is ugly, prone to trouble with trailing space, and there's no excuse to use it when you've got () or [] to use.

Answer 4

I would do:

vars = {
    'var1' : value1,
    'var2' : value2,
    'var3' : value3,
}
return render(request, template, vars)