Добавлена ручка /event/ical для получения событий из 3'd party источников

[CaseAsLimbo]

Изменения

• Добавлена ручка /event/ical, парсящая полученный через multipart/form-data .ical или .ics файл и создающая на его основе события/событие в БД.
• добавлен модуль calendar_backend/utils/services.py; в него вынесена логика двух эндпоинтов: POST /event/repeating и POST /event/bulk, это сделано для переиспользования их логики в ручке получения событий из 3'd party.

Детали реализации

• group_id обязательный параметр, иначе поднимаем 403 Forbidden (пока не менял логику в соответствии с этим в /event/bulk и /event/repeating -- исключение поднимается только в /event/ical)

• Для полей group_id, room_id и lecturer_id предполагается создание кастомных полей в формате Icalendar(отдающая сторона должна о них знать и передавать). На данный момент названия кастомных полей зашиты в логике ручке следующим образом

• ручка `/event/ical' может парсить обычные и повторяющееся события

• На данный момент из .ical файла берется поле RRULE, а из него INTERVAL для repeat_timedelta_days и UNTIL для repeat_until_ts. Однако формат RRULE позволяет очень гибко настраивать даты проведения событий. Возможно имеет смысл переработать способ создания повторяющихся событий, делая их не только интервальными, но и, например, в конкретные дни недели в течении месяца(ical позволяет это описать).

Cсылки на доку

• Описание VEVENT(не открывается без vpn)
• Доступные поля в RRULE для повторяющихся событий(не открывается без vpn

В планах

• Добавить проверку граничных условий
• Добавить тесты на ручку event/ical
  • Добавить билдер ical файлов для тестов
• Добавить логирование неудачно распраршенных(скипнутых) событий - на данный момент просто ловится исключение в блоке try-except.
• Добавить логику частичного успеха работы эндпоинта, если были скипнуты не все события?

Check-List

• Вы проверили свой код перед отправкой запроса?
• Вы написали тесты к реализованным функциям?
• Вы не забыли применить форматирование black и isort для Back-End или Prettier для Front-End?

[github-actions]

💩 Code linting failed, use black and isort to fix it.

[github-actions]

Coverage Report

File	Stmts	Miss	Cover	Missing
calendar_backend
__main__.py	6	6	0%	1–16
exceptions.py	13	2	85%	8, 14
calendar_backend/methods
list_calendar.py	116	89	23%	29–37, 41–80, 87–110, 117–123, 130–135, 144–157, 161–172
utils.py	35	26	26%	14–19, 23–28, 34–38, 42–46, 52–56
calendar_backend/models
base.py	64	1	98%	87
calendar_backend/routes
base.py	74	7	91%	75, 80–81, 86–87, 98, 101
calendar_backend/routes/event
comment.py	47	6	87%	30, 41–43, 52, 64
comment_review.py	27	4	85%	23–29, 41
event.py	92	10	89%	39, 46–49, 54, 134–137
user_event.py	23	13	43%	31–51, 69–80
calendar_backend/routes/group
group.py	38	3	92%	26, 42, 58
calendar_backend/routes/lecturer
comment.py	48	8	83%	35, 49, 57–61, 70
comment_review.py	25	4	84%	21–29, 41
lecturer.py	60	8	87%	27, 41, 44, 54, 78–81
photo.py	43	5	88%	43, 48, 65, 76, 79
photo_review.py	51	20	61%	39–58, 75–77
calendar_backend/routes/models
base.py	60	9	85%	36–40, 43, 56, 67, 80
event.py	62	3	95%	15, 42, 60
group.py	39	16	59%	13–19, 22, 32–38, 41
lecturer.py	46	2	96%	21, 31
room.py	21	1	95%	13
calendar_backend/routes/room
room.py	39	3	92%	26, 44, 58
calendar_backend/utils
services.py	49	2	96%	53, 55
TOTAL	1284	248	81%

Summary

Tests	Skipped	Failures	Errors	Time
34	0 💤	0 ❌	0 🔥	7.349s ⏱️

[github-actions]

💩 Code linting failed, use black and isort to fix it.