Asjon ROBOT

Asjon è un chat bot creato usando l'Hubot framework.

Asjon può:

• cercare immagini e gif su internet
• cercare video di youtube
• riportare il meteo
• ricordare nozioni o date
• creare memes
• fare calcoli e risolvere problemi con wolfram|alpha
• inviare immagini di RMS
• invitare persone in un gruppo di telegram
• dare informazioni sui propri contatti
• aprire reverse shell
• aggiornarsi ed eseguire test autonomamente
• e altro ancora

Asjon è sviluppato in collaborazione con gli studenti della 5IA (2014/2015) dell'IIS Galileo Galilei di Crema.

Usare Asjon

Asjon è sempre online su Telegram con l'username Asjon ROBOT

Sviluppare Asjon

Puoi testare asjon seguendo queste istruzioni, però alcuni componenti necessitano di variabili d'ambiente particolari per essere configurati correttamente (ad esempio i dati di accesso al registro elettronico per l'agenda)

Dipendenze

Asjon necessita di:

• node e npm
• redis se si vuole salvare la sua memoria in maniera persistente
• telegram-cli con supporto python per l'adapter di telegram

Installazione

Si consiglia di usare di usare nix per gestire le dipendenze. È presente un'espressione nix.shell nella root del progretto che può essere usata semplicemente eseguendo

$ nix-shell

nella directory. Nella nuova shell installare asjon con

$ npm install

Utilizzo

Puoi avviare asjon tramite nix-shell con

$ nix-shell --arg mode \"run\"

Altre mode possibili sono:

• runTg: avvia asjon sull'adapter di telegram (è necessario fare il login al primo utilizzo)
• test: esegui i test d'integrità
• shell (default): apre una nix-shell

Puoi anche avviare asjon manualmente eseguendo

$ bin/hubot

Se tutto va bene dovrebbe comparire una cosa del genere:

[Sat Feb 28 2015 12:38:27 GMT+0000 (GMT)] INFO Using default redis on localhost:6379
asjon>

Puoi interagire con asjon scrivendo asjon help o qualsiasi altro suo comando.

Test

Asjon dispone di alcuni test d'integrità nella cartella test/.

Per eseguirli, occorre:

1. installare mocha tramite npm install -g mocha (potrebbe essere necessario sudo)
2. lanciare i test tramite npm test dalla cartella della repo
3. opzionalmente è possibile generare i report di copertura dei test usando npm run coverage-html o npm run coverage-json in base al formato desiderato.

Nota Bene: è opportuno eseguire sempre i test d'integrità prima di contribuire una modifica. Ancora meglio sarebbe allegare dei test di integrità insieme alle nuove funzioni aggiunte

Scripting

Gli script di Asjon sono nella cartella scripts. La Scripting Guide di hubot è molto utile per imparare come funzionano

Hosting

Asjon può essere hostato come un qualsiasi Hubot.

Il ramo master di Asjon è sempre hostato online ed è accessibile tramite telegram all'username Asjon ROBOT.

Licenza

Hubot e Asjon sono distribuiti sotto la MIT License