Path: csiph.com!news.swapon.de!eternal-september.org!feeder.eternal-september.org!mx02.eternal-september.org!.POSTED!not-for-mail
From: Marko Rauhamaa <marko@pacujo.net>
Newsgroups: comp.lang.python
Subject: Re: Guido sees the light: PEP 8 updated
Date: Sun, 17 Apr 2016 14:01:15 +0300
Organization: A noiseless patient Spider
Lines: 29
Message-ID: <877ffw5wjo.fsf@elektro.pacujo.net>
References: <5711c1b3$0$1596$c3e8da3$5496439d@news.astraweb.com> <dne6huFi9sfU1@mid.individual.net> <87shym6kpo.fsf@elektro.pacujo.net> <CAPTjJmrq-pFDGS14PE+FXx=B+fXBD-Pkqc9JdQrjULR9aXRSxg@mail.gmail.com> <mailman.43.1460795561.6324.python-list@python.org> <87h9f26ioa.fsf@elektro.pacujo.net> <1460809922.1918014.580580553.0AE05EE4@webmail.messagingengine.com> <CACwCsY5EG_RFHe8DMF4VStYCsSuO-gMC+KRx05q9=vu8aa3K9g@mail.gmail.com> <mailman.50.1460818461.6324.python-list@python.org> <878u0d7az5.fsf@elektro.pacujo.net> <8ff10001-1c49-4490-b873-018507243ea3@googlegroups.com>
Mime-Version: 1.0
Content-Type: text/plain
Injection-Info: mx02.eternal-september.org; posting-host="b7cb1518d23ec19d482dcc9c31d30fdd"; logging-data="29354"; mail-complaints-to="abuse@eternal-september.org";	posting-account="U2FsdGVkX19H7ukvIQyrL2BT3s3+qTZS"
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.5 (gnu/linux)
Cancel-Lock: sha1:nPKJ+SjOn+TQij0S7Hh4QgbCty0= sha1:Op1yOMJ8MsLiNV+GPoCI8vMU+pc=
Xref: csiph.com comp.lang.python:107169

Rustom Mody <rustompmody@gmail.com>:

> On Saturday, April 16, 2016 at 10:22:10 PM UTC+5:30, Marko Rauhamaa wrote:
>> A max line length of 79 characters is among the *only* rigorous
>> principles I judge coding style on.
>> 
>> It comes with the maxim that one function must be visible at once on the
>> screen.
>
> Thats a strange self-contradiction.

Why? You are allowed to break a function into subfunctions, you know.

In fact, if you find yourself introducing coding "paragraphs" with
comments:

    def f(...):
        # I'll start by doing this
        ...
        # segueing into the middle portion
        ...
        # and finish it off as follows
        ...

you had better break those paragraphs off into separate functions. Just
turn your comments into function names.


Marko