Импорты в 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.

Обратите внимание на пустые строки между группами.

Они помогают визуально отделять:

  1. стандартную библиотеку;
  2. сторонние зависимости;
  3. собственный код проекта.

Это одна из прямых рекомендаций 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 позволяет не загружать остальной модуль.