session

Documentation

Overview

Package session abstracts around the REST API and the Gateway, managing both at once. It offers a handler interface similar to that in discordgo for Gateway events.

Index

• Variables
• type Closed
• type Session
  • func Login(email, password, mfa string) (*Session, error)
  • func New(token string) (*Session, error)
  • func NewWithGateway(gw *gateway.Gateway) *Session
  • func NewWithIntents(token string, intents ...gateway.Intents) (*Session, error)
  • func (s *Session) Close() error
  • func (s *Session) Open() error

Variables

var ErrMFA = errors.New("account has 2FA enabled")

Types

type Closed

type Closed struct {
	Error error
}

Closed is an event that's sent to Session's command handler. This works by using (*Gateway).AfterClose. If the user sets this callback, no Closed events would be sent.

Usage

ses.AddHandler(func(*session.Closed) {})

type Session

type Session struct {
	*api.Client
	Gateway *gateway.Gateway

	// Command handler with inherited methods.
	*handler.Handler

	// MFA only fields
	MFA    bool
	Ticket string
	// contains filtered or unexported fields
}

Session manages both the API and Gateway. As such, Session inherits all of API's methods, as well has the Handler used for Gateway.

func Login

func Login(email, password, mfa string) (*Session, error)

Login tries to log in as a normal user account; MFA is optional.

func New

func New(token string) (*Session, error)

New creates a new session from a given token. Most bots should be using NewWithIntents instead.

func NewWithGateway

func NewWithGateway(gw *gateway.Gateway) *Session

func NewWithIntents

func NewWithIntents(token string, intents ...gateway.Intents) (*Session, error)

func (*Session) Close

func (s *Session) Close() error

func (*Session) Open

func (s *Session) Open() error