Обновление Python#

Для обновления библиотеки Python в SMDL существует два способа:#

Автоматический:

  • Выполняется при commit изменений в Python скрипты в папке synapsedevopspy в ветку master исходного кода SMDL;

  • Jenkins Job осуществляет прослушивание репозитория ветки master с исходным кодом SMDL;

  • При нахождении изменений, происходит запуск Jenkins Job ConfigXmlGenerator (описанного в подразделе «Pipelines» раздела «Дополнительная документация» документа «Руководство оператора») с настройкой обновления synapsedevopspy и осуществляется коммит новой версии в master ветку;

  • Установка новой версии происходит при выполнении шага CommonStep.groovy (описанного в подразделе «Шаги» раздела «Дополнительная документация» текущего документа) любым Jenkins Job, использующим данный шаг.

Ручной:

  1. Открыть проект в IDE для Python и настроить виртуальное окружение. Для настройки нужно:

    1. Перейти в настройки среды разработки

      ide_settings

      Рисунок. Настройка IDE

    2. Перейти в настройки интерпретатора

      interpreter_settings

      Рисунок. Настройка интерпретатора

    3. Добавить новый интерпретатор (значок шестеренки в правом верхнемуглу → add…)

      add_new_interpreter

      Рисунок. Добавление нового интерпретатора

    4. Выбрать Virtual Enviroment → NewEnvironment и нажать ОК. После этого в директории проекта будет сгенерирована папка venv с виртуальным окружением. Путь до базового интерпретатора должен загрузиться автоматически. Если этого не произошло нужно будет заполнить вручную.

      create_venv

      Рисунок. Создание виртуального окружения

    5. Выбрать интерпретатор. Нужно закрыть окно с настройками, подождать пока IDE для Python его загрузит.

      choice_interpreter

      Рисунок. Выбор нового интерпретатора

  2. Открыть терминал (View → Tool Windows → Terminal) и перейти в каталог resources, команда cd resources

  3. Активировать режим виртуального окружения в IDE для Python, если он не активировался автоматически. Это можно понять по консоли, перед директорией должна быть надпись: (venv). Для активации введите команду "…/venv/Scripts/activate". После этого в консоли должна появится соответствующая надпись.

  4. Установить пакет wheels, команда "python -m pip install wheel --index-url=link_to_index --trusted-host=host"

  5. Внести изменения в Python скрипты в каталоге resources/synapsedevopspy/

  6. Перейти в директорию resources и выполнить команду "python setup.py bdist_wheel --universal".

  7. Произвести коммит и пуш изменений файла synapsedevopspy-0.0.1-py2.py3-none-any.whl и файлов, которые меняли. Файлы, которые генерируются в процессе сборки библиотеки, производить commit не нужно.