Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Karitham/corde
A high level discord interactions wrapper, simple, idiomatic, testable and extensible. Based on outgoing webhooks, and designed from scratch for excellence
https://github.com/Karitham/corde
discord go golang hacktoberfest outgoing-webhooks testing webhook
Last synced: about 2 months ago
JSON representation
A high level discord interactions wrapper, simple, idiomatic, testable and extensible. Based on outgoing webhooks, and designed from scratch for excellence
- Host: GitHub
- URL: https://github.com/Karitham/corde
- Owner: Karitham
- License: mit
- Created: 2021-12-23T22:46:30.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2024-10-16T13:21:31.000Z (3 months ago)
- Last Synced: 2024-11-12T11:46:06.867Z (about 2 months ago)
- Topics: discord, go, golang, hacktoberfest, outgoing-webhooks, testing, webhook
- Language: Go
- Homepage: https://github.com/Karitham/corde
- Size: 120 KB
- Stars: 12
- Watchers: 2
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-discord-bot-tools - corde - A high level discord interactions wrapper, simple, idiomatic, testable and extensible. (Libraries / Go)
- awesome-discord-bot-tools - corde - A high level discord interactions wrapper, simple, idiomatic, testable and extensible. (Libraries / Go)
README
#
```txt
_
| |
___ ___ _ __ __| | ___
/ __| / _ \ | '__| / _` | / _ \
| (__ | (_) || | | (_| || __/
\___| \___/ |_| \__,_| \___|
```
[](https://goreportcard.com/report/github.com/Karitham/corde)
[](https://pkg.go.dev/github.com/Karitham/corde)
---
corde is a discord webhook callback API wrapper. It aims to have an high level API to simplify the user's life as much as possible.
It contains many functions to help write as clean and concise code as possible, such as `f` suffixed functions which act like `Sprintf`.
It also has builders of some kinds, such as embed and response builders, which make error handling and responding a breeze.
All those don't hinder the fact that you can use corde with as much control as you want.
Be aware that breaking changes will happen as of now, at least until v1.
## Install
```sh
go get github.com/Karitham/corde
```
### Usage
The easiest way to run the examples, or even to run your own is to use [ngrok](https://ngrok.com/) no login or domain required, and the product itself is great.
## Examples
The most basic one is [**bongo**](0_example/bongo/main.go)
Then comes [**todo**](0_example/todo/) that shows off subcommands routing and options
And then we have [**moderate-myself**](0_example/moderate-myself/main.go) which is able to show and delete currently available commands.
It demonstrates the usage of components such as buttons.
Finally, we have [**nft**](0_example/nft/main.go) which is a simple example using user commands & message commands.
Corde is also actively used to rewrite and develop another discord bot of mine called [**WaifuBot**](https://github.com/Karitham/WaifuBot/) (for now see the corde branch)
## Why
Having used most go discord libs available, I wanted something very lightweight yet high-level, that could just run on a lambda without state, caching or long start-up times.
Corde has a single *runtime* dependency as of yet, a radix tree for routing purposes (and it's epic, you should check it out).
The common libs out there didn't really fit that purpose, and neither did they implement the webhook callback API available.
Corde means *rope* in french, because discord's API inspires exactly that */s*