[Python-Dev] pep8 reasoning

[Donald Stufft]

On Apr 26, 2014, at 12:31 AM, Stephen J. Turnbull <stephen at xemacs.org> wrote:

> Florent writes:
> 
>> I wrote some words in the documentation, one year ago, to explain what
>> is the purpose of the tool and its limitations. There's no claim of
>> any endorsement implicit or explicit by the PSF, the PSU or any other
>> python developer :-)
> 
> Of course there is an implicit claim of endorsement: the name.  Read
> the TeX license -- pretty much the only restriction is *you can't call
> it "TeX" or any variation including that trademark if it doesn't pass
> TRIP*.  When Don Knuth cares that much that names denote conformance
> to standard, Nick is in really good company.

No there isn’t.

For instance there are things on PyPI named after websites, like github,
twitter, Facebook, etc. These things are not written by the companies
behind those websites and are merely written to interface with those
websites. Should we assume that those companies all endorse every
single one of those projects simply because they chose a descriptive
name for their project?

The name indicates what it attempts to do, create a PEP8 linter, it makes
no claim of endorsement by the authors of the PEP.

You can say it’s confusing if it’s named pep8 but doesn’t actually make it
“PEP8”, but claiming it’s endorsement isn’t correct.

> 
> I agree 100% with Nick: in a program named "pep8", the examples in PEP
> 8 should *all* pass in the sense of not being labelled errors.  Of
> course if the PEP changes that doesn't mean you should withdraw or
> rename the program, or even that you are required to address the issue
> within any time span.  But you should consider it a bug.

Or required to address it at all if you don’t wish to.

Since the issue is still open I assume that means that the author
hasn’t decided what the correct remediation is yet.

> 
> That said, issuing *warnings* for discouraged-but-sometimes-allowed
> practices is a great idea.  A stricter warnings-are-errors *mode* is a
> good idea, especially for automated checkers, but it should be
> configurable for different policies.
> 
>> http://pep8.readthedocs.org/en/latest/intro.html#disclaimer
> 
> Disclaimers are for lawyers.  Other people assume names mean what they
> say.
> 
> 
> _______________________________________________
> Python-Dev mailing list
> Python-Dev at python.org
> https://mail.python.org/mailman/listinfo/python-dev
> Unsubscribe: https://mail.python.org/mailman/options/python-dev/donald%40stufft.io


-----------------
Donald Stufft
PGP: 0x6E3CBCE93372DCFA // 7C6B 7C5D 5E2B 6356 A926 F04F 6E3C BCE9 3372 DCFA

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 801 bytes
Desc: Message signed with OpenPGP using GPGMail
URL: <http://mail.python.org/pipermail/python-dev/attachments/20140426/bd00649a/attachment.sig>