Added demo.go file to, well, demo the discordgo pacakge :)

_examples/demo.go

@@ -0,0 +1,57 @@
+/******************************************************************************
+ * Discordgo demo program.
+ *
+ * Please run this with command line arguments of email and password.
+ */
+package main
+
+import (
+	"fmt"
+	"os"
+
+	discord "github.com/bwmarrin/discordgo"
+)
+
+func main() {
+
+	var err error
+	var email string = os.Args[1]
+	var password string = os.Args[2]
+
+	// Create new session object and enable debugging.
+	session := discord.Session{Debug: true}
+
+	// Login to the Discord server with the provided  email and password
+	// from the command line arguments
+	session.Token, err = session.Login(email, password)
+	if err != nil {
+		fmt.Println("Unable to login to Discord.")
+		fmt.Println(err)
+		return
+	}
+
+	// Example using Request function to query a specific URL
+	// This pulls authenticated user's information.
+	// Request returns the actual request body not JSON
+	body, err := discord.Request(&session, "http://discordapp.com/api/users/@me")
+	fmt.Println(body)
+
+	// Use the User function to do the same as above.  This function
+	// returns a User structure
+	user, err := discord.Users(&session, "@me")
+	fmt.Println(user)
+
+	// Use the Servers function to pull all available servers for a given user
+	// This returns a Server structure
+	servers, err := discord.Servers(&session, "@me")
+	fmt.Println(servers)
+
+	// Use the Channels function to pull all available channels for a given
+	// server.  This returns a Channel structure.
+	channels, err := discord.Channels(&session, servers[0].Id)
+	fmt.Println(channels)
+
+	// Use the Logout function to Logout from the Discord server.
+	discord.Logout(&session)
+	return
+}