1
0
Fork 0
mirror of https://github.com/diamondburned/arikawa.git synced 2024-12-13 08:55:12 +00:00
A Golang library and framework for the Discord API.
Go to file
2023-09-01 02:41:24 -07:00
.github *: Update cache-install for CI 2023-06-06 17:08:54 -07:00
0-examples examples/voice: Bump golang.org/x/crypto (#381) 2023-02-25 07:23:19 -08:00
api cmdroute: Add ev.Data into {Command,Autocomplete}Data 2023-08-31 23:42:35 -07:00
discord discord: add ReactionCountDetails struct 2023-09-01 02:41:24 -07:00
gateway gateway: Add IntentMessageContent 2023-03-15 15:16:42 -07:00
internal *: -short should skip integration tests 2023-06-07 18:02:48 -07:00
session session: Add OnInteractionError that logs by default 2023-01-01 18:01:08 +07:00
state *: Move state example to root package 2023-08-24 22:39:42 -07:00
utils httpdriver: Fix MockRequest.AddHeader crash 2022-12-09 15:39:33 -08:00
voice voice/udp: Reflect upstream changes from Discord 2023-03-20 14:05:21 -07:00
.build.yml gateway: Refactor for a better concurrent API 2021-12-14 13:49:34 -08:00
.editorconfig Minor fixes, undocumented things, and editorconfig 2020-01-19 13:54:16 -08:00
.gitlab-ci.yml CI: Update dismock 2021-09-23 22:28:02 -07:00
arikawa.go bot: Fix previous breaking change 2021-09-22 10:56:40 -07:00
arikawa_example_test.go *: Move state example to root package 2023-08-24 22:39:42 -07:00
go.mod *: Bump golang.org/x/crypto (#380) 2023-02-25 07:23:50 -08:00
go.sum *: Bump golang.org/x/crypto (#380) 2023-02-25 07:23:50 -08:00
LICENSE Changed LICENSE. 2020-04-13 19:09:24 -07:00
README.md README: Fix bare minimum example 2022-12-10 06:03:57 -08:00
shell.nix *: Add GitHub Actions (#371) 2023-01-31 00:31:46 -08:00

arikawa

 Pipeline Status  Report Card      Godoc Reference  Examples         Discord Gophers  Hime Arikawa

A Golang library for the Discord API.

Library Highlights

  • More modularity with components divided up into independent packages, such as the API client and the Websocket Gateway being fully independent.
  • Clear separation of models: API and Gateway models are never mixed together so to not be confusing.
  • Extend and intercept Gateway events, allowing for use cases such as reading deleted messages.
  • Pluggable Gateway cache allows for custom caching implementations such as Redis, automatically falling back to the API if needed.
  • Typed Snowflakes make it much harder to accidentally use the wrong ID (e.g. it is impossible to use a channel ID as a message ID).
  • Working user account support, with much of them in ningen. Please do not use this for self-botting, as that is against Discord's ToS.

Examples

Commands (Hybrid)

commands-hybrid is an alternative variant of commands, where the program permits being hosted either as a Gateway-based daemon or as a web server using the Interactions Webhook API.

Both examples demonstrate adding interaction commands into the bot as well as an example of routing those commands to be executed.

Simple

Simple bot example without any state. All it does is logging messages sent into the console. Run with BOT_TOKEN="TOKEN" go run .. This example only demonstrates the most simple needs; in most cases, bots should use the state or the bot router.

Note that Discord discourages use of bots that do not use the interactions API, meaning that this example should not be used for bots.

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 the state library. PreHandler calls all handlers that are registered (separately from the session), calling them before the state is updated.

Note that Discord discourages use of bots that do not use the interactions API, meaning that this example should not be used for bots.

Bare Minimum Bot Example

The least amount of code recommended to have a bot that responds to a /ping.

package main

import (
	"context"
	"log"
	"os"

	"github.com/diamondburned/arikawa/v3/api"
	"github.com/diamondburned/arikawa/v3/api/cmdroute"
	"github.com/diamondburned/arikawa/v3/gateway"
	"github.com/diamondburned/arikawa/v3/state"
	"github.com/diamondburned/arikawa/v3/utils/json/option"
)

var commands = []api.CreateCommandData{{Name: "ping", Description: "Ping!"}}

func main() {
	r := cmdroute.NewRouter()
	r.AddFunc("ping", func(ctx context.Context, data cmdroute.CommandData) *api.InteractionResponseData {
		return &api.InteractionResponseData{Content: option.NewNullableString("Pong!")}
	})

	s := state.New("Bot " + os.Getenv("BOT_TOKEN"))
	s.AddInteractionHandler(r)
	s.AddIntents(gateway.IntentGuilds)

	if err := cmdroute.OverwriteCommands(s, commands); err != nil {
		log.Fatalln("cannot update commands:", err)
	}

	if err := s.Connect(context.TODO()); err != nil {
		log.Println("cannot connect:", err)
	}
}

Testing

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

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