블록 주석에서 80 자 이상의 URL을 참조하고 싶습니다.
이 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
답변
다음과 같이 Google과 같은 URL 단축기를 사용합니다.
http://www.python.org/dev/peps/pep-0008/#a-foolish-consistency-is-the-hobgoblin-of-little-minds
당신은 얻는다 :
답변
내 옵션은 다음과 같습니다.
URL = ('http://stackoverflow.com/questions/10739843/'
'how-should-i-format-a-long-url-in-a-python-'
'comment-and-still-be-pep8-compliant')