TaipowerToSlack

TaipowerToSlack

TaipowerToSlack est un outil qui récupère les « informations électriques d'aujourd'hui » auprès de Taipower et envoie les données à un canal Slack désigné, permettant aux utilisateurs de surveiller facilement l'état de l'alimentation électrique de Taiwan.

Page « Informations sur l'alimentation d'aujourd'hui » de Taipower :

• Anglais : https://www.taipower.com.tw/en/page.aspx?mid=4484
• Chinois : https://www.taipower.com.tw/tc/page.aspx?mid=206&cid=402&cchk=8c59a5ca-9174-4d2e-93e4-0454b906018d

Veuillez noter qu'il s'agit principalement d'une démo de script shell, avec un code peut-être moins élégant et des valeurs codées en dur.

Captures d'écran

Capture d'écran Slack :

Capture d'écran du terminal :

Configuration et utilisation

1. Obtenez votre URL de webhook entrant Slack

Reportez-vous à la documentation de Slack pour plus de détails sur la façon d'obtenir une URL de webhook entrant pour votre chaîne Slack.

2. Clonez ce référentiel ou téléchargez le script

Clonez le dépôt :

git clone https://github.com/PeterDaveHello/TaipowerToSlack

Ou téléchargez directement le script run.sh et rendez-le exécutable :

TaipowerToSlack/run.sh chmod +x /path/to/ TaipowerToSlack /run.sh">

curl https://github.com/PeterDaveHello/TaipowerToSlack/raw/master/run.sh -o /path/to/ TaipowerToSlack /run.sh
chmod +x /path/to/ TaipowerToSlack /run.sh

3. Configurez et exécutez le script

Accédez au répertoire contenant le script run.sh

Définissez la variable SLACK_HOOK dans le script shell ou transmettez-la lors de l'exécution du script :

SLACK_HOOK=https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX ./run.sh

Le résultat devrait être affiché sur votre chaîne Slack comme indiqué dans la capture d'écran.

4. Facultatif : publiez sur Slack uniquement lorsque le statut change

Pour activer cette option, vous pouvez soit définir les variables d'environnement STATELESS et ONLY_POST_ON_STATUS_CHANGE lors de l'exécution du script, soit les modifier directement dans le script run.sh :

• Transmettez les variables lors de l'exécution du script :

  STATELESS=false ONLY_POST_ON_STATUS_CHANGE=true ./run.sh

• Ou modifiez le script run.sh :

  STATELESS= " false "
  ONLY_POST_ON_STATUS_CHANGE= " true "

Quelle que soit la configuration, le script utilisera le fichier ~/.taipower.status pour stocker le statut et publiera un message sur Slack uniquement lorsque le statut change.

Dépendances

• jq : pour analyser les données JSON
• curl : pour récupérer les données JSON à partir de l'API Taipower
• bash : pour exécuter le script shell
• mktemp : pour créer des fichiers temporaires
• bc : pour calculer des pourcentages à partir de données

Si l'un de ces outils manque, vous pouvez généralement l'installer à l'aide du gestionnaire de packages de votre système (par exemple, apt , yum ou pacman ).

Licence

Ce projet est publié sous la licence WTFPL v2.