[Tutor] Inserting long URL's into comments & docstrings?

Roel Schroeven roel at roelschroeven.net
Mon Jul 29 18:38:30 EDT 2019


James Hartley schreef op 29/07/2019 om 22:36:
> On occasion, I put long URL's into comments/docstrings simply to document
> where I found specific information.  However, to be a good disciple of
> PEP8, anything which can't fit within 72 characters needs to be split
> across multiple lines.  Since a number of you seem to be prolific Python
> coders, what opinion do you have about splitting URL's in
> comments/docstrings?
In my opinion this is one of the cases where this quote from PEP 8 applies:

"However, know when to be inconsistent -- sometimes style guide 
recommendations just aren't applicable. When in doubt, use your best 
judgment."

My preference would be not to split the URLs. The reader doesn't need to 
see the whole URL to understand the structure of the code; the full URL 
is really only needed to copy/paste it into a browser.

-- 
"Honest criticism is hard to take, particularly from a relative, a
friend, an acquaintance, or a stranger."
         -- Franklin P. Jones

Roel Schroeven



More information about the Tutor mailing list