cherkasy-power-outages-calendar
Календарі планових відключень світла для Черкас і Черкаської області: окремий календар для кожної з 12 підчерг (від 1.1 до 6.2). Бот сам читає офіційний Telegram-канал Черкасиобленерго і оновлює файли календарів, на які можна підписатися на телефоні. Працює безкоштовно на GitHub Actions, комп'ютер вмикати не потрібно.
English: calendar feeds of planned power outages in Cherkasy region, one per subqueue (1.1 to 6.2). A bot reads the official Telegram channel of the utility and publishes .ics calendars. Runs for free on GitHub Actions.
Підписка
Сторінка з кнопками для всіх підчерг: https://podmor.github.io/cherkasy-power-outages-calendar/
GitHub не показує посилання webcal:// клікабельними, тому «Apple» веде на сторінку з кнопками: відкрийте її на iPhone або Mac і натисніть «Apple» у рядку своєї черги. Кнопка «Google» працює і звідси.
Свою підчергу можна дізнатися за адресою на сайті Черкасиобленерго.
iPhone: Налаштування → Календар → Облікові записи → Додати обліковий запис → Інше → Додати підписаний календар → вставити посилання (або просто натиснути кнопку «Apple»).
Mac: Календар → Файл → Нова підписка на календар.
Календар лише для читання. Події оновлюються самі: якщо графік змінився, час події міняється, а скасоване відключення зникає. Перед кожним відключенням є нагадування за 15 хвилин. Телефон сам вирішує, як часто оновлювати підписку, тому зміни можуть з'являтися із запізненням до кількох годин.
Як це працює
- Раз на 15 хвилин запускається
python -m outage_calendar.
- Бот читає публічну сторінку офіційного каналу
t.me/s/pat_cherkasyoblenergo (логін і ключі не потрібні).
- Із повідомлень «Години відсутності електропостачання» для кожної дати і кожної підчерги береться список годин без світла.
- Оновлення, що виходить протягом дня, містить лише години, які ще попереду (відключення, яке йде зараз, вказане повністю). Бот зберігає години, що вже минули, а решту дня замінює новим списком. Повідомлення, опубліковане до початку доби, замінює день повністю.
- Сусідні години об'єднуються в одну подію, також через північ.
- Якщо найновіше повідомлення прочитати не вдалося, запуск завершується помилкою, і GitHub надсилає лист власнику репозиторію.
Стан зберігається у state/, готові календарі та сторінка з посиланнями у docs/ (їх віддає GitHub Pages).
Налаштування
Усе в config.json: канал, список підчерг (queues), час нагадувань у хвилинах (alarm_minutes), адреса сайту (site_url). Нова підчерга з'являється, щойно її додано до queues.
Розробка
pip install -r requirements-dev.txt
python -m pytest
python -m outage_calendar
Тести містять справжні повідомлення каналу за 6–8 жовтня 2026 року. Модуль outage_calendar/wheel.py розпізнає картинки-годинники з неофіційних каналів із графіками. Зараз він не використовується і лишається як запасний варіант.
