Импорты в Python: модули, from и as
Обновлено:
В Python существует большое количество готовых модулей и библиотек, которые позволяют использовать уже написанный код.
Например:
random— работа со случайными числами;math— математические функции и константы;time— работа со временем;copy— копирование объектов.
Все эти модули входят в стандартную библиотеку Python.
Также существуют сторонние библиотеки, например numpy и requests, которые устанавливаются отдельно.
В этой теме научимся импортировать модули и отдельные объекты из них. Сами библиотеки подробно будем изучать позже.
1. Ключевое слово import
Ключевое слово:
import
позволяет использовать код из другого модуля.
В Python есть два основных способа импорта:
import module
и:
from module import name
Они отличаются прежде всего тем, какие имена становятся доступными в нашей программе.
2. Импорт отдельной функции
Предположим, нам нужна функция:
randint()
из модуля:
random
Мы уже знакомы с этой функцией: она возвращает случайное целое число из заданного диапазона, включая обе границы.
Импортируем её:
from random import randint
Теперь можно вызвать:
print(randint(1, 10))
Например, получим:
7
Конкретное число будет случайным.
Обратите внимание: после такого импорта функция вызывается напрямую:
randint(1, 10)
Название модуля перед ней писать не требуется.
3. Что произошло при импорте
Когда мы пишем:
from random import randint
в текущей области видимости появляется имя:
randint
которое ссылается на импортированный объект.
Если импорт выполнен на уровне файла, это имя находится в глобальной области видимости модуля.
Можем проверить с помощью уже знакомой функции:
dir()
Например:
from random import randint
print('randint' in dir())
Результат:
True
Можно и просто вывести содержимое:
print(dir())
Среди множества других имён мы увидим:
'randint'
При этом сам модуль random не обязательно появляется как отдельное имя в нашей глобальной области видимости.
Мы импортировали из него конкретный объект.
4. Импорт нескольких объектов
Из одного модуля можно импортировать сразу несколько объектов.
Для этого перечисляем их через запятую:
from random import choices, randint
Теперь доступны обе функции:
randint()
choices()
Например:
from random import choices, randint
number = randint(1, 10)
colors = choices(
['red', 'green', 'blue'],
k=2,
)
print(number)
print(colors)
Функция choices() выбирает указанное количество случайных элементов из коллекции и возвращает список. Один и тот же элемент может быть выбран несколько раз.
Проверим имена:
print('randint' in dir())
# True
print('choices' in dir())
# True
Через from ... import ... можно импортировать не только функции, но также классы, переменные и другие доступные объекты модуля.
5. Псевдонимы через as
Иногда импортированному объекту удобно дать другое имя.
Для этого используется:
as
Например:
from random import randint as random_integer
Теперь функцию можно вызвать так:
print(
random_integer(1, 10)
)
Мы создали псевдоним:
random_integer
для импортированного объекта.
В новой программе, где ранее не импортировалась randint, в глобальной области видимости появится именно:
random_integer
а отдельного имени randint не будет.
Важно: если раньше в том же сеансе Python мы уже импортировали randint, то старое имя останется. Использование as не удаляет ранее созданные переменные.
6. Несколько псевдонимов
Можно дать псевдоним только одному импортируемому объекту:
from random import choices, randint as random_integer
Тогда будут доступны:
choices
random_integer
А можно сразу обоим:
from random import (
choices as select_colors,
randint as random_integer,
)
Теперь доступны:
select_colors()
random_integer()
Ключевое слово as не изменяет сам импортированный объект. Оно определяет имя, через которое мы будем к нему обращаться.
Импорт целого модуля
7. Конструкция import math
Теперь рассмотрим второй способ:
import math
В отличие от:
from math import factorial
мы импортируем сам модуль как объект.
Например:
import math
print('math' in dir())
Результат:
True
Теперь в нашей области видимости есть имя:
math
Оно ссылается на объект модуля.
8. Модуль — отдельный тип объекта
Проверим:
import math
print(type(math))
Результат:
<class 'module'>
Таким образом, модуль в Python — тоже объект.
У него есть собственные имена, через которые можно получать доступ к функциям, классам, константам и другим объектам.
9. Доступ через точку
После:
import math
можно обратиться к математической константе:
print(math.pi)
Получим приближённое значение числа π:
3.141592653589793
Или вызвать функцию вычисления факториала:
print(
math.factorial(5)
)
Результат:
120
Здесь:
math.pi
означает:
Получить объект
piиз модуляmath.
А:
math.factorial
означает:
Получить функцию
factorialиз модуляmath.
После обычного import math необходимо обращаться к этим именам через модуль:
math.pi
math.factorial(5)
Просто:
pi
или:
factorial(5)
в новой программе вызовут NameError, если эти имена не были определены или импортированы отдельно.
10. Сравним два способа импорта
Первый:
from math import factorial, pi
print(pi)
print(factorial(5))
Мы получили отдельные имена:
factorial
pi
Второй:
import math
print(math.pi)
print(math.factorial(5))
Здесь мы обращаемся через имя модуля:
math
Оба способа корректны.
Разница прежде всего заключается в организации имён и удобстве чтения кода.
11. Псевдоним для целого модуля
Ключевое слово as можно использовать и при импорте модуля.
Например:
import math as mathematics
Теперь:
print(mathematics.pi)
работает.
Псевдоним можно выбрать самостоятельно.
12. Общепринятые псевдонимы
У некоторых популярных библиотек существуют устоявшиеся сокращения.
Например, библиотеку NumPy обычно импортируют так:
import numpy as np
После этого обращаются через:
np
Например:
np.array([10, 20, 30])
numpy не входит в стандартную библиотеку Python и устанавливается отдельно.
Поэтому такой импорт сработает только в той среде, где NumPy уже установлена.
Если библиотека отсутствует, может возникнуть:
ModuleNotFoundError
Установка сторонних библиотек будет отдельной темой.
Для NumPy псевдоним:
np
является общепринятым соглашением. Но далеко не у каждого модуля есть подобное стандартное сокращение.
13. Длинные импорты
Иногда из одного модуля нужно импортировать много объектов.
Например, из:
collections.abc
Это часть стандартной библиотеки Python.
Там находятся различные классы, связанные с интерфейсами коллекций. Подробно их изучим позже.
Можно написать:
from collections.abc import Callable, Hashable, Iterable, Mapping, Sequence
Но строка может оказаться слишком длинной, особенно если объектов ещё больше.
Для удобного переноса используют круглые скобки.
14. Перенос импорта на несколько строк
from collections.abc import (
Callable,
Hashable,
Iterable,
Mapping,
Sequence,
)
Каждое имя располагается на отдельной строке.
Такой вариант удобно:
- читать;
- дополнять новыми импортами;
- редактировать;
- автоматически сортировать.
Последняя запятая после Sequence допустима и удобна для дальнейшего расширения списка импортов.
15. Длина строк по PEP 8
Официальный стиль Python, PEP 8, рекомендует ограничивать длину обычных строк кода 79 символами.
Для комментариев и документационных строк рекомендуется 72 символа.
Некоторые проекты используют другие согласованные ограничения, например 88 или 99 символов.
Но базовая рекомендация PEP 8:
79 символов
Поэтому длинные импорты удобно переносить внутрь круглых скобок.
Импорт через звёздочку
16. Конструкция from module import *
Python позволяет написать:
from math import *
Такая конструкция импортирует множество имён, предоставляемых модулем для подобного импорта.
Например, после неё становятся доступны:
pi
factorial
sqrt
sin
cos
и другие имена из math.
Можно проверить:
from math import *
print('pi' in dir())
print('factorial' in dir())
print('sqrt' in dir())
Результат:
True
True
True
17. Почему import * не рекомендуется
После:
from math import *
в нашей области видимости появляется большое количество имён.
Даже если нам нужна только:
sqrt()
мы импортировали множество других имён, которые могут вообще не использоваться.
Из-за этого становится сложнее понять:
- откуда появилось конкретное имя;
- какие объекты доступны в программе;
- не было ли какое-то существующее имя перезаписано.
Например:
pi = 'Какая-то строка'
from math import *
print(pi)
Теперь pi будет ссылаться на математическую константу из модуля math, а не на ранее созданную строку.
Подобные совпадения имён могут приводить к неожиданному поведению программы.
18. Что говорит PEP 8
PEP 8 рекомендует избегать импортов вида:
from module import *
Такая запись затрудняет понимание того, какие имена присутствуют в программе.
В некоторых специальных случаях подобный импорт всё же используется — например, при формировании публичного интерфейса библиотеки.
Эти ситуации относятся к более сложным темам и пока нам не нужны.
В обычном коде используем:
import math
или:
from math import pi
вместо:
from math import *
Правила оформления импортов — PEP 8
19. Импорты располагаются в начале файла
Обычно импорты записываются в верхней части Python-файла, после возможных комментариев и документации модуля.
Например:
import math
import random
def calculate_circle_area(radius):
return math.pi * radius ** 2
В начале мы указываем зависимости программы, а затем пишем основной код.
Это позволяет сразу увидеть, какие модули использует файл.
20. Разные модули импортируем на отдельных строках
Технически Python разрешает:
import math, random
Но PEP 8 рекомендует:
import math
import random
То есть каждый импортируемый модуль записываем на отдельной строке.
При этом для нескольких объектов из одного модуля запись:
from random import choices, randint
совершенно допустима.
Разница:
import math, random
— импорт двух разных модулей через запятую; такой стиль не рекомендуется.
from random import choices, randint
— импорт нескольких объектов из одного модуля; такой стиль разрешён.
21. Три группы импортов
PEP 8 рекомендует разбивать импорты на три основные группы.
Первая группа — стандартная библиотека Python.
Например:
import math
import random
Вторая группа — сторонние установленные библиотеки.
Например:
import numpy as np
import requests
Третья группа — собственные модули проекта.
Например:
from helpers import format_output
Здесь предполагается, что в нашем проекте существует собственный файл helpers.py с функцией format_output.
22. Между группами оставляем пустую строку
В итоге импорты могут выглядеть так:
import math
import random
from collections.abc import Iterable
import numpy as np
import requests
from helpers import format_output
Это пример организации импортов в проекте, где установлены NumPy и Requests и существует собственный модуль helpers.
Обратите внимание на пустые строки между группами.
Они помогают визуально отделять:
- стандартную библиотеку;
- сторонние зависимости;
- собственный код проекта.
Это одна из прямых рекомендаций PEP 8.
23. Алфавитный порядок
В Python-проектах импорты часто сортируют по алфавиту.
Например:
import math
import random
import time
А не в случайном порядке:
import time
import math
import random
То же самое при импорте нескольких объектов:
from collections.abc import (
Callable,
Hashable,
Iterable,
Mapping,
Sequence,
)
Такую сортировку удобно поддерживать автоматически.
Важный нюанс: PEP 8 прямо определяет порядок трёх групп импортов и рекомендует отдельные строки для разных модулей, но не устанавливает обязательную алфавитную сортировку каждого имени внутри группы.
Алфавитный порядок — распространённое соглашение в реальных проектах.
24. Что писать первым: import или from?
Оба варианта синтаксически допустимы.
Например:
import math
from random import randint
И:
from random import randint
import math
Однако многие инструменты сортировки импортов по умолчанию размещают обычные import перед from ... import ... внутри одной группы.
Например:
import math
import random
from collections.abc import Iterable
from functools import reduce
Такой порядок удобен и широко распространён.
PEP 8 не требует единственного обязательного порядка между этими двумя формами.
На практике важно соблюдать единый стиль проекта.
25. Автоматическая сортировка
В профессиональной разработке необязательно каждый импорт сортировать вручную.
Для этого существуют специальные инструменты.
Например:
isort
или инструменты проверки и форматирования кода, такие как Ruff.
Они могут:
- сортировать импорты;
- группировать их;
- находить повторяющиеся импорты;
- обнаруживать некоторые лишние импорты.
Подобные инструменты можно подключать к редакторам, включая Visual Studio Code.
26. Неиспользуемые импорты
Предположим:
import math
import random
number = random.randint(1, 10)
print(number)
Здесь модуль:
math
нигде не используется.
Лучше удалить лишний импорт:
import random
number = random.randint(1, 10)
print(number)
Неиспользуемые импорты:
- засоряют код;
- могут выполнять ненужную работу при загрузке модуля;
- могут создавать ненужные зависимости;
- мешают понимать, какие библиотеки действительно необходимы.
IDE и линтеры часто предупреждают о таких ситуациях.
Что лучше: from ... import ... или import ...?
27. Сравним два варианта
Первый:
from random import randint
number = randint(1, 10)
Второй:
import random
number = random.randint(1, 10)
Оба варианта корректны.
Но существует распространённое заблуждение, что первый способ обязательно значительно экономит оперативную память, поскольку импортируется только одна функция.
Разберём, как это работает.
28. При from модуль тоже загружается
Когда мы пишем:
from random import randint
Python не извлекает одну функцию из файла, полностью игнорируя остальное содержимое модуля.
Если модуль ещё не загружен, Python сначала находит и инициализирует его.
Во время инициализации выполняется код, находящийся на уровне модуля.
Например, если в модуле определены функции:
def first():
...
def second():
...
def third():
...
при выполнении их определений создаются соответствующие объекты функций.
При этом тела самих функций не выполняются, пока эти функции не будут вызваны.
После инициализации модуля Python получает нужный нам объект:
randint
и связывает его с именем в нашей программе.
29. Обычный import тоже загружает модуль
При:
import random
модуль аналогично загружается и инициализируется, если этого ещё не произошло.
Но теперь в нашей области видимости создаётся ссылка на сам модуль:
random
И мы обращаемся к его содержимому через точку:
random.randint(1, 10)
Упрощённо разница выглядит так:
from random import randint
↓
загрузка модуля random
↓
имя randint → объект из random
И:
import random
↓
загрузка модуля random
↓
имя random → объект модуля
↓
random.randint
30. Python не загружает один и тот же модуль заново при каждом импорте
В Python существует механизм кеширования загруженных модулей.
Обычно после первой загрузки модуль сохраняется в специальном словаре:
sys.modules
При последующем импорте Python использует уже загруженный модуль.
Например:
import math
import math
не означает, что модуль обязательно будет полностью выполнен два раза.
Как правило, повторный импорт использует уже существующий объект модуля.
Подробности работы системы импортов мы изучим позже.
31. Какой способ выбирать?
При выборе между:
from math import factorial
и:
import math
не стоит исходить из предположения, что from загружает лишь маленькую часть модуля.
В обоих случаях происходит обычная загрузка и инициализация модуля, если он ещё не загружен.
Небольшие различия производительности при последующих обращениях к именам возможны, но обычно они не являются причиной выбирать тот или иной стиль.
Главные критерии:
- читаемость;
- отсутствие конфликтов имён;
- общепринятый стиль библиотеки;
- единообразие внутри проекта.
Например:
import math
print(math.factorial(5))
print(math.pi)
хорошо показывает, откуда берутся используемые объекты.
А:
from random import randint
print(randint(1, 10))
удобен, когда нужна одна конкретная функция и её происхождение уже понятно.
Главное по теме
В Python существуют два основных способа импорта.
Импорт отдельных объектов:
from random import randint
Теперь вызываем:
randint(1, 10)
Импорт модуля:
import random
Теперь вызываем:
random.randint(1, 10)
Можно импортировать несколько объектов:
from random import choices, randint
Давать псевдонимы:
from random import randint as random_integer
Или переименовать модуль:
import numpy as np
Для длинных импортов используем круглые скобки:
from collections.abc import (
Callable,
Hashable,
Iterable,
Mapping,
Sequence,
)
По PEP 8:
- импорты обычно размещаются в начале файла;
- разные модули импортируются на отдельных строках;
- импорты разделяются на стандартные, сторонние и собственные;
- между этими группами оставляется пустая строка;
- рекомендуется избегать
from module import *; - стандартное ограничение длины строки — 79 символов.
Алфавитная сортировка также является распространённой практикой и часто выполняется автоматически.
Оба способа:
from random import randint
и:
import random
при необходимости загружают соответствующий модуль.
Поэтому выбирать способ импорта следует прежде всего по удобству и читаемости кода, а не по предположению, что from позволяет не загружать остальной модуль.