brunobord/cmdbot

CmdBot, a bot with `cmd` attitude

cmdbot's Issues

Brain should have a "do you know that" mechanism

the if hasattr() method looks ugly. Maybe we should add a method to the "brain" object that indicates if the Brain knows.

Something like:

if self.brain.knows('number_of_stuff'):
    self.say("something else")

a "quit" command?

a command to make the bot leave, disconnect. don't know if it's valuable.

better doc: readthedocs.org?

Why not having a nice Sphinx-based readthedocs documentation?

at least 2 sections:

• usage
• make a brainier bot (doc for devs)

didn't reply with "nick,"

the bot didn't reply to:

cmdbot, action

should have triggered the action.

a 'reply' helper

To reply to a direct message. as simple as it sounds.

a "restart" command, at least to reload configuration

restart would:

• make the bot quit ,
• reload configuration file, to refresh the admin list, for example,
• reconnect to servers, chans and all

i18n: translate strings

At least the "said" messages.

• Make them translatable.
• make the french translation
• provide a simple way to build extended brainybots with i18n (doc)

using setup.py or pip, locale should be loaded

looks like locale dirs aren't loaded when installed via setup.py or pip install.
pretty painful, it looks like you have to copy all of them in the right directory, and load it via gettext afterwards.
and I thought it was fun...

a more clever "run"

the main run depends way too much on the "bot.ini" file. We need it to be more hidden underneath the run() method, that should parse arguments, load configuration, etc.

bad encoding handling...

My bot has read an IRC line in #django-fr and has fumbled, because of a bad encoding error. Need more security around encodings.

looks like @admin decorator doesn't work

the line is fully interpreted, but the admin decorator doesn't return the command if the nick is in the admin.

BTW, having a summary of the configuration can't be a bad thing on startup...

help should fetch docstrings

the help [command] should fetch the do_[command] docstring to provide needed help.

the "noverb" action

need a function that triggers whenever cmdbot is receiving a line, that just does "pass", and that a developer can override to fit its needs.

or maybe a decorator to tell cmdbot to execute a series of actions.

explain how to use decorators

explain how to use:

• direct
• admin

And how to build new decorators

Command aliases

aliases for commands. "à la" cmd, probably. Need docs.

planned tasks

decorate some tasks that would be executed under certain conditions (what time/day it is, for a start)

Property "no_help"

Do not display help for "hidden" commands. they wont appear in "help" and you can't make "help "

logging level at the bot level

The logging is set in the core module. Bad. Should be able to set a logging from the Bot itself, to adjust the logging level.

UnicodeDecodeError

This is probably just an error with my setup, but I got this error on a pretty default setup of ircd-hybrid.

INFO:root:Translation Not Found. Fallback to default
INFO:root:Connection to host...
Connection to host...
Traceback (most recent call last):
File "./eightball.py", line 33, in
bot.run()
File "/home/bot/env/lib/python2.7/site-packages/cmdbot/core.py", line 177, in run
readbuffer = readbuffer + self.s.recv(1024).decode('utf8')
File "/home/bot/env/lib/python2.7/encodings/utf_8.py", line 16, in decode
return codecs.utf_8_decode(input, errors, True)
UnicodeDecodeError: 'utf8' codec can't decode byte 0xc3 in position 1023: unexpected end of data

I was able to get the bot to work though by changing line 177 of cmdbot/core.py to the following

try:
    readbuffer = readbuffer + self.s.recv(1024).decode('utf')
except UnicodeDecodeError:
    continue