Metadata-Version: 2.1
Name: MainServiceManager
Version: 0.0.7
Summary: Пользовательская программа для управления сервисами, аналогично systemd
Home-page: https://github.com/MainPlay-TG/MainServiceManager.py
Author: MainPlay TG
Author-email: xbox.roman6666666666@gmail.com
Requires-Python: >=3.8,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: Flask (>=3.0.3,<4.0.0)
Requires-Dist: MainShortcuts (>=1.6.95,<2.0.0)
Requires-Dist: requests (>=2.31.0,<3.0.0)
Project-URL: Repository, https://github.com/MainPlay-TG/MainServiceManager.py
Description-Content-Type: text/markdown

# Описание
MainServiceManager - менеджер сервисов (аналогично `systemctl` в `Linux`). Каждый пользователь может запустить свой сервер MainServiceManager при условии, что они запущены на разных портах. Программы, у которых есть пароль, могут использовать API для управления всем сервером и всеми сервисами. Сервисы могут использовать API для управления собой (ограниченный доступ).
# Использование встроенного API
```python
from MainServiceManager import Launcher
# Инициализация API
launcher=Launcher({"user":"admin","password":"qwerty :)"})
# Проверить статус сервера
try:
  launcher.admin_status()
  print("Сервер доступен")
except:
  print("Сервер недоступен")
# Остановить сервер
launcher.admin_stop()
```
# Конфиг сервера
По умолчанию настройки сервера хранятся в файле `~/.config/MainServiceManager/cfg.json`
Если файл не существует, он будет создан
Настройки по умолчанию:
```json
{
  "host":"127.0.0.1",
  "password":"",
  "port":8960,
  "services_dir":"{папка с конфигом}/services",
}
```
- `host` - IP адрес, на котором будет запущен сервер
- `port` - порт, на котором будет запущен сервер
- `password` - пароль от аккаунта `admin`. Не забудьте его изменить!
- `services_dir` - папка с файлами сервисов
# Файлы сервисов
Если параметр не указан, он равен `null`
Недопустимые параметры игнорируются, но видны при получении информации о сервисе
Тип записи:
- `параметр` (`тип`) - описание
## Обязательные параметры
- `args` (`list`) - список аргументов для запуска
## Дополнительные параметры
- `autostart` (`bool`) - включать сервис при запуске сервера?
- `data_path` (`str`) - путь к файлу JSON для записи информации о сервисе (в том числе персональный пароль)
- `cwd` (`str`) - рабочая папка
- `env` (`dict`) - переменные среды
- `clean_env` (`bool`) - отключить наследование ENV от процесса сервера?
- `restart` (`str`) - условие для автоматического перезапуска
- | `"always"` - перезапускать при любой остановке процесса
- | `"on_error"` - перезапускать если процесс остановился с кодом ≠0
- | `"code=N"` - (в будущем) перезапускать если процесс остановился с кодом N
- | `"code!=N"` - (в будущем) перезапускать если процесс остановился с кодом ≠N
- | `null` - не перезапускать
## Параметры для Linux
Если параметры недоступны, они игнорируются
- `user` (`str`) - пользователь, от имени которого нужно запускать процесс
- `group` (`str`) - группа, в которой нужно запускать процесс
- `extra_groups` (`unknown`) - неизвестно, не рекомендуется для использования
