O zzbot é um "robô" que executa funcoeszz recebidas via jabber (e, conseqüentemente, via ICQ, MSN Messenger, Yahoo Messenger etc), permitindo o uso online das funcoeszz.

Para utilizá-lo, basta adicionar o zzbot à sua lista de contatos e enviar-lhe mensagens com as funcoeszz desejadas. O zzbot atualmente atende nos seguintes serviços de mensagens instantâneas:

Jabber

zzbot@isnomore.net

ICQ

3350342

MSN Messenger

zzbot@isnomore.net

Yahoo Messenger

zz_bot [aparentemente alguém se adiantou e pegou "zzbot" :(]

Este serviço é público, gratuito e voluntário. Se for abusado, será suspenso imediatamente. Então, por favor, seja uma boa pessoa e use com responsabilidade.

Instruções de uso

Para usar o zzbot, basta adiciona-lo à sua lista de contatos de um dos serviços de mensagem acima e enviar-lhe a funcaozz que quer executar. Por exemplo:

zzdicbabylon cool

ou:

ramones

Para mais informações sobre as funcoeszz, visite http://funcoeszz.net ou envie zzajuda para o zzbot (e aguarde um pouco, a saída do zzajuda é longa e pode levar algum tempo para chegar). Você pode também experimentar enviar função --help, para obter ajuda sobre uma função específica (obviamente trocando função pela função desejada). Algumas funcoeszz geram saída vazia quando usadas incorretamente, portanto, neste caso, use algum dos métodos de ajuda para tentar entender o que houve.

Para obter ajuda específica sobre o zzbot, envie ? ou ajuda. Enviar ? funciona mesmo quando o comando estiver "fixo" (ver instruções abaixo).

As funcoeszz podem ou não ser iniciadas por zz, exceto zzajuda, que precisa ser iniciada por zz para diferenciá-la do comando ajuda do zzbot.

Algumas funções não estão disponíveis, por motivo de segurança ou porque não fazem sentido serem executadas online (por exemplo, zzarrumanome).

O zzbot possui alguns comandos especiais para facilitar seu uso e deixá-lo mais poderoso. Estes comandos (chamados comandos zzbot) são utilizados com mensagens iniciadas pela palavra zzbot. Os comandos zzbot são específicos para cada usuário (isto é, os que você enviar não vão afetar outros usuários) e, atualmente, são os seguintes:

zzbot fixa <comando>

Fixa <comando> para as mensagens seguintes. Assim, se for enviado, por exemplo, zzbot fixa zzdicbabylon, as mensagens seguintes serão tratadas como parâmetros para a função zzdicbabylon (ou seja, neste exemplo, basta enviar as palavras a serem traduzidas). Mesmo que o comando esteja fixo, enviar ? para o zzbot sempre devolve a mensagem de ajuda. Comandos zzbot também continuam funcionando mesmo quando o comando está fixo. Ou seja, comandos fixos não recebem mensagens que comecem com ? ou com zzbot.

zzbot libera

"Desliga" o comando que tenha sido fixo da forma acima.

zzbot fixo

Verifica se há algum comando fixo.

O zzbot possui alguns comandos administrativos (disponíveis somente para administradores cadastrados no zzbot). Estes comandos são iniciados por zzbot admin e, atualmente, são os seguintes:

zzbot admin listausuarios

Devolve uma lista dos usuários registrados no zzbot. Atualmente, usuários são registrados quando executam um comando zzbot, mas isso pode mudar no futuro.

zzbot admin listaadmins

Devolve uma lista dos administradores deste zzbot.

O software

O zzbot é um programa em Python licenciado sob a GNU GPL. Para rodá-lo, são necessários Python >= 2.4, as funcoeszz (com permissão de execução), a biblioteca PyXMPP e uma conta em um servidor jabber. A configuração é feita no arquivo $HOME/.zzbot/zzbot.cf do usuário que estiver executando o zzbot.

Desenvolvimento

Bugs, críticas ou sugestões podem ser enviadas para zzbot-devel@isnomore.net.

Para participar do desenvolvimento, inscreva-se na lista zzbot-devel@isnomore.net enviando um e-mail vazio para zzbot-devel-subscribe@isnomore.net. Para enviar patches, por favor use o formato unificado (diff -u), e lembre-se de enviar seu código acompanhado dos devidos testes!

Download

O zzbot está sofrendo um refatoramento pesado, no momento (Abril-Maio/2007). Assim que estiver estável, poderá ser baixado aqui.

Nesse meio tempo, é possível acompanhar o desenvolvimento pelo repositório svn.