Jarvis is our IRC bot to handle most of our internal management. Its source code is available on [our Git repo](http://git.hackens.org/Jarvis/) or on [Github](https://github.com/hackEns/Jarvis). Please refer to these repos for more infos on the way it works. Since the rest of this page is basically a user manual for our members, it will be written in French.

Jarvis est notre bot IRC pour gérer tout notre fonctionnement interne. Il permet notamment d'ajouter des nouvelles factures au budget, de gérer les emprunts, et de surveiller l'hack'ave. Toutes les infos données à Jarvis sont présentées sur [sa visu web](http://hackens.org/jarvis).

Le code est disponible sur [notre dépôt Git](http://git.hackens.org/Jarvis/) ou [Github](https://github.com/hackEns/Jarvis).

## Fonctions

[…] désigne un argument optionnel, (…|…) désigne un choix obligatoire.

### Commandes directes

Toutes les commandes doivent être adressées à Jarvis directement, en les préfixant par `jarvis: `.

* `aide`

• Usage : `aide [commande]`
• Affiche l'aide de Jarvis ou de la commande passée en argument.

* `alias`

• Usage : `alias [categorie]`
• Liste tous les alias enregistrés (respectivement, ceux de la catégorie passée en argument)

* `atx`

• Usage : `atx (on|off)`
• Contrôle l'ATX de la RepRap.

* `budget`

• Usage : `budget (ajoute|retire) [dépense|crédit] montant [budget=BUDGET] commentaire`.
• `ajoute` ajoute une entrée, `retire` retire une entrée.
• `dépense` et `crédit` sont optionnels. S'ils ne sont pas spécifiés, il faut rentrer un montant algébrique.
• `budget=BUDGET` est optionnel. Si non spécifié, l'entrée du budget va sur le budget de l'année en cours. Sinon, elle va sur le budget `BUDGET`.

* `camera`

• Usage : `camera (ALIAS|ANGLE)`
• Contrôle la position de la caméra, pour déplacer la caméra à la position définie par l'alias `ALIAS` ou par l'angle `ANGLE` en dégrés.

* `courses`

• Usage : `courses (acheter|annuler|acheté) item [commentaire]`
• Note l'objet `item` comme à acheter/acheté ou le supprime de la liste de courses (`annuler`). Possibilité de rajouter un commentaire optionnel.

* `dis`

• Usage : `dis “quelque chose”`
• Fait parler Jarvis.

* `disclaimer`

• Usage : `disclaimer`
• Affiche un disclaimer.

* `emprunt`

• Usage : `emprunt outil “jj/mm hh” [email]`
• Note l'objet `outil` comme emprunté jusqu'à la date `jj/mm hh`. Si l'utilisateur n'est pas sur IRC, une adresse e-mail peut être spécifiée, pour lui renvoyer un rappel par email.

* `historique`

• Usage : `historique nb_lignes|(début fin)`
• Affiche l'historique des commandes envoyées à Jarvis. Affiche les `nb_lignes` dernière lignes, ou entre `start` et `end`.

* `info`

• Usage : `info [atx|camera|leds|stream]`
• Affiche le statut de tous les périphériques (respectivement uniquement de l'atx / de la caméra / de la lumière / du stream).

* ` jeu`

• Usage : `jeu`
• Auto-explicatif…

* `lien`

• Usage : `lien (dernier|(supprime…`
• TODO

* `log`

• Usage : `log début … fin`
• TODO

* `lumiere`

• Usage : `lumiere ((R G B)|script)`
• Contrôle la lumière associée à Jarvis, soit en la mettant à la couleur `(R G B)`, soit en appelant le script `script`.

* `moderation`

• Usage : `moderation [liste]`
• TODO

* `retour`

• Usage : `retour outil [email]`
• Marque l'outil `outil` emprunté comme retourné.

* `stream`

• Usage : `stream (on|off)`
• Lance ou arrête la diffusion de la caméra.

* `update`

• Usage : `update`
• Met à jour Jarvis.

* `version`

• Usage : `version`
• Affiche les notes de version.

### Liens

Jarvis surveille le chan `#hackens` et ajoute stocke automatiquement tous les liens postés dessus pour les afficher sur sa visu web. Pour ne pas diffuser un lien, il faut alors utiliser la commande `lien`.