logginghandler/vendor/github.com/DisgoOrg/disgohook
Marvin Preuss d095180eb4
All checks were successful
continuous-integration/drone/push Build is passing
build: uses go modules for tool handling
2022-01-14 13:51:56 +01:00
..
api build: uses go modules for tool handling 2022-01-14 13:51:56 +01:00
internal build: uses go modules for tool handling 2022-01-14 13:51:56 +01:00
.gitignore build: uses go modules for tool handling 2022-01-14 13:51:56 +01:00
disgohook.go build: uses go modules for tool handling 2022-01-14 13:51:56 +01:00
go.mod build: uses go modules for tool handling 2022-01-14 13:51:56 +01:00
go.sum build: uses go modules for tool handling 2022-01-14 13:51:56 +01:00
LICENSE build: uses go modules for tool handling 2022-01-14 13:51:56 +01:00
README.md build: uses go modules for tool handling 2022-01-14 13:51:56 +01:00

disgohook

Go Reference Go Report Go Version License Disgo Version Disgo Discord

DisgoHook is a simple Discord Webhook library written in Go aimed to be easy to use


With v1 of disgo webhook support will be included there & this repo will be archived


Getting Started

Installing

go get github.com/DisgoOrg/disgohook

Usage

Import the package into your project.

import "github.com/DisgoOrg/disgohook"

Create a new Webhook by webhook_id/webhook_token. (This WebhookClient should be only created once as it holds important state)

As first param you can optionally pass your own *http.Client and as second parameter you can pass your own logger implementing this interface. This webhook then can be used to send, edit and delete messages

Send Message

webhook, err := disgohook.NewWebhookClientByToken(nil, nil, "webhook_id/webhook_token")

message, err := webhook.SendContent("hello world!")
message, err := webhook.SendEmbeds(api.NewEmbedBuilder().
	SetDescription("hello world!").
	Build(),
)
message, err := webhook.SendMessage(api.NewWebhookMessageCreateBuilder().
	SetContent("hello world!").
	Build(),
)

Edit Message

webhook, err := disgohook.NewWebhookClientByToken(nil, nil, "webhook_id/webhook_token")

message, err := webhook.EditContent("870741249114652722", "hello world!")
message, err := webhook.EditEmbeds("870741249114652722", 
	api.NewEmbedBuilder().
	SetDescription("hello world!").
	Build(),
)
message, err := webhook.EditMessage("870741249114652722", 
	api.NewWebhookMessageUpdateBuilder().
	SetContent("hello world!").
	Build(), 
)

Delete Message

webhook, err := disgohook.NewWebhookClientByToken(nil, nil, "webhook_id/webhook_token")

err := webhook.DeleteMessage("870741249114652722")

Documentation

Documentation is unfinished and can be found under

  • Go Reference
  • Discord Webhook Documentation

Examples

You can find examples under example and dislog

Troubleshooting

For help feel free to open an issues or reach out on Discord

Contributing

Contributions are welcomed but for bigger changes please first reach out via Discord or create an issue to discuss your intentions and ideas.

License

Distributed under the License . See LICENSE for more information.