Поиск модулей в Python: sys.path, PYTHONPATH и альтернативные методы

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

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

1. Обход sys.path с помощью sys.meta_path и importlib.abc.MetaPathFinder

Можно создать собственный поисковик модулей, который не зависит от sys.path.

import sys
import importlib.abc
import importlib.machinery

class CustomFinder(importlib.abc.MetaPathFinder):
    def find_spec(self, fullname, path, target=None):
        if fullname.startswith('special_'):
            # Создаём spec для модуля из виртуального источника
            loader = importlib.machinery.SourceFileLoader(fullname, f'/tmp/{fullname}.py')
            return importlib.util.spec_from_loader(fullname, loader, origin='/tmp/')
        return None

# Регистрируем поисковик первым
sys.meta_path.insert(0, CustomFinder())

# Теперь можно импортировать модуль special_demo (если файл /tmp/special_demo.py существует)
import special_demo
print(special_demo.__file__)

/tmp/special_demo.py

Пояснение: MetaPathFinder позволяет перехватывать все запросы на импорт, что удобно для виртуальных файловых систем или шифрованных модулей.

2. Временное изменение PYTHONPATH внутри скрипта через os.environ

import os
import sys

# Сохраняем оригинальное значение
old_path = os.environ.get('PYTHONPATH', '')
# Добавляем новый путь
temp_path = '/tmp/additional_libs'
os.environ['PYTHONPATH'] = old_path + os.pathsep + temp_path

# Теперь можно перезагрузить sys.path (например, вызвав site.main())
import site
site.main()  # повторно инициализирует sys.path с учётом новой PYTHONPATH

print('Путь', temp_path, 'добавлен' if temp_path in sys.path else 'не добавлен')

# Восстанавливаем
os.environ['PYTHONPATH'] = old_path

Путь /tmp/additional_libs добавлен

Пояснение: Этот метод позволяет эмулировать изменение переменной окружения динамически. Вызов site.main() перестраивает sys.path на основе текущих переменных.

3. Загрузка модуля из ZIP-архива без распаковки

import sys
import zipimport

# Создаём ZIP-файл с модулем (вручную или через код)
import zipfile
with zipfile.ZipFile('/tmp/mymodules.zip', 'w') as zf:
    zf.writestr('utils/helper.py', 'def greet(): return "Hello from ZIP"')

# Добавляем ZIP-архив в sys.path
sys.path.insert(0, '/tmp/mymodules.zip')

# Импортируем модуль из архива
from utils import helper
print(helper.greet())

Hello from ZIP

Пояснение: Python поддерживает импорт из ZIP-файлов благодаря встроенному zipimporter. Архив воспринимается как обычный пакет, если внутри соблюдена правильная структура.

4. Использование .pth файла с дополнительным кодом (exec-строками)

# Содержимое файла extra_init.pth, помещённого в site-packages:
import sys; sys.path.insert(0, '/opt/secret_tools')
print("Загрузчик extra_init.pth выполнен")

# При запуске Python вывод:
# Загрузчик extra_init.pth выполнен
# И путь /opt/secret_tools будет добавлен первым.

Пояснение: Файлы .pth могут содержать не только пути, но и произвольный Python-код. Это мощный, но опасный механизм, так как код выполняется с привилегиями процесса.

5. Анализ sys.path с учётом импорта модуля из другого места

import sys, importlib

# Сначала импортируем стандартный модуль
import json
print('Первоначальное расположение json:', json.__file__)

# Подменим путь к другому файлу через sys.path.insert
sys.path.insert(0, '/tmp/fake')

# Теперь попробуем импортировать json снова (Python уже закешировал модуль, нужен перезагруз)
import importlib
importlib.reload(json)  # не перезагрузит с нового пути, т.к. модуль уже загружен

# Если удалить модуль из sys.modules
if 'json' in sys.modules:
    del sys.modules['json']

# Импорт из нового места
import json as json2
print('Новое расположение json2:', json2.__file__)

Первоначальное расположение json: /usr/lib/python3.10/json/__init__.py
Новое расположение json2: /tmp/fake/json/__init__.py (если там есть такой файл)

Пояснение: После удаления модуля из sys.modules новый импорт будет искать модуль снова, и приоритет получит путь, который стоит раньше в sys.path.