isp-python-wrapper-kit

Назначение библиотеки

isp-python-wrapper-kit — это библиотека, которая:

• Запускает Python-модуль как дочерний процесс из Go
• Передаёт ему json (config.json) конфигурацию через файл и env-переменные (BINDING_ADDRESS и CONFIG_FILE)
• Перезапускает Python-процесс при изменении конфигурации
• Интегрируется с инфраструктурой
• Управляет жизненным циклом Python-сервиса как частью Go-приложения

Жизненный цикл дочернего процесса

Python-процесс управляется компонентом PySupervisor и существует в рамках жизненного цикла Go-приложения.

Основные состояния:

1. Idle (ожидание конфигурации)
2. Starting (запуск процесса) - запуск через uv run
3. Running (процесс работает)
4. Restarting (перезапуск при получении нового конфига) - выключение дочернего процесса и повторный запуск
5. Stopping (остановка) - передача дочернему процессу сигнала SIGTERM с таймаутом 5s, если за это время процесс не останавливается, вызывается kill дочернего процесса
6. Stopped (завершён)

Требования

1. main.py, pyproject.toml и uv.lock должны находиться в корне проекта
2. Для получения адресов required сервисов необходимо, чтобы сервис на питоне реализовывал метод POST /receive_module_addresses и принимал тела вида:

{
    "module": "<moduleName>",
	"hosts":  ["<host:port>","<host:port>"],
}

3. В директории conf должны лежать config.yml и default_remote_config.json

Использование

Сервис без endpoint'ов

package main

import (
	"my-module/conf"
	wrapperkit "gitlab.txix.ru/isp/isp-python-wrapper-kit"
)

func main() {
	wrapperKit.Main[conf.Remote](conf.Remote{}, nil, nil)
}

Сервис с endpoint'ами

package main

import (
	"my-module/conf"
    "my-module/routes"
	wrapperkit "gitlab.txix.ru/isp/isp-python-wrapper-kit"
)

func main() {
	wrapperKit.Main[conf.Remote](conf.Remote{}, routes.EndpointDescriptors(), nil)
}

Сервис с required модулями

package main

import (
	"my-module/conf"
	wrapperkit "gitlab.txix.ru/isp/isp-python-wrapper-kit"
)

func main() {
	wrapperKit.Main[conf.Remote](conf.Remote{}, nil, []string{"<required-module-name1>","<required-module-name2>"})
}