extremecodetv / pepega

Правильный PEP для Python

PEPEGA

Правильный PEP для Python.

Этот документ описывает соглашение о том, как писать код для языка Python

PEPEGA создан на основе PEP8 и рекомендациях ExtremeCode с добавлениями от Сообщества.

Оглавление

1. Внешний вид кода

   1.2. Табуляция или пробелы?

   1.3. Отступы

   1.4. Импорты

Внешний вид кода

Табуляция или пробелы?

Табуляция предпочтительна в 9 из 10-и случаев. Пробелы допускаются при поддержке стороннего кода.

Отступы

Используйте случайное, в зависимости от ситуации, число пробелов на каждый уровень отступа. Главный принцип руководства - как удобнее, так и делай.

Правильно

    foo = long_function_name(var_one, var_two,
                         var_three, var_four)

def long_function_name(
 var_one, var_two, var_three,
                            var_four):
  print(var_one)

Неправильно

foo = long_function_name(var_one, var_two,
                         var_three, var_four)

def long_function_name(
        var_one, var_two, var_three,
        var_four):
    print(var_one)

Импорты

Необходимо экономить ГОРИЗОНТАЛЬНОЕ место на мониторе, поэтому умещаем все импорты в одну строку

Правильно

import sys, os

Неправильно

import os
import sys

• Импорты нужно размещать в местах перед непосредственным использования модуля.
• Группировать импорты нет смысла
• Рекомендуется использовать шаблоны импортов

from import *