temps/README.md

temps, bot climatològic per al fedivers.

El codi de @temps@mastodont.cat! Aquest codi es un bot per a Mastodon que retorna en format gràfic el temps que fa o farà en qualsevol poble o ciutat que se li demani.
Qualsevol usuari de qualsevol servidor del fedivers pot consultar el clima:

@bot consulta: Barcelona
@bot avui: Barcelona
@bot setmana: Barcelona

El bot respondrà amb format gràfic l'informació climatològica obtinguda de la API de tutiempo.net (cal una API key) i amb l'ajut de OpenStreetMap mostrarà el mapa de la zona consultada.
També se li pot demanar que ens publiqui el temps a una hora determinada (alarma) amb:

@bot alarma: 08:00 Barcelona

O esborra l'alarma amb:

@bot esborra: Barcelona

Dependències

• Python 3
• Servidor Postgresql
• API key de tutiempo.net

Instal·lació

1. Clona aquest repositori: git clone https://git.mastodont.cat/spla/temps.git <directori_desti>

2. Entra dins del <directori_desti> i crea l'Entorn Virtual de Python: python3.x -m venv .

3. Activa l'Entorn Virtual de Python: source bin/activate

4. Executa pip install -r requirements.txt per a afegir les llibreries necessàries.

5. Executa python setup.py per a configurar el bot de Mastodon, els seus tokens d'accés.

6. Executa python db-setup.py per a crear la base de dades necessaria per les alarmes.

7. Executa python apikey-setup.py per a configurar la API key obtinguda a tutiempo.net.

8. Emprea el teu mètode favorit de programació de tasques (per exemple cron) per a que s'executi python temps.py cada minut.