Slackscot is a slack bot written in Go. It uses Norberto Lopes's Slack API Integration found at https://github.com/nlopes/slack. The core functionality of the bot is previously used James Bowman's Slack RTM API integration and was heavily inspired by talbot, also written by James Bowman.
The first concrete bot implementation using this code was youppi, named after the great mascot of the Montreal Expos and, when the Expos left Montreal, the Montreal Canadiens.
Slackscot is a variation on the expected theme of slackbot with the implication that this is the core to more than just a regular bot. You know, a friendly company mascot that hangs out on your slack.
- Simple store API for persistence. It's basic a basic string key/string value thing.
- Basic config interface with slack token and storage path.
- Plugin interface that is a logical grouping of one or many commands and "hear actions" (listeners).
- Support for various configuration sources/formats via viper
- Support for bot services providing plugins easy access to the slack web api as well as a
user infoservice capable of cachinguser infoin memory.
- Support for reactions to message updates.
slackscotdoes the following:- Keeps track of plugin action responses and the message that triggered them
- On message updates:
- Update responses for each triggered action
- Delete responses that aren't triggering anymore (or result in errors during the message update)
- On deletion of triggering messages, responses are also deleted
- Limitation: Sending a
messageautomatically splits it into multiple slack messages when it's too long. When updating messages, this spitting doesn't happen and results in anmessage too longerror. Effectively, the last message in the initial response might getdeletedas a result. Handling of this could be better but that is the current limitation.
- Support for threaded replies to user message with option to also
broadcaston channels (disabled bydefault). See configuration example below where both are enabled. - Support for scheduled actions
- Commands: commands are well-defined actions with a format.
Slackscothandles all direct messages as implicit commands as well as@mention <command>on channels. Responses to commands are directed to the person who invoked it. - Hear actions: those are listeners that can potentially match on any message sent on channels that
slackscotis a member of. This can include actions that will randomly generate a response. Note that responses are not automatically directed to the person who authored the message triggering the response (although an implementation is free to use the user id of the triggering message if desired).
Slackscot provides the pieces to make your mascot but you'll have to assemble them for him/her to come alive.
Here's an example of how Youppi does it (apologies for the verbose and repetitive error handling when creating instances of plugins):
package main
import (
"github.com/alexandre-normand/slackscot"
"github.com/alexandre-normand/slackscot/config"
"github.com/alexandre-normand/slackscot/plugins"
"github.com/spf13/viper"
"gopkg.in/alecthomas/kingpin.v2"
"log"
"os"
)
var (
configurationPath = kingpin.Flag("configuration", "The path to the configuration file.").Required().String()
logfile = kingpin.Flag("log", "The path to the log file").OpenFile(os.O_RDWR|os.O_CREATE|os.O_APPEND, 0666)
)
func main() {
kingpin.Version(VERSION)
kingpin.Parse()
v := config.NewViperWithDefaults()
v.SetConfigFile(*configurationPath)
err := v.ReadInConfig()
if err != nil {
log.Fatalf("Error loading configuration file [%s]: %v", *configurationPath, err)
}
// Do this only so that we can get a global debug flag available to everything
viper.Set(config.DebugKey, v.GetBool(config.DebugKey))
options := make([]slackscot.Option, 0)
if *logfile != nil {
options = append(options, slackscot.OptionLogfile(*logfile))
}
youppi, err := slackscot.NewSlackscot("youppi", v, options...)
if err != nil {
log.Fatal(err)
}
karma, err := plugins.NewKarma(v)
if err != nil {
log.Fatalf("Error initializing karma plugin: %v", err)
}
defer karma.Close()
youppi.RegisterPlugin(&karma.Plugin)
fingerQuoterConf, err := config.GetPluginConfig(v, plugins.FingerQuoterPluginName)
if err != nil {
log.Fatalf("Error initializing finger quoter plugin: %v", err)
}
fingerQuoter, err := plugins.NewFingerQuoter(fingerQuoterConf)
if err != nil {
log.Fatalf("Error initializing finger quoter plugin: %v", err)
}
youppi.RegisterPlugin(&fingerQuoter.Plugin)
imager := plugins.NewImager()
youppi.RegisterPlugin(&imager.Plugin)
emojiBannerConf, err := config.GetPluginConfig(v, plugins.EmojiBannerPluginName)
if err != nil {
log.Fatalf("Error initializing emoji banner plugin: %v", err)
}
emojiBanner, err := plugins.NewEmojiBannerMaker(emojiBannerConf)
if err != nil {
log.Fatalf("Error initializing emoji banner plugin: %v", err)
}
defer emojiBanner.Close()
youppi.RegisterPlugin(&emojiBanner.Plugin)
ohMondayConf, err := config.GetPluginConfig(v, plugins.OhMondayPluginName)
if err != nil {
log.Fatalf("Error initializing oh monday plugin: %v", err)
}
ohMonday, err := plugins.NewOhMonday(ohMondayConf)
if err != nil {
log.Fatalf("Error initializing oh monday plugin: %v", err)
}
youppi.RegisterPlugin(&ohMonday.Plugin)
versioner := plugins.NewVersioner("youppi", VERSION)
youppi.RegisterPlugin(&versioner.Plugin)
err = youppi.Run()
if err != nil {
log.Fatal(err)
}
}
You'll also need to define your configuration for the core, built-in extensions and any configuration required by your own custom extensions (not shown here). Slackscot uses viper for loading configuration
which means that you are free to use a different file format (yaml, toml, etc.) as desired.
{
"token": "your-slack-bot-token",
"debug": false,
"responseCacheSize": 5000,
"timeLocation": "America/Los_Angeles",
"storagePath": "/your-path-to-bot-home",
"replyBehavior": {
"threadedReplies": true,
"broadcast": true
}
"plugins": {
"ohMonday": {
"channelId": "slackChannelId"
},
"fingerQuoter": {
"frequency": "100",
"channelIds": ""
},
"emojiBanner": {
"figletFontUrl": "http://www.figlet.org/fonts/banner.flf"
}
}
}
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent