Для локальной проверки ваших решений можно пользоваться следующей командой:

$ bash .test/taskX/validate

где X - номер соответствующего задания.

В директории src находится исходный код приложения wordcount, написанного на языке Си, для подсчета количества слов в указанных файлах или во входном потоке STDIN.

Также в корне репозитория находится конфигурационный файл config.json, в котором указано название приложения (которое может отличаться от названия исходного файла) и версия приложения. Предполагается, что эти значения должны явно передаваться при компиляции приложения с помощью директивы препроцессора -D, переопределяя тем самым объявления NAME и VERSION из src/wordcount.c.

Требуется автоматизировать процесс сборки приложения с помощью системы сборки make с учетом следующих требований:

• Итоговый артефакт сборки (скомпилированное приложение) должен находиться в директории build и называться в соответствии со значением name, указанном в config.json;
• При компиляции приложения необходимо определить значения объявлений NAME и VERSION в соответствии со значениями name и version, указанными в config.json;
• При изменении исходного кода приложения или config.json, приложение должно перекомпилироваться;
• При отсутствии изменений, перекомпиляции не должно происходить;
• В качестве цели по умолчанию следует использовать стандартную цель all;
• Также необходимо объявить цель clean, которая производит очистку артефактов сборки.

$ sudo apt install jq

$ jq -r .name config.json
wordcount
$ jq -r .version config.json
1.0.0

Пример использования

$ make
...
$ ./build/wordcount
wordcount version 1.0.0
$ make
make: Nothing to be done for 'all'.
$ make clean

В директории test находятся тесты с расширением .txt и ожидаемый вывод с расширением .expected для приложения wordcount, собранного в предыдущем задании.

Требуется автоматизировать процесс тестирования приложения с помощью системы сборки make с учетом следующих требований:

• Необходимо проверить соответствие всех вывода приложения на всех тестах в директории test;
• В случае несоответствия вывода на каком-либо тесте, нужно вывести разницу ожидаемого вывода с полученным, и завершить тестирование с ошибкой;
• В случае успешного прохождения всех тестов, никакого вывода в консоль не должно происходить;
• Тестирование должно неявно вызывать сборку приложения, если она еще не произошла;
• Процедура тестирования не должна оставлять после себя никаких лишних файлов в репозитории или каким-либо образом изменять его содержимое;
• В качестве цели следует использовать стандартную цель check.

Пример использования

$ make
...
$ make check

Для сборки и исполнения приложения может требоваться определенное окружение или зависимости. В случае приложения wordcount его сборка требует установленной в системе утилиты jq для получения конфигурационных значений из config.json.

Требуется унифицировать окружение сборки и тестирования приложения wordcount с помощью Docker.

Необходимо создать Dockerfile с учетом следующих требований:

• Сборка Docker-образа должна запускать тесты из предыдущего задания и заканчиваться ошибкой, если тесты не прошли;
• При запуске образа должно запускаться собранное приложение;
• В итоговом образе должно находиться полное содержимое репозитория;
• Рабочая директория в контейнере должна быть выставлена в корень репозитория.

Пример использования

$ docker build --network host -t wordcount .
[+] Building ...
$ docker run --rm -i wordcount --version
wordcount version 1.0.0

Последним шагом является создание системы Continuous Integration (CI), для автоматической верификации (сборки и тестирования) каждого изменения в репозитории приложения.

Требуется создать workflow в GitHub Actions, который будет автоматически запускать сборку и тестирование приложения с помощью make на каждый push и Pull request в main ветку.