Модули, пакеты и ленивые импорты в Python 3.15 (PEP 810)

Команда --help, которая думает полсекунды

• Замер на python:3.15-slim, медиана 10 запусков
• import pandas: ~415 мс
• lazy import pandas: ~13 мс
• В статье CodeCut: 280 → 14 мс

Наш трекер обзавёлся отчётами на pandas. И вот вы просите у него обычную справку по командам — а он думает почти полсекунды. Справке pandas не нужен, но импорт стоит наверху файла, и Python грузит библиотеку целиком до первой строчки вашего кода. Мы замерили на чистом Python 3.15: четыреста пятнадцать миллисекунд с обычным импортом и тринадцать с ленивым. Чтобы понять, откуда такая разница, начнём с того, как вообще работает import.

# eager.py
import pandas as pd
print("hello")

# lazy.py — Python 3.15
lazy import pandas as pd
print("hello")

Модуль — это просто файл .py

• Модуль = файл; имя модуля = имя файла без .py
• import categories — весь модуль
• from categories import guess — одно имя
• import x as y — псевдоним

Модуль в Python — это обычный файл с кодом. Никакой магии: положили функции угадывания категории в отдельный файл — и можете подключить их из главного скрипта словом import. Можно взять модуль целиком и обращаться к функциям через точку, а можно вытащить одно конкретное имя. Псевдоним через as сокращает длинные имена — отсюда привычные всем сокращения вроде pd для pandas. Главное — не называйте свои файлы как стандартные модули.

# categories.py
KEYWORDS = {"такси": "Транспорт", "кофе": "Еда"}

def guess(item: str) -> str:
    return KEYWORDS.get(item.lower(), "Прочее")

# main.py
import categories
from categories import guess

print(categories.guess("Такси"), guess("Кофе"))

Что делает import на самом деле

• 1. Ищет модуль в sys.modules (кэш)
• 2. Ищет файл по sys.path
• 3. Выполняет файл целиком сверху вниз
• 4. Кладёт объект модуля в кэш

Представьте библиотекаря. Вы просите книгу — он сначала смотрит на свою стойку: не выдавал ли её уже? Если выдавал, отдаёт тот же экземпляр. Это кэш модулей. Если нет — идёт по полкам в определённом порядке: папка скрипта, стандартная библиотека, установленные пакеты. Нашёл файл — и, внимание, выполняет его целиком, от первой строки до последней. Вот почему тяжёлый модуль тормозит: библиотекарь читает всю книгу, прежде чем отдать.