Как мне отформатировать длинный URL-адрес в комментарии Python и по-прежнему соответствовать PEP8

В комментарии к блоку я хочу сослаться на URL длиной более 80 символов.

Каково предпочтительное соглашение для отображения этого URL-адреса?

Я знаю, что bit.ly - это вариант, но сам URL носит описательный характер. Сокращение его, а затем наличие вложенного комментария, описывающего сокращенный URL-адрес, кажется паршивым решением.

Не нарушайте URL:

# A Foolish Consistency is the Hobgoblin of Little Minds [1]
# [1]: http://www.python.org/dev/peps/pep-0008/#a-foolish-consistency-is-the-hobgoblin-of-little-minds

Из PEP8

Но самое главное: знайте, когда нужно быть непоследовательным - иногда руководство по стилю просто неприменимо. В случае сомнений используйте здравый смысл. Посмотрите другие примеры и решите, что выглядит лучше всего. И не стесняйтесь спрашивать!

Две веские причины нарушить то или иное правило:

• Применение правила сделает код менее читаемым даже для тех, кто привык читать код, который следует правилам.

Лично я бы воспользовался этим советом и оставил бы для людей полный описательный URL-адрес в вашем комментарии.

Вы можете использовать # noqaсимвол в конце строки, чтобы PEP8 / Flake8 не запускал эту проверку. Это разрешено PEP8 через:

Особых случаев недостаточно, чтобы нарушать правила.

Я бы сказал, оставь это ...

PEP20 :

Особых случаев недостаточно, чтобы нарушать правила.

Хотя практичность лучше чистоты.

Более практично иметь возможность быстро скопировать / вставить URL-адрес, чем удалять разрывы строк при вставке в браузер.

Если вы используете flake8:

"""
long-url: http://stackoverflow.com/questions/10739843/how-should-i-format-a-long-url-in-a-python-comment-and-still-be-pep8-compliant
"""  # noqa

Вы используете сокращение URL-адресов, например Google, поэтому из этого:

http://www.python.org/dev/peps/pep-0008/#a-foolish-consistency-is-the-hobgoblin-of-little-minds

Вы получаете:

http://goo.gl/93ZLQ

Мой вариант:

URL = ('http://stackoverflow.com/questions/10739843/'
       'how-should-i-format-a-long-url-in-a-python-'
       'comment-and-still-be-pep8-compliant')