webhooks

Documentation

Index

• Constants
• type ApplyResult
• type Config
• type DefaultSlackClient
  • func (d *DefaultSlackClient) AuthTest() error
  • func (d *DefaultSlackClient) ChannelExists(channelName string) (bool, error)
  • func (d *DefaultSlackClient) PostMessage(channel string, applyResult ApplyResult) error
  • func (d *DefaultSlackClient) TokenIsSet() bool
• type MultiWebhookSender
  • func NewMultiWebhookSender(configs []Config, client SlackClient) (*MultiWebhookSender, error)
  • func (w *MultiWebhookSender) Send(log logging.SimpleLogging, result ApplyResult) error
• type Sender
• type SlackClient
  • func NewSlackClient(token string) SlackClient
• type SlackWebhook
  • func NewSlack(r *regexp.Regexp, channel string, client SlackClient) (*SlackWebhook, error)
  • func (s *SlackWebhook) Send(log logging.SimpleLogging, applyResult ApplyResult) error
• type UnderlyingSlackClient

Constants

const ApplyEvent = "apply"

const SlackKind = "slack"

Types

type ApplyResult

type ApplyResult struct {
	Workspace string
	Repo      models.Repo
	Pull      models.PullRequest
	User      models.User
	Success   bool
	Directory string
}

ApplyResult is the result of a terraform apply.

type Config

type Config struct {
	Event          string
	WorkspaceRegex string
	Kind           string
	Channel        string
}

type DefaultSlackClient

type DefaultSlackClient struct {
	Slack UnderlyingSlackClient
	Token string
}

func (*DefaultSlackClient) AuthTest

func (d *DefaultSlackClient) AuthTest() error

func (*DefaultSlackClient) ChannelExists

func (d *DefaultSlackClient) ChannelExists(channelName string) (bool, error)

func (*DefaultSlackClient) PostMessage

func (d *DefaultSlackClient) PostMessage(channel string, applyResult ApplyResult) error

func (*DefaultSlackClient) TokenIsSet

func (d *DefaultSlackClient) TokenIsSet() bool

type MultiWebhookSender

type MultiWebhookSender struct {
	Webhooks []Sender
}

MultiWebhookSender sends multiple webhooks for each one it's configured for.

func NewMultiWebhookSender

func NewMultiWebhookSender(configs []Config, client SlackClient) (*MultiWebhookSender, error)

func (*MultiWebhookSender) Send

func (w *MultiWebhookSender) Send(log logging.SimpleLogging, result ApplyResult) error

Send sends the webhook using its Webhooks.

type Sender

type Sender interface {
	// Send sends the webhook (if the implementation thinks it should).
	Send(log logging.SimpleLogging, applyResult ApplyResult) error
}

Sender sends webhooks.

type SlackClient

type SlackClient interface {
	AuthTest() error
	TokenIsSet() bool
	ChannelExists(channelName string) (bool, error)
	PostMessage(channel string, applyResult ApplyResult) error
}

SlackClient handles making API calls to Slack.

func NewSlackClient

func NewSlackClient(token string) SlackClient

type SlackWebhook

type SlackWebhook struct {
	Client         SlackClient
	WorkspaceRegex *regexp.Regexp
	Channel        string
}

SlackWebhook sends webhooks to Slack.

func NewSlack

func NewSlack(r *regexp.Regexp, channel string, client SlackClient) (*SlackWebhook, error)

func (*SlackWebhook) Send

func (s *SlackWebhook) Send(log logging.SimpleLogging, applyResult ApplyResult) error

Send sends the webhook to Slack if the workspace matches the regex.

type UnderlyingSlackClient

type UnderlyingSlackClient interface {
	AuthTest() (response *slack.AuthTestResponse, error error)
	GetConversations(conversationParams *slack.GetConversationsParameters) (channels []slack.Channel, nextCursor string, err error)
	PostMessage(channel, text string, parameters slack.PostMessageParameters) (string, string, error)
}

UnderlyingSlackClient wraps the nlopes/slack.Client implementation so we can mock it during tests.