3.1 KiB
Executable File
ICS ANNOUNCER
A veces no necesitamos una herramienta enorme para una tarea sencilla. Queremos algo que haga una sola cosa y la haga bien. Pero los programas disponibles suelen sentirse como matar moscas a cañonazos. Por eso creé ICS Announcer: una herramienta ligera, funcional y enfocada. Su único propósito es publicar la lista de eventos diarios en Telegram.
Tecnicamente puede enviar a canales siempre y cuando lo tengas agregado al bot, pero no lo he probado. Podria ser util.
Preambulos
Aunque el código es simple, hay algunos pasos previos.
Clona este repositorio
git clone https://git.interlan.ec/Drk0027/icsannouncer.git
cd icsannouncer
Configuracion de Entorno virtual para Python
Necesitas tener instalado el paquete venv en tu distro para poder crear entornos virtuales para python. En el directorio del proyecto ejecuta lo siguiente.
python -m venv nombre_env
source .venv/bin/activate #linux
.\venv\Scripts\activate.bat #windows en cmd, usa ps1 para powershell
pip install -r requirements.txt
Calendario
Muchos calendarios permiten compartir sus eventos públicamente en formato ICS. ICS Announcer descarga el archivo en cada ejecución, lo que permite reflejar cambios de último momento. Eso sí, depende de tener conexión estable y acceso al calendario.
Token de Bot Telegram
Si estás leyendo esto, probablemente ya sepas cómo funciona un bot en Telegram. Si no, puedes crearlo fácilmente usando BotFather, donde obtendrás el token necesario. Para ayuda adicional, puedes seguir el tutorial oficial.
Telegram tiene un tutorial oficial para esto
https://core.telegram.org/bots/tutorial
ID del grupo o canal
Si ya juegas con bots seguro sabrás como conseguir este ID, pero adjunto un script con el que puedes conseguir el id de tu grupo. Puedes usarlo con el mismo bot cuyo token conseguiste hace un momento.
groupid.py
Ejecución
Renombra el archivo .env.sample a .env y rellena los valores
CAL_URL= https://tucalendario.com
TOKEN= tutokendetelegram
GROUP_ID=elidquesacastedetugrupo
Una vez completados los preámbulos, basta con programar una tarea que ejecute regularmente el bot mediante cron o alguna herramienta similar.
0 1 * * * /tu/ruta/absoluta/al/python/de/tu/venv/bin/python /tu/ruta/absoluta/a/tu/icsannouncer/main.py
Debido a que estas usando un entorno virtual, lo recomendable es que ejecutes ese entorno virtual. Dado que cron no lo puede activar.
Sobre el bot
En este caso, he publicado el codigo de este bot porque no vale la pena hacer un codigo mas complejo para una tarea sencilla. La consecuencia de esto es que cualquiera que quiera desplegarlo, puede hacerlo, pero esto limita a que los que no tienen conocimientos tecnicos, no puedan usarlo. Desplegar un bot para multiples usuarios implica el gasto de recursos que no sobran para una tarea que solo produciria gastos si no hubiese alguna retribucion apropiada.