multi-env-employer 1.0.0

Библиотека для вызова функций и генераторов из Python-модулей, расположенных в других виртуальных окружениях, включая окружения с разными версиями Python и конфликтующими зависимостями.

       

MultiEnvEmployer

MultiEnvEmployer — Python-библиотека для вызова функций и генераторов из Python-модулей, расположенных в других virtualenv, включая окружения с разными версиями Python и конфликтующими зависимостями.

Библиотека предназначена для ситуаций, когда код нельзя импортировать напрямую, но его необходимо вызывать и контролировать из одного основного процесса.

---

Основные возможности

• запуск Python-кода в изолированных virtualenv
• поддержка разных версий Python
• вызов функций как обычных Python-функций
• передача данных между процессами
• поддержка return, yield и потокового возврата больших данных
• перехват print() без нарушения IPC
• контроль времени выполнения (таймауты)
• обработка ошибок как обычных исключений
• файловое кэширование результатов

---

Установка

pip install multi-env-employer

---

Быстрый старт

from MultiEnvEmployer import Employer, RemoteModule

emp = Employer(
    project_dir="/path/to/project",
    venv_path="/path/to/venv"
)

moduleA = RemoteModule(emp, "moduleA")

result = moduleA.add(2, 4)
print(result)

Модуль moduleA.py должен находиться в указанной директории проекта и будет выполнен в другом virtualenv.

---

Как это работает

• код выполняется в отдельном Python-процессе
• используется указанный virtualenv
• обмен данными идёт через бинарный канал (pickle)
• ошибки и print() корректно проксируются в основной процесс

Со стороны пользователя вызов выглядит как обычный Python-код.

---

Возврат данных

Поддерживаются:

• обычный return
• генераторы (yield)
• потоковый возврат больших данных (автоматически)

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

---

Таймауты

Поддерживаются режимы:

• без ограничений
• жёсткий таймаут
• таймаут по отсутствию активности (progress)

При превышении времени worker-процесс будет остановлен.

---

Обработка ошибок

Ошибки внутри удалённого кода пробрасываются как Python-исключения:

• RemoteExecutionError
• RemoteTimeoutError
• RemoteImportError
• и другие

---

Для кого эта библиотека

MultiEnvEmployer полезен, если:

• нужно запускать код с конфликтующими зависимостями
• требуется поддержка нескольких версий Python
• нельзя использовать import из-за архитектурных ограничений
• нужен контроль выполнения кода во время runtime

Это не dev-инструмент, а инфраструктурный слой выполнения.

---

Документация и исходный код

Полная документация, архитектура и примеры доступны на GitHub:

https://github.com/REYIL/MultiEnvEmployer

---

Лицензия

MIT License