Interacting with the bot
Clone this wiki locally
You run commands by sending
!!/commandName [commandArg0, [commandArg1, [...]]]
In a chatroom where the bot is present.
Will print something like this:
@yourUsername help, listen, eval, live, die, refresh, forget, ban, unban, info, jquery, choose, user, listcommands, purgecommands, define, norris, urban, parse, tell, mdn, beautify, convert, get, github-status, google, hang, learn, nudge, spec, stat, todo, undo
!! is how you get the bot's attention. It looks at your message, line by line, and if a line starts with the invocation pattern, the bot reacts to that line. Do note that
!! is simply the default, but it can be changed - for instance, in the online demo, you don't need to provide a prefix at all.
/ signifies "the following is a command". With the
/, the bot tries to get the command desired, and call it with the given arguments. It then sends the result of the command to the user. If no command matching that name is found, it tries to find command names which look similar. Command-names are case insensitive.
/, the bot tries to match the message against a series of regular-expressions, specified in
bot.listeners. If a match is found, it executes the pairing callback, and like a command, relays the result to the user.
You can also provide it with
!!> ['hello', 'world'].join(' ') :42 "hello world"
c> which evaluates as CoffeeScript:
!!c> ['hello', 'world'].join ' ' :42 "hello world"
If nothing above matches, it prints out a semi-helpful error message: Y U NO MAEK SENSE!?
(Note on special syntax: I notate optional arguments with
, but they do not actually appear in the invocation. So
!!/commandName [arg0 [arg1 [...]]] means all these:
!!/commandName arg0 !!/commandName arg0 arg1 !!/commandName arg0 arg1 argN
Are all valid. While discussing syntax, default values be given to optional arguments like
name=default, but again, the
name= part does not appear.
!!/commandName [foo=bar] means that lacking the first argument, its value will be
bar, meaning that the following two are identical:
!!/commandName !!/commandName bar
These will be present throughout the wiki and in bot help messages. But enough about fish, let's discuss cutlery.)