Готовый перевод Style Guide for Python Code: Imports

Импорт модулей должен быть, как правило, на отдельных строках, например:

Правильно:
import os
import sys

Неправильно:
import sys, os

при этом можно писать так:
from subprocess import Popen, PIPE

Всегда размещайте импорт модулей в начале файла, сразу после комментариев и строк документации модуля, и перед глобальными переменными и константами модуля.

Импортирования должны быть сгруппированы в следующем порядке:
1. модули стандартной библиотеки
2. модули сторонних поставщиков
3. локальные модули относящиеся к приложению/библиотеке

Вы должны разделять каждую группу импортирования пустой строкой.

Разместите соответствующую спецификацию переменной __all__ после блока импортирований.

Относительные импортирования для внутри-пакетных модулей озадачивают.

Всегда используйте абсолютные пути в пакетах для импортирований.

Даже сейчас когда PEP 328 полностью реализовано в Python 2.5, его стиль явных относительных импортов сбивает с толку. Абсолютные импортирования более переносимы и обычно более читаемы.

При импортировании класса из модуля можно использовать следующую конструкцию:
from myclass import MyClass
from foo.bar.yourclass import YourClass

Если же такое написание вызывает локальные конфликты, тогда используйте:
import myclass
import foo.bar.yourclass
и обращайтесь к классам как "myclass.MyClass" и "foo.bar.yourclass.YourClass"

Переведено на Нотабеноиде
http://notabenoid.org/book/1336/5347

Переводчики: Guria

Настройки

Готово:

100.00% КП = 1.0