Python 코드 사양

高洛峰
高洛峰원래의
2017-03-12 10:25:301631검색

1: 배경

은 OCP python 개발을 표준화하고, Python을 사용하여 개발된 프로그램에 대해 통일된 스타일을 사용하여 코딩

2: python 스타일 사양

  • 유지 관리 점 기호: 줄 끝에 세미콜론을 추가하지 말고, 같은 줄에 두 개의 명령을 입력하기 위해 세미콜론을 사용하지 마세요.

  • 괄호: 대괄호를 과도하게 사용하지 말고 아껴서 사용하세요. 행 연결을 구현하는 데 사용되지 않는 한, 반환 문이나 조건문에 괄호를 사용하지 마십시오. 단, 튜플 주위의 괄호는 허용됩니다.

  • 들여쓰기: 들여쓰기 코드 대신 공백 4개를 사용하세요. 탭을 사용하거나 탭과 공백을 혼합하지 마십시오. 줄 연결의 경우 줄 바꿈된 요소를 수직으로 정렬하거나 4칸 들여쓰기를 사용해야 합니다(이 경우 첫 번째 줄에는 매개 변수가 없어야 함)

  • 빈 줄:빈 줄 두 개 함수 또는 클래스 정의와 같은 최상위 정의 사이. 메소드 정의, 클래스 정의 및 첫 번째 메소드 사이에는 빈 줄이 있어야 합니다. 함수나 메소드에서 어떤 곳에 적합하다고 생각되면 빈 줄을 남겨주세요

  • 공백 : 표준 서식 관례에 따라 구두점 양쪽에 공백을 사용합니다. 괄호 안에는 공백이 있어서는 안 됩니다. 쉼표, 세미콜론, 콜론 앞에는 공백을 추가하지 마세요. 하지만 그 뒤에는 공백을 추가해야 합니다(줄 끝 제외). 인덱스 또는 슬라이스의 여는 괄호 ; 할당(=), 비교(==, <, >, !=, <와 같은 이진 연산자 양쪽에 공백을 추가합니다. ;>, <=, > =, in, not in, is, is not), 부울(and, or, not). 산술 연산자의 양쪽 공백을 어떻게 사용하는지는 사용자가 스스로 판단해야 합니다. 그러나 양쪽은 일관성이 있어야 합니다. '='를 사용하여 키워드 매개변수 또는 기본 매개변수 값을 표시하는 경우 양쪽에 공백을 사용하여 여러 줄 사이의 표시를 수직으로 정렬하지 마십시오. 유지 관리 문제 부담(적용 대상:, #, = 등)

  • 클래스: 클래스가 다른 클래스에서 상속하지 않는 경우 , 객체 클래스 상속

  • 문자열 에서 표시됩니다. 매개변수가 모두 문자열인 경우에도 % 연산자 또는 형식을 사용합니다. 문자 문자열 의 형식을 지정하려면 메서드를 사용하세요. + 메서드

  • 가져오기 메서드를 사용하지 마세요. 각 가져오기에는 자체 줄이 있습니다. 가져오기는 항상 파일 상단, 모듈 주석 및 독스트링 뒤, 모듈 전역 변수 상수 앞에 배치되어야 합니다. 가져오기는 가장 일반적인 것부터 가장 덜 일반적인 것 순으로 이루어져야 합니다. 그룹: 표준 라이브러리 가져오기, 응용 프로그램프로그램 지정 가져오기; 각 모듈 패키지 경로는 대소문자

  • 문을 무시하고 사전순으로 정렬됩니다. 일반적으로 각 문은 한 줄에 있어야 합니다. 테스트 결과와 테스트 문이 한 줄에 들어갈 경우 같은 줄에 배치할 수 있습니다. if 문의 경우 else가 없는 경우에만 수행할 수 있습니다. 특히, try와 Except는 같은 줄에 있을 수 없으므로 try/Exception에서는 이 작업을 수행하지 마십시오.

  • 다른 점은 추후 추가됩니다

    세 가지: 요구 사항:

  • 코드를 수정한 후에는 먼저 pylint를 실행한 다음 검토를 시작해야 합니다. pylint 점수는 90 이상으로 제어되어야 합니다. 일부 명백한 불규칙성을 수정해야 합니다

pylint 사용법: obztools 디렉터리 file

  • 에서 tools/pylint.sh 실행 4: 참조:
    • PEP 8 – 스타일 가이드 Python 코드: http://legacy.python.org/dev/peps/pep-0008/

    • Python 코딩 스타일 가이드 중국어 번역(Google SOC): http://www.elias.cn/Python/PythonStyleGuide?from= Development .PythonStyleGuide

위 내용은 Python 코드 사양의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!

성명:
본 글의 내용은 네티즌들의 자발적인 기여로 작성되었으며, 저작권은 원저작자에게 있습니다. 본 사이트는 이에 상응하는 법적 책임을 지지 않습니다. 표절이나 침해가 의심되는 콘텐츠를 발견한 경우 admin@php.cn으로 문의하세요.