2020-01-02 05:39:52 +00:00
|
|
|
# arikawa
|
|
|
|
|
|
2020-01-16 05:10:20 +00:00
|
|
|
[](https://godoc.org/github.com/diamondburned/arikawa)
|
2020-01-17 22:29:13 +00:00
|
|
|
[](https://github.com/diamondburned/arikawa/tree/master/_example)
|
2020-01-16 05:10:20 +00:00
|
|
|
[](https://discord.gg/kF9mYBV )
|
|
|
|
|
[](https://hime-goto.fandom.com/wiki/Hime_Arikawa )
|
2020-01-16 05:04:08 +00:00
|
|
|
|
2020-01-02 05:39:52 +00:00
|
|
|
A Golang library for the Discord API.
|
2020-01-16 03:28:21 +00:00
|
|
|
|
2020-01-18 21:51:57 +00:00
|
|
|
## Examples
|
|
|
|
|
|
|
|
|
|
### [Simple](https://github.com/diamondburned/arikawa/tree/master/_example/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](https://github.com/diamondburned/arikawa/tree/master/_example/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.
|
|
|
|
|
However, it's not good enough. Here are some things that this library aims to
|
|
|
|
|
solve:
|
|
|
|
|
|
|
|
|
|
- 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.
|
|
|
|
|
|
2020-01-19 06:17:29 +00:00
|
|
|
## 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`.
|
|
|
|
|
|
2020-01-16 03:28:21 +00:00
|
|
|
## Testing
|
|
|
|
|
|
|
|
|
|
The package includes integration tests that require `$BOT_TOKEN`. To run these
|
|
|
|
|
tests, do
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
export BOT_TOKEN="<BOT_TOKEN>"
|
|
|
|
|
go test -tags integration ./...
|
|
|
|
|
```
|
