2021-12-03 10:29:32 +01:00
# matter_bot
2021-12-10 16:41:33 +01:00
2021-12-03 10:29:32 +01:00
## Pré-requis
2021-12-21 09:12:40 +01:00
`openssl` requis par [`mattermost_api` ](https://github.com/Celeo/mattermost_api )
2021-12-10 16:50:20 +01:00
```bash
sudo apt install libssl-dev
```
2021-12-21 10:32:33 +01:00
`.env` placé dans la racine du projet qui contient ses différentes variables :
2021-12-03 10:29:32 +01:00
```
2021-12-21 11:02:43 +01:00
TOKEN=votre_token_ici # pas besoin de token si vous mettez un combo pseudo/mot-de-passe
PSEUDO=votre_pseudo_ici # pas besoin de pseudo si un token est renseigné
MOT_DE_PASSE=votre_mot-de-passe_ici # pas besoin de mot de passe si un token est renseigné
2021-12-21 10:24:07 +01:00
URL=url_du_site_ici, ex: https://talk.up8.edu
EQUIPE=nom_de_lequipe, ex: etudiant-es
2021-12-03 10:48:11 +01:00
```
2021-12-21 11:02:43 +01:00
*Note: Si les deux moyens de connexion sont renseignés (token et pseudo/mot-de-passe), le bot ne se lancera pas.*
Dans le cas ou vous optez pour le token, vous devez ajouter un bot, pour ce faire (d'après la [documentation officielle ](https://developers.mattermost.com/integrate/admin-guide/admin-bot-accounts/ )) :
- Cliquez sur les 9 carrés en haut a gauche
- Integrations
- Bot Accounts
- Add Bot Account
- Remplissez les champs
- Cochez la case `post:all` pour être sur qu'il n'y aura pas de problèmes de permission (c'est une reccomandation)
- Create Bot Account
2021-12-21 11:15:07 +01:00
- Dans la page suivante, vous aurez votre token d'accès
> Dans mes tests, je reçois une interdiction serveur `403` donc je peux pas assurer que ça fonctionne (en théorie oui)
> Cependant, la connexion par pseudo/mot-de-passe est testée et fonctionne
2021-12-21 09:26:03 +01:00
2021-12-21 10:14:59 +01:00
---
### Tests en local
En local, j'ai utilisé Docker pour héberger mon instance de Mattermost et pouvoir faire des tests, voici le docker-compose que j'ai utilisé :
2021-12-21 10:15:33 +01:00
```docker
2021-12-21 10:14:59 +01:00
version: "2"
services:
mattermost:
image: mattermost/mattermost-preview:latest # version preview parce que c'est juste pour testé
container_name: Mattermost
ports:
- 8065:8065 # cf. documentation officielle : https://docs.mattermost.com/install/setting-up-local-machine-using-docker.html
restart: unless-stopped
```
2021-12-21 09:34:43 +01:00
---
### Sources
2021-12-21 10:05:47 +01:00
- [Documentation `mattermost_api` ](https://docs.rs/mattermost_api/0.1.0/mattermost_api/ ) (utilisé pour communiquer avec Mattermost)
- [Documentation `tokio` ](https://docs.rs/tokio/1.15.0/tokio/attr.main.html ) (utilisé car `mattermost_api` est `async` )
2021-12-21 09:34:43 +01:00
2021-12-21 09:26:03 +01:00
---
2021-12-21 13:10:36 +01:00
*Projet ne fonctionne pas avec l'instance de la Fac, car son mattermost se connecte via Gitlab et (je crois?) aucune librairie ne supporte ceci.*
