Python:BotSottile/Guida

BotSottile è (anche) un bot IRC scritto in python, cioè un programma che partecipa a uno o piu canali di chat su tale rete.
BotSottile è attivo su freenode attraverso il server calvino.freenode.net. Pe conoscere i canali dove opera digitare in IRC un delle seguenti stringhe:

• /msg BotSottile BotSottile: help
• /whois BotSottile

Sotto sono elencati i comandi disponibili.
Se si è interessati al codice sorgente esso è gratuitamente disponibile mediante svn all'indirizzo svn://filosottile.no-ip.org/phenny.BotSottile/trunk nella versione adattata per chi volesse usarlo per se, chi invece volesse l'esatta versione attiva in quel momento è pregato di chiedere su ##BotSottile.

Si ringraziano sbp per lo sviluppo del framework di base e Filnik per alcune modifiche.

Comandi pubblici

''link''

Riporta il link al progetto wikimedia correlato al canale (per modificare la destinazione del link si puo usare la sintassi degli interwiki), per evitare il linking apporre un "!", un "*" o un "." prima del link.

BotSottile: help

Visualizza le informazioni principali sul bot, in particolare visualizza gli amministratori del bot e i canali su cui opera.

BotSottile: ping

Il bot risponde semplicemente con pong nel minor tempo possibile.

BotSottile: remind me in h:m:s ...

Riporta ciò che gli è stato detto dopo il tempo indicato.

.tor ip

Indica se l'ip è un exit node tor.

.proxy ip

Indica se l'ip è registrato come open proxy. Attenzione: il risultato è puramente indicativo.

.luxo user/ip

Riporta un link al sistema di elenco contributi wikimedia globale di luxo.

.info user progetto

(es. .info FiloSottile itwiki)
Editcount, flags (sysop, burocrate...), data registrazione ed eventuali blocchi.
Per il parametro progetto si possono usare le sigle di wikipedia, wikizionario ed alcuni altri, l'intero nome (es. itwikipedia) o il dominio (es. it.wikipedia.org).

.c user/ip

Riporta un link ai contributi del tale utente con un parametro che fa in modo che se gli admin useranno il tasto rollback da quella pagina il rollback sarà segnato come bot e non figurerà nelle RC.

.globalblock/blocked ip

Indica se l'ip in questione è stato bloccato globalmente sui progetti wikimedia.

.en/nl/it/de/fr/ar[wiki] pagina

Visualizza la prima riga della data pagina su Wikipedia.

.seen nick

Visualizza l'ultima volta che ha visto nick e in quale chan.

.val/validate sito

Effettua il test della pagina indicata con http://validate.w3.com

.time [ gmt / utc / n ]

Visualizza l'ora corrente. Senza parametri ritorna l'ora italiana, con parametro un numero (anche negativo) restituisce l'ora della fascia oraria GMT+n. Accetta anche alcune sigle come UTC, GMT, CET... e alcune sigle di città.

.web sito

Estrae la prima riga del sito indicato.

.bytes/repres stringa

Visualizza la rappresentazione della stringa.

Comandi disponibili solo in inglese

.ety/etymology parola

Visualizza l'etimologia di una parola inglese.

.synonym/thesaurus parola

Visualizza i sinonimi di una parola inglese.

.map postalcode

Visualizza il link per la mappa corrispondente al codice postale UK indicato.

Comandi per chan-ops

BotSottile è inoltre specializzato nella semplificazione della gestione dei canali. Per permettere a BotSottile di svolgere queste funzioni bisogna conferirgli i flags +ot presso ChanServ. Per utilizzarle, invece, bisogna figurare in questa lista e essere identificati presso i services.

.exit

Fa uscire il bot dal canale. Si consiglia di usare questo perchè con un kick o un ban il bot rientrerà o andrà in loop.

.op [ nick ]

Da i privilegi di op all'utente specificato. Se non viene specificato un utente oppa chi ha usato il comando. (/msg ChanServ op chan nick)

.deop [ nick ]

Toglie i privilegi di op all'utente specificato. Se non viene specificato un utente deoppa chi ha usato il comando. (/msg ChanServ op chan -nick)

.voice [ nick ]

Da i privilegi di voice all'utente specificato. Se non viene specificato un utente voicia chi ha usato il comando. (/msg ChanServ voice chan nick)

.devoice [ nick ]

Toglie i privilegi di voice all'utente specificato. Se non viene specificato un utente devoicia chi ha usato il comando. (/msg ChanServ voice chan -nick)

.topic testo

Imposta il topic del canale al testo indicato. (/msg ChanServ topic chan testo)

.invite nick

Invita nel canale l'utente specificato. (/invite nick)

.kick nick

Espelle dal canale l'utente specificato. (/remove chan nick)

.ban nick

Bandisce dal canale l'utente specificato. La mask viene ottenuta mediante NickServ (/msg NickServ info nick) o se non è possibile attraverso whois (/whois nick) quindi è fattibile anche con utenti non nel chan o non in linea in quel momento.
Questo è un processo complesso e puo presentare imperfezioni. (/ban *!*@mask)