module

Documentation

Index

• type Config
  • func (cfg *Config) UnmarshalYAML(unmarshal func(interface{}) error) error
• type IQHandler
• type Module
• type Modules
  • func New(config *Config, router *router.Router) *Modules
  • func (m *Modules) ProcessIQ(iq *xmpp.IQ, stm stream.C2S)
  • func (m *Modules) Shutdown(ctx context.Context) error

Types

type Config

type Config struct {
	Enabled      map[string]struct{}
	Roster       roster.Config
	Offline      offline.Config
	Registration xep0077.Config
	Version      xep0092.Config
	Ping         xep0199.Config
}

Config represents C2S modules configuration.

func (*Config) UnmarshalYAML

func (cfg *Config) UnmarshalYAML(unmarshal func(interface{}) error) error

UnmarshalYAML satisfies Unmarshaler interface.

type IQHandler

type IQHandler interface {
	Module

	// MatchesIQ returns whether or not an IQ should be
	// processed by the module.
	MatchesIQ(iq *xmpp.IQ) bool

	// ProcessIQ processes a module IQ taking according actions
	// over the associated stream.
	ProcessIQ(iq *xmpp.IQ, stm stream.C2S)
}

IQHandler represents an IQ handler module.

type Module

type Module interface {
}

Module represents a generic XMPP module.

type Modules

type Modules struct {
	Roster       *roster.Roster
	Offline      *offline.Offline
	LastActivity *xep0012.LastActivity
	Private      *xep0049.Private
	DiscoInfo    *xep0030.DiscoInfo
	VCard        *xep0054.VCard
	Register     *xep0077.Register
	Version      *xep0092.Version
	BlockingCmd  *xep0191.BlockingCommand
	Ping         *xep0199.Ping
	// contains filtered or unexported fields
}

Modules structure keeps reference to a set of preconfigured modules.

func New

func New(config *Config, router *router.Router) *Modules

New returns a set of modules derived from a concrete configuration.

func (*Modules) ProcessIQ

func (m *Modules) ProcessIQ(iq *xmpp.IQ, stm stream.C2S)

ProcessIQ process a module IQ returning 'service unavailable' in case it can't be properly handled.

func (*Modules) Shutdown

func (m *Modules) Shutdown(ctx context.Context) error