mux

Documentation

Overview

Package mux provides a simple Discord message route multiplexer that parses messages and then executes a matching registered handler, if found. mux can be used with both Disgord and the DiscordGo library.

Index

• Variables
• type Context
• type HandlerFunc
• type Mux
  • func New() *Mux
  • func (m *Mux) FuzzyMatch(msg string) (*Route, []string)
  • func (m *Mux) OnMessageCreate(ds *discordgo.Session, mc *discordgo.MessageCreate)
  • func (m *Mux) Ping(ds *discordgo.Session, dm *discordgo.Message, ctx *Context)
  • func (m *Mux) Route(pattern, desc string, cb HandlerFunc) (*Route, error)
  • func (m *Mux) Weather(ds *discordgo.Session, dm *discordgo.Message, ctx *Context)
  • func (m *Mux) WeatherHelp(ds *discordgo.Session, dm *discordgo.Message, ctx *Context)
• type Route

Variables

var (
	WeatherAPIToken string
)

Types

type Context

type Context struct {
	Fields          []string
	Content         string
	IsDirected      bool
	IsPrivate       bool
	HasPrefix       bool
	HasMention      bool
	HasMentionFirst bool
}

Context holds a bit of extra data we pass along to route handlers This way processing some of this only needs to happen once.

type HandlerFunc

type HandlerFunc func(*discordgo.Session, *discordgo.Message, *Context)

HandlerFunc is the function signature required for a message route handler.

type Mux

type Mux struct {
	Routes  []*Route
	Default *Route
	Prefix  string
}

Mux is the main struct for all mux methods.

func New

func New() *Mux

New returns a new Discord message route mux

func (*Mux) FuzzyMatch

func (m *Mux) FuzzyMatch(msg string) (*Route, []string)

FuzzyMatch attempts to find the best route match for a given message.

func (*Mux) OnMessageCreate

func (m *Mux) OnMessageCreate(ds *discordgo.Session, mc *discordgo.MessageCreate)

OnMessageCreate is a DiscordGo Event Handler function. This must be registered using the DiscordGo.Session.AddHandler function. This function will receive all Discord messages and parse them for matches to registered routes.

func (*Mux) Ping

func (m *Mux) Ping(ds *discordgo.Session, dm *discordgo.Message, ctx *Context)

func (*Mux) Route

func (m *Mux) Route(pattern, desc string, cb HandlerFunc) (*Route, error)

Route allows you to register a route

func (*Mux) Weather

func (m *Mux) Weather(ds *discordgo.Session, dm *discordgo.Message, ctx *Context)

func (*Mux) WeatherHelp

func (m *Mux) WeatherHelp(ds *discordgo.Session, dm *discordgo.Message, ctx *Context)

type Route

type Route struct {
	Pattern     string      // match pattern that should trigger this route handler
	Description string      // short description of this route
	Help        string      // detailed help string for this route
	Run         HandlerFunc // route handler function to call
}

Route holds information about a specific message route handler