Path: ...!eternal-september.org!feeder3.eternal-september.org!news.eternal-september.org!.POSTED!not-for-mail
From: David Brown <david.brown@hesbynett.no>
Newsgroups: comp.unix.shell,comp.unix.programmer,comp.lang.misc
Subject: Re: Python (was Re: I did not inhale)
Date: Thu, 29 Aug 2024 14:05:41 +0200
Organization: A noiseless patient Spider
Lines: 36
Message-ID: <vapo6l$3v4l8$2@dont-email.me>
References: <uu54la$3su5b$6@dont-email.me> <va4aut$3q4g0$1@dont-email.me>
 <va4fbr$3qvij$1@dont-email.me> <va5108$3tmmd$1@dont-email.me>
 <va51ok$3tqr9$1@dont-email.me> <va5ec2$3vluh$1@dont-email.me>
 <va6q4g$c1a7$1@dont-email.me> <va6rpa$c6bg$1@dont-email.me>
 <va6se9$cb8e$1@dont-email.me> <20240826083330.00004760@gmail.com>
 <vaises$2k7o6$2@dont-email.me> <20240826155113.000005ba@gmail.com>
 <wwvo75eicla.fsf@LkoBDZeT.terraraq.uk> <vak9k9$2ujrs$1@dont-email.me>
 <valgpu$34s18$1@dont-email.me> <87y14hd4bk.fsf@nosuchdomain.example.com>
 <valnei$35rt8$2@dont-email.me> <87ikvlcs7i.fsf@nosuchdomain.example.com>
 <vamclm$3c4ke$1@dont-email.me> <87ttf4bdcx.fsf@nosuchdomain.example.com>
 <vaoaak$3l470$3@dont-email.me> <875xrkb2iq.fsf@nosuchdomain.example.com>
 <vaoibg$3m9tm$2@dont-email.me>
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 8bit
Injection-Date: Thu, 29 Aug 2024 14:05:41 +0200 (CEST)
Injection-Info: dont-email.me; posting-host="737b96d1a4f94365fbc2f60b2f2e5810";
	logging-data="4166312"; mail-complaints-to="abuse@eternal-september.org";	posting-account="U2FsdGVkX18m2Aid/cGKY3fCEUMN/YrnmtwPcKm7z9I="
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101
 Thunderbird/102.11.0
Cancel-Lock: sha1:9pvAoNhvlwti8w8Iq5M18wXSLhQ=
Content-Language: en-GB
In-Reply-To: <vaoibg$3m9tm$2@dont-email.me>
Bytes: 3101

On 29/08/2024 03:19, Lawrence D'Oliveiro wrote:
> On Wed, 28 Aug 2024 17:23:25 -0700, Keith Thompson wrote:
> 
>> That's not the conventional way to format a docstring.  If you're using
>> backslashes to splice lines in Python, it's likely you're doing
>> something wrong.
> 
> What exactly is wrong?
> 
>> I think "is not None" is more idiomatic.
> 
> When I want an equality comparison, I use “==”, not “is”.
> 
>> You don't need the \ if you put the ( on the same line.
> 
> But I do otherwise.
> 
>> You leave a space between "else" and ":".  It's not wrong, but it's not
>> something I've ever seen.
> 
> People who look at my code tend to get triggered by the little things;
> maybe it’s a way to avoid thinking about the big things?

"""
There are two ways of constructing a software design: One way is to make 
it so simple that there are obviously no deficiencies, and the other way 
is to make it so complicated that there are no obvious deficiencies. The 
first method is far more difficult.
"""

You are clearly aiming for the second method here - put in so much extra 
crap and silliness that readers get caught up in that instead of 
noticing that most of the function is meaningless.