v2.0.0 fixes and improvements

Makefile

@@ -1,5 +1,8 @@
 COVERAGE_FILE ?= c.out
 
+gotest:
+	go test -v ./... -race
+
 test:
 	@ ginkgo -cover -coverprofile=$(COVERAGE_FILE) $(RACE) ./... 
 

README.md

@@ -5,7 +5,7 @@
 [![Read Tutorial](https://badgen.now.sh/badge/Read/Tutorial/orange)](https://sbstjn.com/host-golang-slackbot-on-heroku-with-hanu.html)
 [![Code Example](https://badgen.now.sh/badge/Code/Example/cyan)](https://github.com/sbstjn/hanu-example)
 
-The `Go` framework **hanu** is your best friend to create [Slack](https://slackhq.com) bots! **hanu** uses [allot](https://github.com/sbstjn/allot) for easy command and request parsing (e.g. `whisper <word>`) and runs fine as a [Heroku worker](https://devcenter.heroku.com/articles/background-jobs-queueing). All you need is a [Slack API token](https://api.slack.com/bot-users) and you can create your first bot within seconds! Just have a look at the [hanu-example](https://github.com/sbstjn/hanu-example) bot or [read my tutorial](https://sbstjn.com/host-golang-slackbot-on-heroku-with-hanu.html) …
+The `Go` framework **hanu** is your best friend to create [Slack](https://slackhq.com) bots! **hanu** uses [allot](https://github.com/sbstjn/allot) for easy command and request parsing (e.g. `whisper <word>`) and runs fine as a [Heroku worker](https://devcenter.heroku.com/articles/background-jobs-queueing). All you need is a [Slack Bot token](https://api.slack.com/authentication/token-types#bot) and [Slack App Token](https://api.slack.com/authentication/token-types#app) for the Slack [Socket Mode](https://api.slack.com/apis/connections/socket-implement) connection.  Under the hood it uses [github.com/slack-go/slack](https://github.com/slack-go/slack) by [nlopes](https://github.com/nlopes).
 
 ### Features
 
@@ -14,7 +14,7 @@ The `Go` framework **hanu** is your best friend to create [Slack](https://slackh
 - Auto-Generated command list for `help`
 - Works fine as a **worker** on Heroku
 
-## Usage
+## V1 Usage
 
 Use the following example code or the [hanu-example](https://github.com/sbstjn/hanu-example) bot to get started.
 
@@ -29,33 +29,33 @@ import (
 )
 
 func main() {
-	slack, err := hanu.New("SLACK_BOT_API_TOKEN")
+	slack, err := hanu.New(os.Getenv("SLACK_BOT_TOKEN"), os.Getenv("SLACK_APP_TOKEN"))
 
 	if err != nil {
 		log.Fatal(err)
 	}
 
-	Version := "0.0.1"
+	version := "0.0.1"
 
-	slack.Command("shout <word>", func(conv hanu.ConversationInterface) {
-		str, _ := conv.String("word")
-		conv.Reply(strings.ToUpper(str))
+	slack.Command("shout <word>", func(c hanu.Convo) {
+		str, _ := c.String("word")
+		c.Reply(strings.ToUpper(str))
 	})
 
-	slack.Command("whisper <word>", func(conv hanu.ConversationInterface) {
-		str, _ := conv.String("word")
-		conv.Reply(strings.ToLower(str))
+	slack.Command("whisper <word>", func(c hanu.Convo) {
+		str, _ := c.String("word")
+		c.Reply(strings.ToLower(str))
 	})
 
-	slack.Command("version", func(conv hanu.ConversationInterface) {
-		conv.Reply("Thanks for asking! I'm running `%s`", Version)
+	slack.Command("version", func(c hanu.Convo) {
+		c.Reply("Thanks for asking! I'm running `%s`", version)
 	})
 
 	slack.Listen()
 }
 ```
 
-The example code above connects to Slack using `SLACK_BOT_API_TOKEN` as the bot's token and can respond to direct messages and mentions for the commands `shout <word>` , `whisper <word>` and `version`.
+The example code above connects to Slack using the tokens and can respond to direct messages and mentions for the commands `shout <word>` , `whisper <word>` and `version`.
 
 You don't have to care about `help` requests, **hanu** has it built in and will respond with a list of all defined commands on direct messages like this:
 
@@ -69,8 +69,6 @@ Of course this works fine with mentioning you bot's username as well:
 @hanu help
 ```
 
-### Slack
-
 Use direct messages for communication:
 
 ```
@@ -83,12 +81,69 @@ Or use the bot in a public channel:
 @hanu version
 ```
 
+You can set the command prefix, if you like using those:
+
+```go
+bot.SetCommandPrefix("!")
+bot.SetReplyOnly(false)
+```
+
+This will make it so you have to type:
+
+```
+!whisper I love turtles
+```
+
+The bot can also now talk arbitrarily and has a Channel object that is easy to
+interface with since it's one function:
+
+```go
+bot.Say("UGHXISDF324", "I like %s", "turtles")
+
+devops := bot.Channel("UGHXISDF324")
+devops.Say("Host called %s is not responding to pings", "bobsburgers01")
+```
+
+You can print the help message whenever you want:
+
+```go
+bot.Say("UGHXISDF324", bot.BuildHelpText())
+```
+
+And there is an unknown command handler, but it only works when in reply only mode:
+
+```go
+bot.SetReplyOnly(true).UnknownCommand(func(c hanu.Convo) {
+	c.Reply(slack.BuildHelpText())
+})
+```
+
+Finally there is the ability to read messages that come into the channel in real time:
+
+```go
+devops := bot.Channel("UGHXISDF324")
+ctx, cancel := context.WithCancel(context.Background())
+defer cancel()
+
+for {
+	select {
+	case msg := <-devops.Messages():
+		if msg.IsFrom("bob") {
+			bot.Say("shutup <@bob>")
+		}
+	case <-ctx.Done():
+		break
+	}
+}
+```
+
 ## Dependencies
 
 - [github.com/sbstjn/allot](https://github.com/sbstjn/allot) for parsing `cmd <param1:string> <param2:integer>` strings
-- [golang.org/x/net/websocket](http://golang.org/x/net/websocket) for websocket communication with Slack
+- [github.com/slack-go/slack](http://github.com/slack-go/slack) by nlopes for real time communication with Slack
 
 ## Credits
 
 - [Host Go Slackbot on Heroku](https://sbstjn.com/host-golang-slackbot-on-heroku-with-hanu.html)
 - [OpsDash article about Slack Bot](https://www.opsdash.com/blog/slack-bot-in-golang.html)
+- [A Simple Slack Bot in Go - The Bot](ttps://dev.to/shindakun/a-simple-slack-bot-in-go---the-bot-4olg)