04.27 (суббота) Автоматизация

• Коротко: задача автоматизации
• Генераты: промежуточные и целевые

• DoIt

• Принципы (на примере выгонки документации)

  0. Скопировать любое решение, в котором применяется Shpinx (например, Задание 0 из практикума по документированию)

  1. Установить doit и создать простейший dodo.py с заданием html, независимо ни от чего собирающий документацию

  2. Написать задание erase, которое удаляет всё лишнее ( не забыть сначала закоммитить всё!)

  3. Использовать файловые зависимости, чтобы документация перегенерировалась только при изменении исходных файлов (обычно это .rst и .py, если используется autodoc)

  4. Написать задание zip, которое создаёт zip-архив с документацией, используя зависимости между заданиями

  5. (возможно, не успеем) TODO использовать целевые файлы для автоматического определения зависимостей на них (например, статистику по .zip)

  6. (возможно, не успеем) TODO использовать подзадания (например, генерировать sphinx-ом и html и text)

• Скопировать решение Задания 0 из позапрошлого семинара (программа + перевод) и автоматизировать перевод:

  • pot Выгонку шаблона (.pot)

  • po Обновление перевода по шаблону

  • mo Выгонку скомпилированного перевода

  • образец описания целей для автоматизации перевода смотрите здесь, можно копировать куски doit-файла

• Сделать удаление промежуточных генератов (целевые, например, .mo, оставить)

• Сделать тестовый запуск по заданию из dodo.py (проверить, что перевод собрался и работает)

Д/З

Задача_1. Автоматизация сборки для MUD.

• Скопировать решение Задачи_1 с предыдущего занятия. Сделать коммит. Работать на ветке work.

• реализовать цель i18n для полной генерации перевода

  • реализовать цели-шаги генерации перевода, как в описанном выше упражнении

  • цель i18n должна зависеть от этих целей-шагов

• реализовать цель html для генерации html-документации

• реализовать цель test для прогона тестов связки клиент+сервер (зависит от цели i18n, потому что проверяет русифицированные ответы сервера)

• для каждой цели реализовать удаление генератов (использовать атрибут clean и функцию clean_targets; для удаления каталога с документацией использовать функцию shutil.rmtree)

• цель по умолчанию: html