Способы подключения Python кода: инструкция для разработчиков

Как импортировать модуль из того же пакета?

Для импорта внутри пакета применяются относительные импорты: from . import sibling или from .sibling import name. Точка обозначает текущий пакет, две точки - родительский и так далее.

# Структура:
# mypackage/
#   __init__.py
#   module_a.py
#   subpackage/
#       __init__.py
#       module_b.py

# В module_b.py:
from .. import module_a
from . import sibling  # если есть sibling в том же пакете

ошибка импорта python (ошибка импорта модуля в python)

Цель - поддержание чёткой иерархии и избежание жёсткой привязки к абсолютным именам. Используется в больших проектах с пакетами.

Как импортировать модуль по имени строки?

Динамический импорт выполняется с помощью функции importlib.import_module(name). Имя передаётся как строка, что позволяет выбирать модуль на основе конфигурации или пользовательского ввода.

import importlib

module_name = 'math'
try:
    module = importlib.import_module(module_name)
    print(module.sqrt(9))
except ImportError:
    print('Модуль не найден')

Python package init py (инициализация пакета с __init__.py)

Цель - плагины, модули, подгружаемые во время выполнения. Подходит для систем с расширениями.

Как обновить импортированный модуль без перезапуска?

Для перезагрузки уже импортированного модуля используется importlib.reload(module). Она повторно выполняет код модуля, обновляя его пространство имён.

import importlib
import mymodule

# после изменения mymodule.py
importlib.reload(mymodule)
print(mymodule.some_function())

Python создание модулей (создание модулей в python)

Цель - интерактивная разработка, обновление конфигураций на лету. Однако не обновляет ссылки на объекты, созданные до reload, и может вызвать побочные эффекты.

Как импортировать модуль из zip‑архива?

Можно добавить путь к zip‑файлу в sys.path и импортировать модули, содержащиеся в нём. Python автоматически читает архив.

import sys
sys.path.append('myarchive.zip')
import mymodule_from_zip
print(mymodule_from_zip.hello())

Python init file (файл __init__.py в python)

Цель - распространение кода как архива, экономия места, защита исходников (сложность).

Как импортировать все публичные имена из модуля?

Инструкция from module import * импортирует все имена, перечисленные в списке __all__ внутри модуля. Если __all__ не задан, импортируются все имена, не начинающиеся с подчёркивания.

# В модуле mymodule.py:
__all__ = ['func1', 'CONSTANT']
def func1(): pass
def _private(): pass
CONSTANT = 42

# В другом файле:
from mymodule import *
print(func1())      # работает
print(CONSTANT)     # работает
print(_private)     # NameError

Цель - быстрый доступ к основным функциям, но загрязняет пространство имён. Использовать осторожно, лучше импортировать конкретные имена.

Как избежать конфликта имён при импорте?

Ключевое слово as позволяет присвоить импортируемому объекту псевдоним. Это полезно при совпадении имён или для сокращения длинных названий.

from collections import OrderedDict as OD
from mymodule import function as my_func

od = OD()
my_func()

Цель - читаемость, избежание конфликтов, соответствие стилю кода.

Как импортировать подмодуль из пакета?

Подмодули импортируются через точку: import package.submodule или from package import submodule. В первом случае обращение package.submodule.name, во втором - submodule.name.

import os.path
from xml.etree import ElementTree

print(os.path.join('a', 'b'))
root = ElementTree.Element('root')

Цель - работа с иерархическими пакетами (stdlib, собственные). Подходит для чёткой организации.