DiscordKit e discordgo
Entenda o que o DiscordKit abstrai, o que continua sendo responsabilidade do discordgo e quando usar cada camada.
DiscordKit e discordgo resolvem partes diferentes do mesmo problema.
DiscordKit é construído sobre o discordgo e mantém a biblioteca base propositalmente visível.
As camadas
Seção intitulada “As camadas”┌───────────────────────────┐│ Sua aplicação │├───────────────────────────┤│ DiscordKit ││ Router · Context ││ Commands · Components ││ Forms · Middleware ││ Ciclo de respostas │├───────────────────────────┤│ discordgo ││ Gateway · REST ││ Sessions · tipos Discord │├───────────────────────────┤│ Discord API │└───────────────────────────┘discordgo fornece a camada de protocolo e modelo de dados.
DiscordKit fornece estrutura de aplicação em torno das interações.
O que continua sendo discordgo
Seção intitulada “O que continua sendo discordgo”DiscordKit não cria modelos alternativos para as entidades do Discord.
RequireUserOption retorna *discordgo.User, canais continuam sendo *discordgo.Channel, membros continuam sendo *discordgo.Member e sua aplicação continua controlando a *discordgo.Session original.
Isso é proposital.
Criar wrappers para todos esses tipos resultaria em outro modelo de objetos que precisaria ser constantemente convertido de volta para discordgo.
O que o DiscordKit adiciona
Seção intitulada “O que o DiscordKit adiciona”DiscordKit foca nos padrões acima do discordgo:
- roteamento;
- helpers de Context;
- builders tipados;
- ciclo de vida das interações;
- middleware;
- Components V2;
- formulários e parsing de modais.
Você sempre pode acessar discordgo diretamente
Seção intitulada “Você sempre pode acessar discordgo diretamente”DiscordKit não é uma abstração fechada.
Dentro de um handler, a sessão e a interação originais permanecem acessíveis.
Esse escape hatch é útil quando o Discord introduz um novo recurso, quando discordgo implementa algo antes do DiscordKit ou quando você precisa de controle em baixo nível.
Aplicações discordgo existentes
Seção intitulada “Aplicações discordgo existentes”Você não precisa reescrever uma aplicação existente.
session.AddHandler(existingMessageHandler)session.AddHandler(existingReadyHandler)session.AddHandler(router.Handle)A adoção incremental é suportada.
Regra prática
Seção intitulada “Regra prática”Use DiscordKit quando o problema estiver principalmente na estrutura de interações da aplicação.
Use discordgo diretamente quando o problema estiver principalmente no Discord em si.
Na prática, boas aplicações DiscordKit usam ambos.