Kombo

Kombo

Simple, yet powerful command handler for the DisGo.

Installation

Install this module as any other, using the go get CLI command:

go get github.com/HoneycombsTeam/Kombo

Usage example

package main

import (
	"github.com/HoneycombsTeam/Kombo"
	"github.com/disgoorg/disgo"
	"github.com/disgoorg/disgo/bot"
)

func pingCommandHandler(ctx *Kombo.Context) error {
	return ctx.Reply(
		Kombo.WithContent(":ping_pong: Pong!"),
	)
}

func main() {
	// create your client as normal
	client, err := disgo.New("something", bot.WithDefaultGateway())
	if err != nil {
		panic(err)
	}

	// creating a new instance of command handler
	ch := Kombo.NewCommandHandler(client)

	// registering a new command with name "ping" and description "Pongs you!"
	ch.RegisterCommand(
		Kombo.WithName("ping"),
		Kombo.WithDescription("Pongs you!"),
		Kombo.WithHandler(pingCommandHandler),
	)

	// create earlier registered commands
	if err = ch.InitCommands(); err != nil {
		panic(err)
	}

	// open gateway, do other stuff as normal...
}

Localization

Kombo allows you to automatically load and map localization for your project. Since v0.3.0, CommandHandler struct automatically creates instance of the LocalizationManager, to allow you to load the messages.

• JSON (see format below);

{
  "group": {
    "key1": "value1",
    "key2": "value2"
  }
}

...
err := LocalizationManager.RegisterLocale("en", "en.json")
if err != nil {
    panic(err)
}
...

// ...
message, err := LocalizationManager.GetMessage("en", "group.key1")
// message will be "value1".
// ...

Also, you can get message via the Context, or use Kombo.WithLocalizedContent. See documentation for these functions for more information.

License

Kombo is licensed under the MIT License, see LICENSE for more information.