Публикация и CI

Совсем немного про CI

Непрерывная_интеграция:

• получение исходного кода из репозитория;
• сборка проекта;
• выполнение тестов;
• развёртывание готового проекта;
• отправка отчетов.

Обратите внимание: сборка проекта. Как следствие, инструменты сборки утекли с локальной машины на CI-платформу:

• Возможность собирать под любую платформу

• Возможность проводить полноценный деплоймент

Как следствие, «умные» инструменты автоматизации сборки типа Make уступили место простым очередям заданий

• https://travis-ci.com

• https://github.com/features/actions

• https://docs.gitlab.com/ee/ci/

  • В GitLab начали задумываться над графом зависимостей, но как-то очень путано

• … (тысячи их)

Пример проекта

Довольно извращённый модуль: Словарь с тегами

• Используется GH Actions
  • Развертывание виртуальной машины с указанной ОС
  • Установка пакетов в ОС
  • Собственно действия — запуск команд shell
    • Дополнительная настройка (например, pip install)
    • Собственно тестирование / сборка / и т. п.

• Сценарий (т. н. manifest) с описанием всего этого

• Манифест может активизироваться вручную или по событию (например, просто при каждом push, на каждый новый тег, только на подписанный тег и т. п.).
• Могут получаться т. н. «артефакты», их можно публиковать

…

Публикация на PyPi

В действительности ничего свыше методички на PyPA не требуется:

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

  • на сегодня (2021-05-17) в методичке описан файл README.md, в то время как формат по умолчанию для PyPI — не markdown, а ReST, это управляется параметром long_description_content_type setup.cfg

• Публикация происходит с помощью специального инструмента — twine

  • Вместо логина надо указывать слово __token__, вместо пароля — выданный вам ключ. Этот же ключ могут использовать и роботы CI

• Немедленно после успешной публикации модуль можно устанавливать!

• на PyPI нельзя выкладывать файл с одним и тем же именем повторно, даже если вы вообще удалили и завели заново соответствующий проект. Если хоть что-то поменяли — поднимайте номер версии.

• README.rst из дистрибутива можно использовать в качестве описания проекта, а вот другие файлы (например, картинки) — нет. Однако можно сослаться на картинки в репозитории, если хостинг поддерживает их показ.

Проблема версионирования: Классический релиз менеждмент с тегами (на пример, на GitHub vs version =  в pyproject.toml — синхронизация номера версии?

• когда был setup.py, решалась гененрацией версии

• в pyproject.toml не решена

  • (TODO а вот тут?)

• может быть решена высокоуровневыми инструментами типа Poetry

Публикация на readthedocs.org

Тут всё ещё проще! Достаточно, чтобы в вашем проекте выгонялась документация с помощью sphinx.

• Залогиниться и указать репозиторий, из которого будет произведён экспорт
• Документация будет пересоздана создана автоматически на база исходного репозитория (самому генерировать её не надо)
• Если код написан так, что при выгонке документации требуется импортировать внешние модули, возможны ошибки (это тоже своего рода CI, но никто не будет ставить, допустим, matplotlib).

  • Пример того, как в проекте Pymunk на скорую руку понаделали мокеров вместо соответствующих модулей прямо в конфигурационном файле sphinx

• Такую публикацию можно тоже подключить в CI

• Пример для эталонного пректа

• TODO пример для taggedict

Foreword

…