Няма описание

Bruce Marriner c07ce445a0 No longer used. преди 9 години
.travis.yml 2af61ea2c5 First commit of Travis CI file преди 9 години
LICENSE bc323b57a1 Initial commit преди 9 години
README.md 9b1b8b2e5c Added Gowalker link преди 9 години
endpoints.go 4e6a538961 Changed to HTTPS REST connection преди 9 години
guild.go 3e605c64a6 Moving all structs to structs.go for now. преди 9 години
restapi.go dd1d8eabbf Fixed several functions incorrectly returning an Array - THANK YOU Pikachu :) преди 9 години
structs.go f789b29a8d Use the right websockets. преди 9 години
users.go 3e605c64a6 Moving all structs to structs.go for now. преди 9 години
util.go f655167761 Several updates to make library more idiomatic Go преди 9 години
voice.go 221e54ee5a Don't want to send voice speaking on OP4, that's silly. преди 9 години
wsapi.go 3e605c64a6 Moving all structs to structs.go for now. преди 9 години

README.md

Discordgo

This package provides low level bindings for the Discord REST & Websocket API in the Go Programming Language (Golang).

GoDoc Go Walker Go report Build Status

Usage Example

package main

import (
	"fmt"
	"time"

	"github.com/bwmarrin/discordgo"
)

func main() {

	var err error

	// Create a new Discord Session and set a handler for the OnMessageCreate
    // event that happens for every new message on any channel
	Session := discordgo.Session{
		OnMessageCreate: messageCreate,
	}

	// Login to the Discord server and store the authentication token
	// inside the Session
	Session.Token, err = Session.Login("coolusername", "cleverpassword")
	if err != nil {
		fmt.Println(err)
		return
	}

	// Open websocket connection
	err = Session.Open()
	if err != nil {
		fmt.Println(err)
	}

	// Do websocket handshake.
	err = Session.Handshake()
	if err != nil {
		fmt.Println(err)
	}

	// Listen for events.
	Session.Listen()
	return
}

func messageCreate(s *discordgo.Session, m discordgo.Message) {
	fmt.Printf("%25d %s %20s > %s\n", m.ChannelID, time.Now().Format(time.Stamp), m.Author.Username, m.Content)
}

Documentation

NOTICE : This library and the Discord API are unfinished. Because of that there may be major changes to library functions, constants, and structures.

  • GoDoc
  • Hand crafted documentation coming soon.

What Works

Current package provides a low level direct mapping to the majority of Discord REST and Websock API.

  • Login/Logout
  • Open/Close Websocket and listen for events.
  • Accept/Create/Delete Invites
  • Get User details (Name, ID, Settings, etc)
  • List/Create User Channels (Private Message Channels)
  • List/Create Guilds
  • List/Create Guild Channels
  • List Guild Members
  • Receive/Send Messages to Channels

What's Unfinished

  • Make changes as needed to pass GoLint, GoVet, GoCyclo, etc. (goreportcard.com)
  • Editing User Profile settings
  • Permissions related functions.
  • Functions for Maintenance Status
  • Voice Channel support.
  • Add a higher level interface with user friendly helper functions.

Credits

Special thanks goes to both the below projects who helped me get started with this project. If you're looking for alternative Golang interfaces to Discord please check both of these out.

Other Discord APIs