파이썬 및 장고 코딩 스타일 (PEP)

Question

저는 Django 프레임 워크를 사용하여 파이썬으로 코드를 작성합니다. 이제 모든 코딩 스타일에 대한 조언을 읽었지만 막연한 문제가 발생했습니다.

, 즉를 반환합니까 : djangoproject 섹션에서

여기 https://docs.djangoproject.com/en/dev/internals/contributing/writing-code/coding-style/#python-style이 기능 코멘트처럼 말을해야한다고 말한다.

이

는, 그것을 돌려 마십시오

그러나, 여기 http://www.python.org/dev/peps/pep-0257/#one-line-docstrings 그것은 같은 말을해야한다고 말한다.

그래서, 어떤 옵션은 사실이다?

Answer 1

PEP 8은 1 인칭 단수를 따릅니다. Django 문서 표준은 제 3 자 단수를 따릅니다. 전자는 표준입니다.

Answer 2

는 더 진정한 코드 스타일 규칙이 없습니다. 모든 프레임 워크, 라이브러리 및 소프트웨어는 자체 프로젝트에 대한 스타일 규칙을 재정의 할 수 있습니다. 내 개인적인 코드에서

나는 (이 경우 공식 파이썬을) 더 일반적인 코드 스타일 규칙을 사용하는 것을 선호하지만 당신은 문서에이를 지정해야합니다.