В данной работе выполнена задача создания автоматизированной системы принятия лабораторных работ, ведущей автоматизированный сбор информации о выполненных студентами лабораторных работах, выложенных на ресурсе GitHub. Проверка правильности выполнения лабораторных работ осуществляется с помощью сервисов автоматической интеграции и тестирования Travis CI и AppVeyor. Полученная информация о результатах выполнения лабораторных работ каждым студентом размещается в облачном сервисе Google-таблицы в виде списков студентов, разбитых на вкладки по группам, с указанием даты выполнения лабораторной работы и ссылкой на неё же.
Студенты должны отправлять информацию о своих лабораторных работах по электронной почте в определённом формате на заданный почтовый ящик. Формат письма должен быть в следующем виде:
Заголовок: «Название предмета»
Тело письма:
Номер группы
ФИО
Ссылка на выполненную работу
Программа, по заданному расписанию, читает только новую почту в заданном почтовом ящике, согласно RFC822 Standard for ARPA Internet Text Messages и RFC5321 Simple Mail Transfer Protocol. После проверки правильности заполнения письма программа заносит информацию о новой выполненной студентом лабораторной работе в Google-таблицу. В случае наличия ошибок в формате полученного электронного письма или в случае неправильных данных о группе, ФИО студента или ошибки формата ссылки на лабораторную работу, программа посылает письмо отправителю с сообщением об ошибке и переходит к обработке следующего непрочитанного письма.
После получения почты, по прошедшим проверку письмам, программа проверяет результаты выполнения лабораторных работ по полученным на них ссылкам на сервисе GitHub, используя REST API интерфейсы GitHub, Travis CI, AppVeyor. В случае, если лабораторная работа прошла автоматические проверки, и решённый номер варианта соответствует присвоенному студенту номеру варианта, программа заносит результат в Google-таблицу на вкладку с группой студента в строчку с его фамилией и в столбец с датой выполнения данной лабораторной работы.
Алгоритм работы программы:
Программа начинается с чтения Yandex-почты, после информация сверяется с содержимым Google-таблицы, в случае несовпадений, отправляет письмо на почтовый ящик студента об ошибке. В случае правильных данных, переходит по ссылке на GitHub, а после на Travis или AppVeyor в зависимости от номера лабораторной, вычисленного из ссылки. Достаётся информация о работе, сверяется вариант с данными из Google-таблицы и в случае правильно выполненных условий, заносит в таблицу результат.
Наглядная диаграмма взаимодействия сервисов:
Со стороны преподавателя происходит наименьшая работа с сервисами. Необходимо только зайти на облачный сервис Google-таблицу и посмотреть интересующие данные. При желании, по ссылке на работу на GitHub и при возникающих вопросах по коду, общаться со студентом и в соответствии с ответами выставлять оценку в Google-таблицу.
Диаграмма последовательности с точки зрения преподавателя:
Студенту же достаётся самое сладкое. Он выполняет лабораторную работу у себя на компьютере, затем загружает получившееся на GitHub и ждёт прохождения тестов. Как только появляются зелёные галочки в интерфейсе GitHub’а рядом с последним коммитом, студент может посылать письмо с данными о себе и ссылкой на работу на почту преподавателя. После чего студенту либо приходит автоматический ответ о неверно указанной информации в теле письма и ему придётся исправить ошибки и послать письмо снова, либо все данные верны и будут занесены в Google-таблицу.
Диаграмма последовательности с точки зрения студента:
В данном проекте производится автоматическая проверка лабораторных работ курса «Операционные Системы» в СПбГУАП, но его можно реализовать для любых предметов, лабораторные работы которых состоят в написании кода.
При правильно отправленном сообщении результат заносится в Google-таблицу. Пример правильного письма и вывода в таблицу:
Так же есть обработка ошибок. В случае ошибки номера группы студенту приходит письмо с соответствующим уведомлением. Пример такого письма:
При ошибке в ФИО студента автоматическая система отправки сообщений присылает ему ответ. Пример такого ответа:
В случае неправильной ссылки студенту приходит следующий ответ:
Когда студент ошибается в номере лабораторной в ссылке, программа посылает ему сообщение с уведомлением проверить номер работы в ссылке. Пример письма:
git clone https://github.com/GandraNNA/automatization_labs.git
python -m pip install --upgrade pip
python pip install PyGithub
python pip install gspread
python pip install google-api-python-client
python pip install oauth2client
python main.py
Пароль от почты на Яндексе.
Токен для доступа к AppVeyor.
Токен для доступа к GitHub.
Автор: Анна Гандрабура