diamondburned
/
arikawa
mirror of https://github.com/diamondburned/arikawa.git
1
0
Fork 0
Code Issues Releases Activity
A Golang library and framework for the Discord API.
56 Commits 29 Branches 121 Tags 2.8 MiB
Go 100%
Go to file
diamondburned (Forefront) ce0bd07977 Changed undeleter to be more clear 2020-01-19 10:09:26 -08:00
_example Changed undeleter to be more clear 2020-01-19 10:09:26 -08:00
api Apparently I don't need reaction rate limits 2020-01-19 09:52:43 -08:00
bot Ported rfrouter over 2020-01-18 22:06:00 -08:00
discord Ported rfrouter over 2020-01-18 22:06:00 -08:00
gateway When in doubt, use brute force. 2020-01-18 22:46:45 -08:00
handler Expanded docs 2020-01-17 23:45:44 -08:00
internal Heartbeat can now resume, bot will fatal (die) if it can't reconnect 2020-01-18 22:14:46 -08:00
session Updated heartbeat behavior 2020-01-18 22:22:03 -08:00
state Ported rfrouter over 2020-01-18 22:06:00 -08:00
.gitlab-ci.yml Fixed CI 2020-01-15 20:49:21 -08:00
LICENSE Initial commit 2020-01-01 21:39:52 -08:00
README.md Updated README 2020-01-19 08:35:32 -08:00
go.mod WIP integration test 2020-01-14 23:34:18 -08:00
go.sum Added state storage, WIP state 2020-01-17 23:07:52 -08:00

README.md

arikawa

Godoc Reference Examples Discord Gophers Hime Arikawa

A Golang library for the Discord API.

Examples

Simple

Simple bot example without any state. All it does is logging messages sent into the console. Run with BOT_TOKEN="TOKEN" go run .

Undeleter

A slightly more complicated example. This bot uses a local state to cache everything, including messages. It detects when someone deletes a message, logging the content into the console.

This example demonstrates the PreHandler feature of this library. PreHandler calls all handlers that are registered (separately from session), calling them before the state is updated.

Comparison: Why not discordgo?

Discordgo is great. It's the first library that I used when I was learning Go. Though there are some things that I disagree on. Here are some ways that this library is different:

  • Better package structure: this library divides the Discord library up into smaller packages.
  • Cleaner API/Gateway structure separation: this library separates fields that would only appear in Gateway events, so to not cause confusion.
  • Automatic un-pagination: this library automatically un-paginates endpoints that would otherwise not return everything fully.
  • Flexible underlying abstractions: this library allows plugging in different JSON and Websocket implementations, as well as direct access to the HTTP client.
  • Flexible API abstractions: because packages are separated, the developer could choose to use a lower level package (such as gateway) or a higher level package (such as state).
  • Pre-handlers in the state: this allows the developers to access items from the state storage before they're removed.
  • Pluggable state storages: although only having a default state storage in the library, it is abstracted with an interface, making it possible to implement a custom remote or local state storage.
  • No code generation: just so the library is a lot easier to maintain.

You-should-knows

  • The bot will fatally exit if it fails to reconnect to the Gateway after a certain amount of times. This is changeable in gateway.WSFatal, or (*Gateway).FatalLog.

Testing

The package includes integration tests that require $BOT_TOKEN. To run these tests, do

export BOT_TOKEN="<BOT_TOKEN>"
go test -tags integration ./...