Merge pull request #31 from circa10a/slack-provider

Slack provider

Author: circa10a

README.md

@@ -44,6 +44,7 @@ Currently supported providers:
 
 - [Discord](providers/discord/README.md)
 - [Rocket.Chat](providers/rocketchat/README.md)
+- [Slack](providers/slack/README.md)
 - [SMTP (email)](providers/smtp/README.md)
 - [Yammer](providers/yammer/README.md)
 

config.yaml

@@ -2,15 +2,14 @@ providers:
   discord:
     enabled: false
     webhookURL: "https://discordapp.com/api/webhooks/{webhook.id}/{webhook.token}"
-  yammer:
-    enabled: false
-    APIURL: https://www.yammer.com/api/v1/messages.json
-    groupID: 123456
-    token: somesecrettext
   rocketchat:
     enabled: false
     webhookURL: "https://<rocket-chat-server-here>/hooks/{token}"
-    iconURL: "https://a0.awsstatic.com/libra-css/images/logos/aws_logo_smile_1200x630.png"
+    iconURL: "https://cdn.iconscout.com/icon/free/png-256/aws-1869025-1583149.png"
+  slack:
+    enabled: false
+    webhookURL: "https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX"
+    iconURL: "https://cdn.iconscout.com/icon/free/png-256/aws-1869025-1583149.png"
   smtp:
     enabled: false
     server: "smtp.gmail.com"
@@ -24,4 +23,9 @@ providers:
       - "some.email@mail.com"
       - "some.other@mail.com"
     # customTemplate: path/to/template.html
+  yammer:
+    enabled: false
+    APIURL: https://www.yammer.com/api/v1/messages.json
+    groupID: 123456
+    token: somesecrettext
 

providers.go

@@ -3,6 +3,7 @@ package main
 import (
 	_ "github.com/circa10a/go-aws-news/providers/discord"
 	_ "github.com/circa10a/go-aws-news/providers/rocketchat"
+	_ "github.com/circa10a/go-aws-news/providers/slack"
 	_ "github.com/circa10a/go-aws-news/providers/smtp"
 	_ "github.com/circa10a/go-aws-news/providers/yammer"
 )

providers/rocketchat/README.md

@@ -27,8 +27,8 @@ providers:
     iconURL: "{ override url to aws logo }"
 ```
 
-[webhook]:https://rocket.chat/docs/administrator-guides/integrations/
-
 __Example post:__
 
 ![Rocketchat post example](https://i.imgur.com/4bKSTcf.png)
+
+[webhook]:https://rocket.chat/docs/administrator-guides/integrations/

providers/slack/README.md

@@ -0,0 +1,27 @@
+# Slack Setup
+
+1. In Slack, click "Add more apps" on the left sidebar.
+1. In the search field, type "webhook".
+1. Select __Incoming WebHooks__.
+1. Click __Add to Slack__.
+1. Select the channel to post to.
+1. Click __Add Incoming WebHooks integration__.
+1. Copy the generated webhook URL and paste it in to the [config.yaml](/config.yaml) under
+  `providers.slack.webhookURL`. The webhook format will look similar to this:
+
+## Example Config
+
+```yaml
+providers:
+  slack:
+    enabled: true
+    iconURL: "https://cdn.iconscout.com/icon/free/png-256/aws-1869025-1583149.png"
+    webhookURL: "https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX"
+```
+
+__Example post:__
+
+![Slack post example](https://i.imgur.com/iw2SCJZ.png)
+
+
+[webhooks]:https://api.slack.com/messaging/webhooks

providers/slack/slack.go

@@ -0,0 +1,82 @@
+package slack
+
+import (
+	"bytes"
+	"encoding/json"
+	"fmt"
+	"net/http"
+	"strings"
+
+	"github.com/circa10a/go-aws-news/providers"
+
+	"github.com/circa10a/go-aws-news/news"
+	log "github.com/sirupsen/logrus"
+	"gopkg.in/yaml.v2"
+)
+
+type config struct {
+	Providers struct {
+		Provider Provider `yaml:"slack"`
+	} `yaml:"providers"`
+}
+
+// Provider is an implementation of the `go-aws-news/providers` Provider interface.
+type Provider struct {
+	IsEnabled  bool   `yaml:"enabled"`
+	WebhookURL string `yaml:"webhookURL"`
+	IconURL    string `yaml:"iconURL"`
+}
+
+// Content is sent as json to the Rocket.Chat webhook endpoint.
+type Content struct {
+	Username string `json:"username"`
+	IconURL  string `json:"icon_url"`
+	Text     string `json:"text"`
+}
+
+// init initializes the provider from the provided config.
+func init() {
+	var c config
+	if err := yaml.Unmarshal(providers.Config, &c); err != nil {
+		log.Fatal(err)
+	}
+
+	providers.RegisterProvider(&c.Providers.Provider)
+}
+
+// Enabled returns true if the provider is enabled in the config.
+func (p *Provider) Enabled() bool {
+	return p.IsEnabled
+}
+
+// GetName returns the Provider's name.
+func (*Provider) GetName() string {
+	return "slack"
+}
+
+// Notify is the function executed to POST to a provider's webhook url.
+func (p *Provider) Notify(news news.Announcements) {
+
+	var b strings.Builder
+	for _, v := range news {
+		b.WriteString(fmt.Sprintf("<%s|%s> - %s\n", v.Link, v.Title, v.PostDate))
+	}
+
+	content := &Content{
+		Username: "AWS News",
+		IconURL:  p.IconURL,
+		Text:     b.String(),
+	}
+
+	json, err := json.Marshal(content)
+	if err != nil {
+		log.Error(fmt.Sprintf("[%s] %v", p.GetName(), err))
+	}
+
+	log.Info(fmt.Sprintf("[%v] Firing notification", p.GetName()))
+	res, err := http.Post(p.WebhookURL, "application/json", bytes.NewBuffer(json))
+	if err != nil {
+		log.Error(fmt.Sprintf("[%s] %v", p.GetName(), err))
+	}
+	defer res.Body.Close()
+}