hubot-external-commands

Purpose

This is a hubot extension designed to allow you to break free from node, coffeescript, and javascript and still have all the chat operations you'd like.

You load executable commands in the HUBOT_EXTERNAL_COMMANDS_DIR directory. Hubot then loads each file that has executable permissions as a command. Optionally if you have a <command>.desc along side the <command> executable file, it will read in the lines from the desc onto the help menu.

Setup

Install & Configure

npm install --save hubot-external-commands

edit your external-scripts.json file and add hubot-external-commands to it.

Set HUBOT_EXTERNAL_COMMANDS_DIR. (In this example it's set to $HUBOT_HOME/shell.

shell/
├── foo
├── sprint
└── sprint.desc

When loading, hubot will process the command foo with no help string. Sprint will be processed and the sprint.desc will be read for the help strings.

The contents of sprint.desc

sprint help - Display help message
sprint left - Display time left in sprint
sprint progress - Display sprint remaining information
sprint scope - Display scope change information

After loading

> !help foo
!botsnack - give the bot a food
!foo
> !help sprint
!sprint
!sprint help - Display help message
!sprint left - Display time left in sprint
!sprint progress - Display sprint remaining information
!sprint scope - Display scope change information

Caveats

• You cannot use a file with a dot "." in the filename. This breaks several the command/help processing subsystem.
• Executables/scripts must be executable and have ownership open to the hubot user
• Placing scripts in subdirectories of HUBOT_EXTERNAL_COMMANDS_DIR will not work.
• THe bot must be addressed directly to use the command. (respond vs hear). This may change in the future.

Contributors

• rick
• stahnma

License

MIT