Path: csiph.com!usenet.pasdenom.info!gegeweb.org!de-l.enfer-du-nord.net!feeder2.enfer-du-nord.net!feeds.phibee-telecom.net!newsfeed.xs4all.nl!newsfeed1.news.xs4all.nl!xs4all!post.news.xs4all.nl!not-for-mail
MIME-Version: 1.0
In-Reply-To: <CAAF+z6Hp=TZJwcDgyT94cv6Mx3Gy4gxSiZ640b9voAAjgsi6dw@mail.gmail.com>
References: <CAAF+z6Hp=TZJwcDgyT94cv6Mx3Gy4gxSiZ640b9voAAjgsi6dw@mail.gmail.com>
From: Joshua Landau <joshua.landau.ws@gmail.com>
Date: Mon, 8 Jul 2013 11:39:21 +0100
Subject: Re: A small question about PEP 8
To: Xue Fuqiao <xfq.free@gmail.com>
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable
Cc: python-list <python-list@python.org>
Precedence: list
Newsgroups: comp.lang.python
Message-ID: <mailman.4380.1373280314.3114.python-list@python.org>
Lines: 76
NNTP-Posting-Host: 2001:888:2000:d::a6
Xref: csiph.com comp.lang.python:50142

On 8 July 2013 00:32, Xue Fuqiao <xfq.free@gmail.com> wrote:
> Hi all,
>
> (English is not my native language; please excuse typing errors.)
>
> I'm a Python newbie and just started reading PEP 8.  PEP says:
>
> -----------------------------------------------------------------------
> |The closing brace/bracket/parenthesis on multi-line constructs may
> |either line up under the last item of the list, as in:
> |
> |my_list =3D [
> |    1, 2, 3,
> |    4, 5, 6,
> |    ]
> |result =3D some_function_that_takes_arguments(
> |    'a', 'b', 'c',
> |    'd', 'e', 'f',
> |    )
> -----------------------------------------------------------------------
>
> I think the last item in my_list/result is 6/'f', respectively.  So why
> doesn't the bracket/paren line up _under_ the last item?  ISTM the code
> isn't consistent with the description.
>
> I have searched the archive of c.l.p and the web, but nothing helped.
> Can anyone point me in the right direction?

You will grow to be a wonderful pedant. What it means is that the
indentation will match the last one. Imagine:

"""
a_wonderful_set_of_things =3D {
    bannanas_made_of_apples,
    chocolate_covered_horns,
    doors_that_slide,
    china_but_on_the_moon,
    buffalo_with_windy_hair,
    not_missing_an_end_brace
"""=C2=B9

Now, there are several places you can put the end brace. You can (be a
massive fool and) put it after the last item:

"""
a_wonderful_set_of_things =3D {
    ...,
    not_missing_an_end_brace}
"""

You can also (be a fool and) put it at the same *indentation*:

"""
a_wonderful_set_of_things =3D {
    ...,
    not_missing_an_end_brace
    }
"""

Or you can (be sane) and put it at no indentation:

"""
a_wonderful_set_of_things =3D {
    ...,
    not_missing_an_end_brace
}
"""

Theoretically, there are more places you could put it (but we won't go
there... *shudder*).

The second of these is the one that PEP 8 was trying to explain. I
agree wording could be improved, but hey. You can file a bug report at
bugs.python.org if you care enough.

=C2=B9}