Содержание
Руководство для пользователей
В этом кратком руководстве я расскажу как подготовить вашу систему к запуску Менеджера, а также расскажу как им пользоваться. Данное руководство расчитано на пользователей без навыков программирования.
Шаг 1. Установка Python и PySide6
Так как PUSSY поставляется в виде исходного кода, то для его запуска нужен интерпретатор. Для этого переходите на сайт python.org и скачивайте дистрибутив для своей операцинной системы. Далее я опишу процесс установки для Windows.
После скачивания запускайте исполняемый файл отметьте поле «Add Python 3.6 to the PATH» (Добавить Python 3.6 к системной переменной PATH), как на рисунке (это может выглядеть по-разному в зависимости от версии, которую вы устанавливаете).
Нажимайте «Install Now», чтобы начать установку немедленно или «Customize installation» для тонкой настройки установки.
После установки Python нужно установки пакет PySide6. Для этого запустите приложение Командная строка нажатием «Win+R» и введите «cmd» и Enter, должно появиться окно терминала, затем введите команду:
pip install PySide6
После скачивания пакета приложение готово к запуску.
Комплекс написан и протестирован на Python 3.11, поэтому рекомендую использовать данную версию или более новую
Шаг 2. Скачивание исходного кода и запуск
Для скачивания перейдите в репозиторий или ищите дополнительные способы загрузки на Странице проекта. На GitHub щелкайте по кнопке «Code» и выберите пункт «Download ZIP» или скачайте архив с исходниками в разделе Release. После скачивания распакуйте содержимое на жеском диске. Запустите двойным щелчком файл PUSSY.pyw в папке PUSSY/manager.
Шаг 3. Пользуемся
Если все предыдущие шаги были выполнены правильно, то на экране предстанет главное окно Менеджера. В главном окне будут отображены вкладки Плагинов, которые на данный момент установлены и активированы. По умолчанию Плагины инициализируются после того как будет активирована вкладка, если нужно инициализировать его при запуске, то далее будет рассказано как это сделать.
Чтобы перейти к списку установленных плагинов надо нажать Ctrl+Alt+P. В первом столбце показаны имена Плагинов; во втором - кнопки активации, с их помощью можно выключать или включать плагины в любое время; в третьем - кнопки перехода к настройкам, если кнопка не активна, то настройки отсутствуют; в четвертом - дополнительные опции: Plugin Info - информация о плагине; Reset Settings - сброс настроек; Initialize on startup - инициализация плагина при запуске.
Менеджер имеет небольшой перечень настроек, чтобы перейти к ним надо нажать Ctrl+Alt+S. В первом разделе собраны настройки для настройки интерфейса, описывать каждый из них нет смысла, так как их назначение должно быть понятно. Во втором разделе одна опция: «Exterrnal plugin directories» - это список папок, где Менеджер производит поиск плагинов, о них мы поговорим позднее. Чтобы применить настройки нужно нажать на «Apply settings». Кнопка « Delete invalid data» - удаляет данные о плагинах, которые были удалены или недоступны.
Есть еще один раздел, он скорее всего не будет интересен обычным пользователям, но в некоторых случаях он может быть полезен, например, если Плагины работают некорректно. Речь идет о системных сообщениях, чтобы перейти к ним надо нажать Ctrl+Alt+L, там выводится информация о работе плагинов, если сообщения выделены зеленым, то все в порядке, если красным, то возникло исключение в проц ессе работы. Чтобы выводить детальную информацию об исключениях нужно в настройках отметить опцию «Display error info in Logs».
Шаг 4. Установка, удаление плагинов
Плагин - по сути это пакет (исходя из терминологии Python), это папка с файлами, которые содержат исходный код, в ней в обязательном порядке должен находиться файл с именем _ _init_ _.py.
Для того чтобы установить плагин нужно просто скопировать папку с исходным кодом в директорию PUSSY/manager/Plugins, либо в любую другую, которая указана в настройках, в пункте «External plugin directories».
Удаление производится аналогичным образом. После установки или удаления перезагрузите Менеджер, чтобы изменения вступили в силу. Чтобы удалить служебную информацию об удаленных плагинах нужно нажать на « Delete invalid data» в разделе настроек.
Чтобы узнать о том как разрабатывать собственные плагины смотрите соответствующие материалы на этом сайте.