ctrldavid / so-chatbot Goto Github PK

For usage info, on how to use the bot, see here.

###Running the bot### The bot is currently a big dangle-on script running in your browser. Run bookmarklet.js in your browser to get it up an' running.

###Building### (For build minification, install uglify-js2)

#one must first get the repo
$ git clone git://github.com/Zirak/SO-ChatBot.git
$ cd SO-ChatBot

The provided publi.sh automagically does building, adds all changed items to commit and publishes for you:

$ ./publi.sh commit-message

To build manually:

$ node build.js
#to skip minification
$ node build.js no-min

The result will be in master.js and master.min.js

###The Bot API### (, a very short explanation of a limited subset of)

For a real cover, check the source code or this wiki page or console.log(bot). Should be straightforward.

//add a bot command
bot.addCommand({
    name : 'command_name',
    fun : commandFunction,

    //permissions object (can be ommitted for all-can-use, all-can-del)
    permissions : {
        use : 'NONE' /*or*/ 'ALL' /*or*/ [array of usrids],
        del : 'NONE' /*or*/ 'ALL' /*or*/ [array of usrids]
    },

    //whether the command is asynchronous or not (default false)
    async : true /*or*/ false
});

//add a listening regex and a corresponding callback
bot.listen(
    //regular expression or array of regular expressions
    pattern,

    callbackFun
);