discordgo/discord.go

/******************************************************************************
 * Discordgo v0 by Bruce Marriner <bruce@sqls.net>
 * A Discord API for Golang.
 *
 * Currently only the REST API is functional.  I will add on the websocket
 * layer once I get the API section where I want it.
 *
 */

package discordgo

// These will absolutely change.  I already don't like them.
// Constants that define the different Discord API URLs.
const (
	discordUrl = "http://discordapp.com"
	discordApi = discordUrl + "/api/"
	servers    = discordApi + "guilds"
	channels   = discordApi + "channels"
	users      = discordApi + "users"
)

// A Discord structure represents a all-inclusive (hopefully) structure to
// access the Discord REST API for a given authenticated user.
type Discord struct {
	Session Session
	User    User
	Servers []Server
}

// New creates a new connection to Discord and returns a Discord structure.
// This provides an easy entry where most commonly needed information is
// automatically fetched.
func New(email string, password string) (discord *Discord, err error) {

	session := Session{}

	session.Token, err = session.RequestToken(email, password)
	if err != nil {
		return
	}

	user, err := session.Self()
	if err != nil {
		return
	}

	servers, err := session.Servers()

	discord = &Discord{session, user, servers}

	return
}

// Renew essentially reruns the New command without creating a new session.
// This will update all the user, server, and channel information that was
// fetched with the New command.  This is not an efficient way of doing this
// but if used infrequently it does provide convenience.
func (discord *Discord) Renew() (err error) {

	discord.User, err = discord.Session.Self()
	discord.Servers, err = discord.Session.Servers()

	return
}