80 lines
3 KiB
Go
80 lines
3 KiB
Go
/******************************************************************************
|
|
* A Discord API for Golang.
|
|
*
|
|
* This file has structs and functions specific to a session.
|
|
*
|
|
* A session is a single connection to Discord for a given
|
|
* user and all REST and Websock API functions exist within
|
|
* a session.
|
|
*
|
|
* See the restapi.go and wsapi.go for more information.
|
|
*/
|
|
|
|
package discordgo
|
|
|
|
import "github.com/gorilla/websocket"
|
|
|
|
// A Session represents a connection to the Discord REST API.
|
|
// token : The authentication token returned from Discord
|
|
// Debug : If set to ture debug logging will be displayed.
|
|
type Session struct {
|
|
Token string // Authentication token for this session
|
|
Debug bool // Debug for printing JSON request/responses
|
|
Cache int // number in X to cache some responses
|
|
|
|
// Settable Callback functions for Websocket Events
|
|
OnEvent func(*Session, Event) // should Event be *Event?
|
|
OnReady func(*Session, Ready)
|
|
OnTypingStart func(*Session, TypingStart)
|
|
OnMessageCreate func(*Session, Message)
|
|
OnMessageUpdate func(*Session, Message)
|
|
OnMessageDelete func(*Session, MessageDelete)
|
|
OnMessageAck func(*Session, MessageAck)
|
|
OnPresenceUpdate func(*Session, PresenceUpdate)
|
|
OnVoiceStateUpdate func(*Session, VoiceState)
|
|
OnChannelCreate func(*Session, Channel)
|
|
OnChannelUpdate func(*Session, Channel)
|
|
OnChannelDelete func(*Session, Channel)
|
|
OnGuildCreate func(*Session, Guild)
|
|
OnGuildUpdate func(*Session, Guild)
|
|
OnGuildDelete func(*Session, Guild)
|
|
OnGuildMemberAdd func(*Session, Member)
|
|
OnGuildMemberRemove func(*Session, Member)
|
|
OnGuildMemberDelete func(*Session, Member) // which is it?
|
|
OnGuildMemberUpdate func(*Session, Member)
|
|
OnGuildRoleCreate func(*Session, Role)
|
|
OnGuildRoleUpdate func(*Session, GuildRoleUpdate)
|
|
OnGuildRoleDelete func(*Session, Role)
|
|
OnGuildIntegrationsUpdate func(*Session, GuildIntegrationsUpdate)
|
|
|
|
// OnMessageCreate func(Session, Event, Message)
|
|
// ^^ Any value to passing session, event, message?
|
|
// probably just the Message is all one would need.
|
|
// but having the sessin could be handy?
|
|
|
|
wsConn *websocket.Conn
|
|
//TODO, add bools for like.
|
|
// are we connnected to websocket?
|
|
// have we authenticated to login?
|
|
// lets put all the general session
|
|
// tracking and infos here.. clearly
|
|
}
|
|
|
|
/******************************************************************************
|
|
* The below functions are "shortcut" methods for functions in restapi.go
|
|
* Reference the client.go file for more documentation.
|
|
*/
|
|
func (s *Session) Self() (user User, err error) {
|
|
user, err = s.User("@me")
|
|
return
|
|
}
|
|
|
|
func (s *Session) MyPrivateChannels() (channels []Channel, err error) {
|
|
channels, err = s.UserChannels("@me")
|
|
return
|
|
}
|
|
|
|
func (s *Session) MyGuilds() (servers []Guild, err error) {
|
|
servers, err = s.UserGuilds("@me")
|
|
return
|
|
}
|