Объектная природа модулей Python

Расширенные примеры работы с объектами модулей

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

Иногда требуется динамически выполнить код и представить его как модуль. Для этого можно использовать модуль importlib.util или напрямую создать объект ModuleType и выполнить в его пространстве имен код через exec.

import types

# Создаем объект модуля
mod = types.ModuleType('custom_calc', 'Модуль для динамических вычислений')

# Код для выполнения
code = '''
def add(a, b):
    return a + b

def multiply(a, b):
    return a * b

PI = 3.1416
'''

exec(code, mod.__dict__)

# Теперь используем атрибуты модуля
print(mod.add(5, 3))        # 8
print(mod.multiply(2, 11))  # 22
print(mod.PI)               # 3.1416

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

2. Перехват событий импорта - замена стандартного загрузчика

Объекты модулей можно подменять еще до того, как они попадут в sys.modules. Это реализуется через механизм import hooks или через sys.meta_path. В примере ниже показано, как заменить модуль при его первом импорте на собственную реализацию.

import sys
import types

class MyLoader:
    def load_module(self, fullname):
        if fullname == 'fake_math':
            # создаем поддельный модуль
            mod = types.ModuleType(fullname, 'Подмена модуля')
            mod.sqrt = lambda x: x ** 0.5
            mod.pi = 3.0
            sys.modules[fullname] = mod
            return mod
        raise ImportError

class MyFinder:
    def find_module(self, fullname, path=None):
        if fullname == 'fake_math':
            return MyLoader()
        return None

# Добавляем свой поисковик в начало цепочки
sys.meta_path.insert(0, MyFinder())

# Теперь импортируем 'fake_math' как обычный модуль
import fake_math
print(fake_math.sqrt(16))  # 4.0
print(fake_math.pi)        # 3.0

Результат работы:

4.0
3.0

3. Использование __path__ для пакетов

Для пакетов объект модуля содержит атрибут __path__ - список строк с путями, по которым производится поиск внутренних модулей. Можно динамически расширять этот список, добавляя пути из других каталогов.

# Допустим, есть пакет 'mypackage' в стандартном месте
import mypackage

# Добавляем дополнительную директорию для поиска подмодулей
mypackage.__path__.append('/extra/path')

# Теперь import mypackage.extra_module попытается найти файл по новому пути

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

4. Рефлексия модуля: перечисление всех атрибутов

Иногда нужно получить полный список имен, определенных в модуле. Для этого используется атрибут __dict__ или встроенная функция vars().

import string

# Получаем все имена из модуля
names = list(vars(string).keys())
print(names[:10])

Результат (может варьироваться):

['__name__', '__doc__', '__package__', '__loader__', '__spec__', '__path__', '__file__', '__cached__', 'ascii_letters', 'ascii_lowercase']

Атрибут __dict__ является обычным словарем, поэтому его можно изменять, добавляя или удаляя элементы.

5. Обнуление модуля - полная перезагрузка всех зависимостей (сложный пример)

Модуль importlib.reload обновляет только указанный модуль, но не его дочерние импорты. Для полной перезагрузки всех модулей, рекурсивно загруженных из заданного пакета, необходимо пройтись по sys.modules и перезагрузить подходящие модули.

import sys
import importlib

def deep_reload(package_name):
    """Перезагрузить все модули, принадлежащие пакету package_name"""
    # Собираем имена модулей, которые начинаются с package_name
    to_reload = [name for name in sys.modules if name.startswith(package_name + '.') or name == package_name]
    for mod_name in to_reload:
        mod = sys.modules.get(mod_name)
        if mod is not None:
            importlib.reload(mod)

# Пример использования после изменения кода пакета
import mypackage
mypackage.some_function()
deep_reload('mypackage')
mypackage.some_function()  # уже с обновленным кодом

Этот способ не идеален, так как объекты, созданные до перезагрузки, могут остаться ссылками на старые модули. Для production-среды рекомендуется избегать горячей перезагрузки и перезапускать процесс.