Организация кода с помощью модулей в языке Python

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

Иногда длинное имя модуля неудобно использовать. Можно задать псевдоним с помощью ключевого слова as.

import mymodule as mm
print(mm.say_hello("Пользователь"))

Такой подход часто применяется для библиотек с длинными именами, например import numpy as np.

Как импортировать только нужные функции из модуля?

Когда требуется использовать лишь часть функциональности, можно импортировать отдельные имена с помощью from ... import ... Это делает код более читаемым, так как не требует префикса модуля.

from mymodule import say_hello, PI
print(say_hello("Алиса"))
print(PI)

Однако следует быть осторожным: если импортированное имя совпадает с именем в текущем пространстве, произойдет перезапись.

Что будет при импорте from module import *?

Инструкция from module import * импортирует все имена из модуля, за исключением тех, что начинаются с подчеркивания. Для контроля этого поведения в модуле можно определить список __all__.

# mymodule.py (дополненный)
__all__ = ['say_hello', 'PI']  # только эти имена будут импортированы через *

from mymodule import *
print(say_hello("Боб"))
print(PI)

Без __all__ импортируются все неслужебные имена.

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

Пакет - это директория, содержащая файл __init__.py (может быть пустым) и другие модули. Пакеты позволяют создавать иерархическую структуру кода.

# Структура:
# mypackage/
#   __init__.py
#   math_utils.py
#   string_utils.py

# math_utils.py
def add(a, b):
    return a + b

# импорт из пакета
from mypackage import math_utils
print(math_utils.add(5, 3))

Файл __init__.py может содержать код инициализации пакета или определять __all__ для пакета.

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

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

# mypackage/math_utils.py
from . import string_utils  # импорт из текущего пакета
# или
from ..subpackage import something  # из родительского пакета

Относительные импорты удобны при рефакторинге, но не могут использоваться вне пакета (при запуске модуля как скрипта).

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

С помощью конструкции if __name__ == '__main__' можно определить блок, который выполняется только при запуске файла как основного скрипта.

# mymodule.py
def main():
    print("Модуль запущен как скрипт")

if __name__ == '__main__':
    main()

# При импорте mymodule не вызовет main()
import mymodule  # ничего не выведет

Это позволяет тестировать модуль отдельно и использовать его как библиотеку.

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

В Python 3 используется importlib.reload для принудительной перезагрузки уже импортированного модуля.

import mymodule
import importlib

# После внесения изменений в mymodule.py
importlib.reload(mymodule)

Это полезно в интерактивных средах или при длительных сессиях.

Как избежать циклического импорта?

Циклический импорт возникает, когда модуль A импортирует модуль B, а B импортирует A. Это может привести к ошибке ImportError или частичной инициализации.

# module_a.py
import module_b  # циклический импорт
def a_func():
    return module_b.b_func()

# module_b.py
import module_a
def b_func():
    return module_a.a_func()

Решения: перенести импорт внутрь функции (отложенный импорт), реструктурировать код, объединить модули или использовать общий модуль с общими данными.

# module_a.py (исправленный)
def a_func():
    from . import module_b  # отложенный импорт
    return module_b.b_func()