Ei kuvausta

Bruce Marriner 21272c5460 no formatting directive in Errorf call 9 vuotta sitten
examples 8b39278c3e Get rid of Listen. 9 vuotta sitten
.travis.yml 2d634bc612 Reduce number of tests by removing go tip tests. 9 vuotta sitten
LICENSE bc323b57a1 Initial commit 9 vuotta sitten
README.md 8fad18a2b0 Update README.md 9 vuotta sitten
discord.go 9a63e50e22 Bump dev to v0.11.0-alpha 9 vuotta sitten
discord_test.go ad1d0fac60 Tiny bit more test. 9 vuotta sitten
endpoints.go 654c78a419 Renamed GUILD_MEMBER_DEL endpoint to just GUILD_MEMBER 9 vuotta sitten
message.go 0f38b22ca1 Message state tracking. 9 vuotta sitten
restapi.go 21272c5460 no formatting directive in Errorf call 9 vuotta sitten
restapi_test.go ad1d0fac60 Tiny bit more test. 9 vuotta sitten
state.go ccb504b129 Fix missing lock 9 vuotta sitten
structs.go 9c5cd00d34 Spelling. 9 vuotta sitten
util.go a08dde4262 Support zlib compression. 9 vuotta sitten
voice.go 9c5cd00d34 Spelling. 9 vuotta sitten
wsapi.go fd32614a63 Make compression optional, clean up some comments and unused fields. 9 vuotta sitten

README.md

Discordgo

GoDoc Go report Build Status

Discordgo is a Go package that provides low level bindings to the Discord chat client API.

  • See dgVoice for experimental voice support.

Join #go_discordgo Discord chat channel for support.

Getting Started

Installing

Discordgo has been tested to compile on Debian 8 (Go 1.3.3), FreeBSD 10 (Go 1.5.1), and Windows 7 (Go 1.5.2).

This assumes you already have a working Go environment, if not please see this page first.

$ go get github.com/bwmarrin/discordgo

Usage

Import the package into your project.

import "github.com/bwmarrin/discordgo"

Construct a new Discord client which can be used to access the variety of Discord API functions and to set callback functions for Discord events.

discord, err := discordgo.New("username", "password")

See Documentation and Examples below for more detailed information.

Documentation

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

The Discordgo code is fairly well documented at this point and is currently the only documentation available. Both GoDoc and GoWalker (below) present that information in a nice format.

Examples

Below is a list of examples and other projects using Discordgo. Please submit an issue if you would like your project added or removed from this list

  • Basic - New A basic example using the easy New() helper function
  • Basic - API A basic example using the low level API functions.
  • Bruxism A chat bot for YouTube and Discord
  • GoGerard A modern bot for Discord
  • Digo A pluggable bot for your Discord server

Contributing

Contributions are very welcomed, however please follow the below guidelines.

  • First open an issue describing the bug or enhancement so it can be discussed.
  • Fork the develop branch and make your changes.
  • Try to match current naming conventions as closely as possible.
  • This package is intended to be a low level direct mapping of the Discord API so please avoid adding enhancements outside of that scope without first discussing it.
  • Create a Pull Request with your changes against the develop branch.

List of Discord APIs

See this chart for a feature comparison and list of other Discord API libraries.