Tempest
Tempest is a Discord API wrapper for Applications, written in Golang. It aims to be fast, use minimal caching and be easier to use than other Discord API wrappers using http.
It was created as a better alternative to discord-interactions-go which is "low level" and outdated.
Summary
HTTP vs Gateway
TL;DR: you probably should be using libraries like DiscordGo unless you know why you're here.
There are two ways for bots to receive events from Discord. Most API wrappers such as DiscordGo use a WebSocket connection called a "gateway" to receive events, but Tempest receives interaction events over HTTP. Using http hooks lets you scale code more easily & reduce resource usage at cost of greatly reduced number of events you can use. You can easily create bots for roles, minigames, custom messages or admin utils but it'll be very difficult / impossible to create music or moderation bots.
Special features
- Easy to use & efficient handler for (/) commands & auto complete interactions
- Deep control with command middleware(s)
- Exposed REST
- Easy component & modal handling
- Simple way to sync (/) commands with API
- Request failure auto recovery (3 attempts by default)
- On failed attempts (probably due to internet connection), it'll try again set number of times before returning error
- No Discord data caching by default
Getting started
- Install with:
go get -u github.com/amatsagu/tempest - Check example with few simple commands.
Troubleshooting
For help feel free to open an issue on github. You can also inivite to contact me on discord.
Contributing
All contributions are welcomed. Few rules before making a pull request:
- Use conventional commits
- Add link to document for new structs
- Since
v1.1.0, all structs should have links to corresponding discord docs
- Since
